SynqDocs
Management APIBrand transfers

List an org's brand moves

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.

GET/v1/orgs/{org}/brand-transfers

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.

Authorization

bearer
AuthorizationBearer <token>

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

org*string

The org's id

Match^org_[0-9a-hjkmnp-tv-z]{26}$

Query Parameters

limit?integer

At most this many items, 200 at the most.

Range1 <= value <= 200
Default50
cursor?string

The previous page's next_cursor, for the page after it.

Response Body

application/json

application/problem+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" \  -H "Authorization: Bearer $SYNQ_API_KEY"
{  "data": [    {      "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      }    }  ],  "next_cursor": "string"}

Get a brand move GET

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.

Accept a brand move POST

The target org's owner takes another org's brand, as the request's preview showed it: the brand moves at once, with its users (signed in, the same `sub`), apps (the same client ids and secrets), issuer, domains, communities, bots and token gates. You confirm that your org becomes responsible for the brand's users' data (`confirm_data_responsibility`), and name the `preview_hash` you read: if what moves or changes is no longer what it showed, nothing moves (`transfer_preview_changed`, 409). From the move, the old org's API keys, endpoints and members stop reaching the brand, and yours with All brands reach it; it arrives as one of your brands, your default only if you have none. When it was its org's last and that org's owner chose `close_from_org`, that org closes with the move, as deleting it does. Its custom domains enter a 14-day grace if your plan lacks them. Accepting it again answers the same. 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 `plan_quota_exceeded` (403) when your plan has no room for another brand, `brand_transfer_blocked` (409, `reason` saying what, `detail` the fix) while something blocks it, and `brand_transfer_ended` (409) for a request that ended. Recorded as `brand.transfer_accepted` in both orgs' logs (yours is the "moved from" entry, naming `from_org` and `transfer`), each also the event of that org's All brands endpoints.