SynqDocs
Management APIBrands

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.

POST/v1/orgs/{org}/brands/{brand}/transfers

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.

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}$
brand*string

The brand's id

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