SynqDocs
Management APIBrand transfers

Decline a brand move

The target org's owner declines a request to take another org's brand: it ends, and nothing moves. Declining 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. A request that ended otherwise is `brand_transfer_ended` (409). Recorded as `brand.transfer_declined` in both orgs' logs, each also their webhooks' event.

POST/v1/orgs/{org}/brand-transfers/{transfer}/decline

The target org's owner declines a request to take another org's brand: it ends, and nothing moves. Declining 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. A request that ended otherwise is brand_transfer_ended (409). Recorded as brand.transfer_declined in both orgs' logs, each also their webhooks' event.

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

application/problem+json

curl -X POST "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/brand-transfers/btr_01h455vb4pex5vsknk084sn02q/decline" \  -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  }}

Cancel a brand move POST

An owner of either org cancels a request before it is decided: it ends, and nothing moves. Cancelling it again from the same side 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. A request that ended otherwise is `brand_transfer_ended` (409). Recorded as `brand.transfer_cancelled` in both orgs' logs (`cancelled_by`: `from` or `to`; Synq's staff can cancel one too, as `staff` with a reason), each also their webhooks' event.

Email a moved brand's users POST

Once a brand moved to this org, its owner has Synq tell the brand's users: who runs it now and is responsible for their data, that nothing changes for them, and the brand's privacy policy, from the brand's own sender, to each user with a verified address who may use their account and whom Synq may email. Once: asking again answers the same and sends nothing more. It goes out in the background, in batches within the notice's own mail budget, so the brand's sign-in codes never wait on it; the request's `notice` says when the last went and how many it reached. It can be asked for while the request is kept, 30 days after the move. 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. A request that wasn't accepted, or whose brand isn't this org's any more, is `conflict` (409). Recorded as `brand.transfer_notice_sent` in this org's log once the last goes, also its webhooks' event.