POST /api/subscription/change
Requires an authenticated account session and browser CSRF header. Omitted interval defaults to month. Changes take effect at renewal, without proration.
Authentication
Use an authenticated RedRouter account session cookie. Browser mutations also require the account CSRF token and matching Origin header; API keys do not authenticate these operations.
Request body
application/json · required
{
"$ref": "#/components/schemas/PlanSelection"
}
Request examples
curl -X POST 'https://redrouter.org/api/subscription/change' \
-H 'Content-Type: application/json' \
-d '{
"interval": "year",
"plan": "growth"
}' --cookie "$REDROUTER_COOKIE_JAR" -H "X-CSRF-Token: $REDROUTER_CSRF_TOKEN" -H 'Origin: https://redrouter.org'
Responses
200 · Successful subscription operation
application/json
{
"additionalProperties": false,
"properties": {
"purchased_balance_usd": {
"type": "string"
},
"subscription": {
"anyOf": [
{
"$ref": "#/components/schemas/Subscription"
},
{
"type": "null"
}
]
}
},
"required": [
"subscription",
"purchased_balance_usd"
],
"type": "object"
}