Ask to move a brand to another org
Asks the target org's owner to take the brand, with its users, apps, issuer, domains and communities, all unchanged. You confirm that the target becomes responsible for the brand's users' data (`confirm_data_responsibility`). A default brand names the org's new default (`new_default_brand`); the org's last brand goes only with `close_from_org`, which closes the org with the move, as deleting it does. The request waits 7 days, one at a time per brand. Needs `org.brands.transfer`. Only an owner of the org, as a person, signed in within the last 5 minutes: an API key never asks, decides or cancels a move. A person needs a sign-in at Synq from the last 5 minutes whose time Synq proved (send them to sign in with `max_age=300`), else 403 `fresh_sign_in_required`; an API key never does. Refused with `brand_transfer_blocked` (409, `reason` saying what, `detail` the fix) or `transfer_target_unavailable` (422). Recorded as `brand.transfer_requested` in both orgs' logs, each also their webhooks' event. A request waits 7 days for the target's owner, who accepts it (the brand moves) or declines it; either side's owner may cancel it until then. When you own the target org too, `move_now: true` with the `preview_hash` of `GET …/transfer-preview?to_org=…` moves the brand at once instead: the request is made and accepted as you, in one step and one fresh sign-in, recorded as `brand.transfer_requested` and `brand.transfer_accepted` in both orgs' logs, and answered `accepted`. Accepting's refusals apply to it (`transfer_preview_changed` and the rest, as `POST …/accept` says), and any refusal leaves no request waiting. Anyone but the owner of both orgs gets 403 `forbidden` for it.
/v1/orgs/{org}/brands/{brand}/transfersAsks the target org's owner to take the brand, with its users, apps, issuer, domains and communities, all unchanged. You confirm that the target becomes responsible for the brand's users' data (confirm_data_responsibility). A default brand names the org's new default (new_default_brand); the org's last brand goes only with close_from_org, which closes the org with the move, as deleting it does. The request waits 7 days, one at a time per brand. Needs org.brands.transfer. Only an owner of the org, as a person, signed in within the last 5 minutes: an API key never asks, decides or cancels a move. A person needs a sign-in at Synq from the last 5 minutes whose time Synq proved (send them to sign in with max_age=300), else 403 fresh_sign_in_required; an API key never does. Refused with brand_transfer_blocked (409, reason saying what, detail the fix) or transfer_target_unavailable (422). Recorded as brand.transfer_requested in both orgs' logs, each also their webhooks' event. A request waits 7 days for the target's owner, who accepts it (the brand moves) or declines it; either side's owner may cancel it until then. When you own the target org too, move_now: true with the preview_hash of GET …/transfer-preview?to_org=… moves the brand at once instead: the request is made and accepted as you, in one step and one fresh sign-in, recorded as brand.transfer_requested and brand.transfer_accepted in both orgs' logs, and answered accepted. Accepting's refusals apply to it (transfer_preview_changed and the rest, as POST …/accept says), and any refusal leaves no request waiting. Anyone but the owner of both orgs gets 403 forbidden for it.
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
Path Parameters
The org's id
^org_[0-9a-hjkmnp-tv-z]{26}$The brand's id
^brd_[0-9a-hjkmnp-tv-z]{26}$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
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/brands/brd_01h455vb4pex5vsknk084sn02q/transfers" \ -H "Authorization: Bearer $SYNQ_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "to_org": "string", "confirm_data_responsibility": true, "new_default_brand": "string", "close_from_org": true, "move_now": true, "preview_hash": "9f2c6a8e1b7d4c3a5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5" }'{ "id": "string", "brand": { "id": "string", "name": "Acme" }, "from_org": { "id": "string", "name": "Acme" }, "to_org": { "id": "string", "name": "Acme" }, "direction": "outgoing", "status": "pending", "requested_by": "string", "requested_at": "2026-10-21T12:00:00.000Z", "expires_at": "2026-10-21T12:00:00.000Z", "decided_at": "2026-10-21T12:00:00.000Z", "cancelled_by": "from", "new_default_brand_id": "string", "close_from_org": true, "data_responsibility_statement": "string", "preview": { "users": 0, "monthly_active_users": 0, "apps": [ { "client_id": "app_01h455vb4pex5vsknk084sn02q", "name": "Acme" } ], "apps_total": 0, "issuer": "string", "custom_domains": [ "acme.example" ], "sending_domain": "acme.example", "sending_domains": [ "mail.acme.com" ], "discord_servers": [ { "id": "string", "name": "Acme" } ], "telegram_groups": [ { "id": "string", "title": "string" } ], "own_bots": [ { "id": "string", "platform": "discord", "name": "Acme" } ], "sign_in_providers": [ { "provider": "google", "app_now": "brand", "app_after": "brand" } ], "stays_as_set": { "terms_of_service_url": "https://app.acme.example", "privacy_policy_url": "https://app.acme.example" }, "blockers": [ { "reason": "transfer_pending", "detail": "string" } ], "roles_ending": { "members": 0, "invitations": 0 }, "plan_changes": [ { "feature": "string", "effect": "string" } ], "apps_over_quota": { "apps": 0, "limit": 0 } }, "preview_hash": "string", "reason": "string", "from_org_empty": true, "notice": { "requested_at": "2026-10-21T12:00:00.000Z", "sent_at": "2026-10-21T12:00:00.000Z", "recipients": 0 }}Preview a brand's theme POST
The brand's pages' look with these settings on top of its theme, saving nothing, as values: the look @synq/sign-in-ui and @synq/member-ui draw the pages in. It shows whatever the plan allows or not, and `needs` names what saving it would need. `…/sign-in-page/preview` draws the sign-in page in a draft theme. Needs `org.brands.view`.
Make a brand POST
A new user pool with its own issuer. The org's own apps at sign-in providers sign it in too, so each must register its callback: `warnings` says so (`org_provider_apps_need_redirect_uri`), naming each. Needs `org.brands.edit`, and room under the org's plan (403 `plan_quota_exceeded`, naming the plan that has room in `required_plan`). A brand deleted in the last 30 days still takes its place: its issuer slug is held until it's purged. Recorded as `brand.created`.