Sign in
latestOpenAPI 3.0.1AGPL-3.0raw.githubusercontent.com2026-08-21258508903.8 KB

d567e8585c2e

Subscriptions

Add addon to subscription

Deprecated: use POST /subscriptions/{id}/modify/execute with type "addon" and action "add", which also supports previewing the proration charge first. Use when adding an optional product or add-on to an existing subscription (e.g. extra storage or support tier).

post/subscriptions/addon

Request body

addon_idstring required
cadence'onetime' | 'recurring'
line_item_commitmentsobject

LineItemCommitments allows setting commitment configuration per addon line item (keyed by price_id)

metadataobject
proration_behavior'create_prorations' | 'none'
start_datestring date-time
subscription_idstring required

Response

OK

addon_idstring
addon_status'active' | 'cancelled' | 'pending'
cancellation_reasonstring
cancelled_atstring date-time
created_atstring date-time
created_bystring
end_datestring date-time
entity_idstring
entity_type'subscription' | 'plan' | 'addon'
environment_idstring
idstring
metadataobject
start_datestring date-time
status'published' | 'deleted' | 'archived'
tenant_idstring
updated_atstring date-time
updated_bystring