SaaS Billing2026.8.0

Confirm a Signature plan change

Revalidates permissions, signed review and current Stripe state. Upgrades apply only after successful prorated payment. Downgrades start at renewal. Changes only the persisted Signature subscription.

POST/api/v1/billing/saas/{productKey}/plan-change

The source export uses a local development server. Examples use the configured Dashio API origin.

The export references authentication schemes without supplying their definitions.

Authentication

bearerAuth

Understand authentication

Path parameters

productKeystringRequired: No parameter description supplied.

Query parameters

None declared in this export.

Header parameters

None declared in this export.

Request body

application/json · Required

spaceIdstring (uuid)Required: No field description supplied.
tokenstringRequired: Signed token from the preview endpoint, up to 4096 characters.

Request & response examples

Copy an example in your preferred language.

request.sh

curl --request POST 'https://dashio.net/api/v1/billing/saas/{productKey}/plan-change' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "spaceId": "<spaceId>",
  "token": "<token>"
}'

Replace URL parameters, credentials, and schema placeholders before running. No request is sent by this page.

Schema-generated example; not a captured response.

{
  "outcome": "applied",
  "paymentUrl": "<paymentUrl>"
}

Examples use the configured API origin. Replace credentials, URL parameters, and schema placeholders before running.

Responses

200

Plan change result.

outcomestringOptional: Allowed values: "applied", "payment_required", "scheduled".
paymentUrlstring | nullOptional: No field description supplied.