Skip to main content
POST
/
v1
/
billing
/
upgrade
Upgrade Plan
curl --request POST \
  --url https://api.example.com/v1/billing/upgrade
For existing subscribers, returns a billing portal URL for plan change (with automatic proration). For users without an active subscription, creates a new subscription checkout.

​
Request Body

ParameterTypeRequiredDescription
planstringYesstarter or pro

​
Response (existing subscriber)

{
  "portal_url": "https://billing.example.com/p/session/...",
  "hint": "Open the portal URL to manage your subscription and change plans."
}

​
Response (no subscription)

Same as POST /v1/billing/subscribe.