Skip to main content
PUT
Update a Stripe subscription directly (upgrade/downgrade)
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

PUT /billing/stripe/subscription Changes planLevel and/or billingCycle on the existing active Stripe subscription with always_invoice proration so outstanding metered usage is billed immediately, then syncs the local record. Authorization:
  • Required role: owner only

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Body

application/json

At least one of planLevel or billingCycle is required.

planLevel
enum<string>
Available options:
FREE,
STARTER,
PLUS,
PREMIUM
billingCycle
enum<string>
Available options:
monthly,
quarterly,
annually

Response

Subscription updated

status
string
Example:

"success"

message
string
data
object