Get a brand move
A request to move a brand, as the org in the path sees it. While it waits, `preview` says what moves and what changes: on the target's side with its plan's gaps (`plan_changes`), its room and `preview_hash`, which accepting names. Needs `org.brands.view`. 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.
/v1/orgs/{org}/brand-transfers/{transfer}A request to move a brand, as the org in the path sees it. While it waits, preview says what moves and what changes: on the target's side with its plan's gaps (plan_changes), its room and preview_hash, which accepting names. Needs org.brands.view. 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.
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 request's id
^btr_[0-9a-hjkmnp-tv-z]{26}$Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/brand-transfers/btr_01h455vb4pex5vsknk084sn02q" \ -H "Authorization: Bearer $SYNQ_API_KEY"{ "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 }}Make an app POST
A web, SPA, native or machine app of the brand. A web or machine app's secret is in the response, this once; only its hash is kept. Needs `org.apps.edit`, and room under the org's plan (403 `plan_quota_exceeded`, naming the apps that hold its places in `held_by` and the plan that has room in `required_plan`). Apps that registered themselves don't count, and neither does the org's development app: its first app whose redirect URIs are all on localhost, 127.0.0.1 or [::1], beside the plan's apps on every plan (Starter allows 1 app, plus a development app). Recorded as `app.created`.
List an org's brand moves GET
The requests to move one of its brands to another org (`outgoing`) and to take another org's brand (`incoming`), oldest first, each with its preview while it waits. Ended ones are kept 30 days. Needs `org.brands.view`. 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.