POST
Upgrade the plan

Authorizations

Authorization
string
header
required

Developer session token from POST /v1/auth/login or POST /v1/auth/register. Valid 7 days.

Authenticates the developer control plane. It also reaches the server and build endpoints, which a dashboard has to drive and which no session can otherwise call: an API key's value is returned once, at mint, so nothing can read back a key for an existing project. On those endpoints a session names its project with project_id, or is resolved from the resource it addresses, and is always checked against the account that owns it.

It reaches no player-facing game endpoint.

Body

application/json
plan
enum<string>
required

Billing plan for the account. Plan gates capability, not just price.

Available options:
free,
payg,
pro
Example:

"free"

Response

The new plan, effective immediately.

The account's current plan, what it allows, and where the billing cycle sits. Plan changes go through POST /v1/billing/upgrade and POST /v1/billing/downgrade.

plan
enum<string>
required

Billing plan for the account. Plan gates capability, not just price.

Available options:
free,
payg,
pro
Example:

"free"

limits
object
required

The capability ceiling applied by the account's current plan.

current_period_start
string<date-time>
required
current_period_end
string<date-time>
required
pending_plan
enum<string> | null

Set when a downgrade is scheduled. The account keeps its current plan's capability until current_period_end, then moves to this plan automatically.

Available options:
free,
payg,
pro
Example:

"free"

payment_method
object | null

The card on file, as reported by Stripe. Simpl never stores or sees a card number.