billing

previewSubscriptionChange

Preview a subscription tier or seat change. Returns confirmation_token (10-min TTL) plus proration and next-invoice math. Cross-tier upgrades from Free return requires_checkout=true; the apply step creates a hosted Stripe Checkout session. A move to Enterprise is refused (it is arranged with sales); an Enterprise organisation can still preview a seat change with target_tier=enterprise and target_seats. Rate limit 30/h. Use when the user asks to upgrade their plan (free→pro), downgrade, add seats, increase seats, or change subscription tier — ALWAYS call this preview first, then applySubscriptionChange with the returned token after the user confirms.

post/tools/previewSubscriptionChange

Request

  • Base URL: https://api.stablebaseline.io/functions/v1/cloud-serve/api/v1
  • URL: https://api.stablebaseline.io/functions/v1/cloud-serve/api/v1/tools/previewSubscriptionChange
  • Auth: HTTP bearer

Request body

organisation_idstring required
target_tier'free' | 'pro' | 'enterprise' required
target_seatsinteger

Response

Tool result (shape varies per tool — refer to the tool's docs for the exact return value).

object required

Changes

No recorded changes to this operation across all 1 revision of this API.