SynqDocs
Management APIBrand transfers

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.

GET/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
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}$
transfer*string

The request's id

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