SynqDocs
Management APIOrg allowance

Read whether the caller may make another org

Whether `POST /v1/orgs` would make the caller an org now, and if not, why: the cap on the free orgs one person owns, counting free orgs deleted in the last 30 days, where orgs on a paid plan don't count and an org on a trial does (`org_quota_exceeded`, with when a slot frees up), or Synq's sign-up policy (`org_creation_closed`, `email_unverified`). For a page that offers a new org only when making one would work. Making one still checks everything again. Only a person has one: an API key acts in its own org. Needs no permission.

GET/v1/org-allowance

Whether POST /v1/orgs would make the caller an org now, and if not, why: the cap on the free orgs one person owns, counting free orgs deleted in the last 30 days, where orgs on a paid plan don't count and an org on a trial does (org_quota_exceeded, with when a slot frees up), or Synq's sign-up policy (org_creation_closed, email_unverified). For a page that offers a new org only when making one would work. Making one still checks everything again. Only a person has one: an API key acts in its own org. Needs no permission.

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

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://api.synq.build/v1/org-allowance" \  -H "Authorization: Bearer $SYNQ_API_KEY"
{  "can_create": false,  "refusal": "org_quota_exceeded",  "limit": 3,  "owned": 3,  "next_slot_at": "2026-11-29T12:00:00.000Z",  "counted_orgs": [    {      "id": "org_01h455vb4pex5vsknk084sn02q",      "name": "Acme",      "slug": "acme",      "plan": "starter",      "on_trial": false,      "yours": true,      "deleted_at": null,      "counts_until": null    }  ]}