Skip to main content
PATCH
/
v2
/
billing
/
subscription
Update Subscription
curl --request PATCH \
  --url https://api.tusky.io/v2/billing/subscription \
  --header 'Content-Type: application/json' \
  --data '
{
  "plan": "<string>"
}
'
Change or cancel the subscription plan. Upgrades take effect immediately; downgrades apply at the end of the current billing period.

​
Request Body

​
plan
string
required
Target plan: payg, starter, growth, scale.

​
Response

Returns the updated subscription object.

​
Example

curl -X PATCH https://api.tusky.io/v2/billing/subscription \
  -H "Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"plan": "scale"}'

​
Response

{
  "plan": "scale",
  "status": "active",
  "limits": {
    "transactionsPerMonth": 100000,
    "bandwidthPerMonth": 1099511627776
  },
  "currentPeriod": {
    "start": "2026-03-01T00:00:00Z",
    "end": "2026-03-31T23:59:59Z"
  },
  "renewsAt": "2026-04-01T00:00:00Z"
}
Set plan to payg to cancel the subscription and switch to pay-as-you-go. This takes effect at the end of the current billing period.