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.
/v1/org-allowanceWhether 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 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 } ]}Hide a notice for yourself POST
Hides `notice` (`setup_checklist`, the brand overview’s "Finish setting up" checklist, `website_logo_prompt`, its "Use your website’s logo" prompt, or `nextjs_app`, the "Make your Next.js app" card after onboarding) on the brand's pages in Synq's dashboard for the calling person, on every device. Only for them: the org's other members still see it. Hiding it skips nothing it lists, and nothing brings it back; hiding it again keeps the first time. A person's credential only. Needs `org.brands.view`.
Delete an org DELETE
At once, nothing serves it: not its routes, its API keys or its brands' issuers. A paid plan ends with it: its Stripe subscription is canceled at once, with nothing prorated and no final invoice, so the rest of the period isn't refunded and nothing more is charged. It is purged 30 days later, and its issuer slugs are never used again. Needs `org.delete`, which only the owner has. Recorded as `org.deleted`.