Sign in

v12

latestOpenAPI 3.0.1AGPL-3.0raw.githubusercontent.com2026-07-0971442569.2 KB
Subscriptions

Add addon to subscription

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