SaaS Billing2026.8.0

Review a Signature upgrade or downgrade

Owner/admin only. Returns a signed ten-minute review, the prorated amount for immediate upgrades, or the renewal date for downgrades. Does not modify the subscription.

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

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.
planIdstringRequired: No field description supplied.

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/preview' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "spaceId": "<spaceId>",
  "planId": "<planId>"
}'

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

Schema-generated example; not a captured response.

{
  "token": "<token>",
  "plan": "<plan>",
  "direction": "upgrade",
  "effectiveAt": "<effectiveAt>",
  "expiresAt": "<expiresAt>",
  "amountDue": 0,
  "currency": "<currency>"
}

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

Responses

200

Signed plan review.

tokenstringOptional: No field description supplied.
planobjectOptional: No field description supplied.
directionstringOptional: Allowed values: "upgrade", "downgrade".
effectiveAtstring (date-time)Optional: No field description supplied.
expiresAtstring (date-time)Optional: No field description supplied.
amountDueintegerOptional: No field description supplied.
currencystringOptional: No field description supplied.