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.
/v1/orgs/{org}/brand-transfers/{transfer}/declineThe 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 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
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.