SynqDocs
Management APIUpgrade requests

Ask the owners to upgrade

For a member who can't change the org's plan: asks its owners and admins to move it to a plan, by email and on their billing page, until the org reaches the plan or one of them dismisses it. Asking again for the same plan while a request is open answers that one and emails nobody. A person's credential only. Needs `org.read`.

POST/v1/orgs/{org}/billing/upgrade-requests

For a member who can't change the org's plan: asks its owners and admins to move it to a plan, by email and on their billing page, until the org reaches the plan or one of them dismisses it. Asking again for the same plan while a request is open answers that one and emails nobody. A person's credential only. Needs org.read.

Authorization

bearer
AuthorizationBearer <token>

An org API key (sk_live_…, sk_test_…), or an access token from the Synq issuer (the synq brand, on the accounts host) for this API.

In: header

Path Parameters

org*string

The org's id

Match^org_[0-9a-hjkmnp-tv-z]{26}$

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/billing/upgrade-requests" \  -H "Authorization: Bearer $SYNQ_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "plan": "pro",    "interval": "month",    "note": "string"  }'
{  "id": "upr_01h455vb4pex5vsknk084sn02q",  "plan": "pro",  "interval": "month",  "note": "string",  "requested_by": {    "email": "ana@acme.example",    "name": "Acme"  },  "created": "2026-10-21T12:00:00.000Z"}