SynqDocs
Management APIClaimable orgs

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`.

POST/v1/claimable-orgs

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.

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  }}