Make a claimable org
What `npx synqauth init` calls: an org with its default brand and one development app, made with no account and no credential, so a developer can sign someone in to their app on their laptop before signing up. Nobody is its member, so nothing can change it but claiming it. Until someone claims it with `claim.url` (or `POST /v1/claimable-orgs/claim`), its app takes https redirect URIs on a loopback address only, its brand takes 25 users and little email, and its sign-in pages say it is a development sign-in nobody has claimed. Unclaimed after 7 days, it is deleted. Only where Synq makes claimable orgs and is open for sign-up (`org_creation_closed` otherwise), and a few a day from one address. Recorded as `org.created` (`metadata.claimable`) and `app.created`, by `anonymous`.
/v1/claimable-orgsWhat npx synqauth init calls: an org with its default brand and one development app, made with no account and no credential, so a developer can sign someone in to their app on their laptop before signing up. Nobody is its member, so nothing can change it but claiming it.
Until someone claims it with claim.url (or POST /v1/claimable-orgs/claim), its app takes https redirect URIs on a loopback address only, its brand takes 25 users and little email, and its sign-in pages say it is a development sign-in nobody has claimed. Unclaimed after 7 days, it is deleted.
Only where Synq makes claimable orgs and is open for sign-up (org_creation_closed otherwise), and a few a day from one address. Recorded as org.created (metadata.claimable) and app.created, by anonymous.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://api.synq.build/v1/claimable-orgs" \ -H "Authorization: Bearer $SYNQ_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "acme-web", "app_type": "web", "redirect_uris": [ "https://localhost:3000/api/auth/callback" ], "post_logout_redirect_uris": [] }'{ "org": { "id": "org_01h455vb4pex5vsknk084sn02q", "slug": "dev-k3v9q2m7xa", "name": "acme-web" }, "issuer": "https://dev-k3v9q2m7xa.auth.synq.build", "app": { "client_id": "app_01h455vb4pex5vsknk084sn02q", "client_secret": "string", "app_type": "web", "redirect_uris": [ "https://app.acme.example" ] }, "claim": { "token": "synq_claim_…", "url": "https://app.acme.example", "expires_at": "2026-10-21T12:00:00.000Z" }, "limits": { "users": 25 }}Read what a claim token would claim POST
The org a claim token names, while it can be claimed: for the page that asks before claiming. A person only; the token is in the body, never the URL. `into_orgs` lists the orgs the caller may claim it into instead, as a new brand (`POST /v1/claimable-orgs/claim-into`), each with its room for one more.
Disconnect an app from your Synq account DELETE
Withdraws what the calling person allowed the app: its grants for them end with every refresh token they gave, so its next refresh is refused and it asks them to sign in and allow it again. Access tokens it already holds work until they expire, 10 minutes at most for Synq's MCP server. What it already changed stays changed. A person's credential only. Recorded as `user.consent_revoked` (`metadata.by`: `connected_apps`).