Email a moved brand's users
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.
/v1/orgs/{org}/brand-transfers/{transfer}/noticeOnce 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.
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
application/problem+json
curl -X POST "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/brand-transfers/btr_01h455vb4pex5vsknk084sn02q/notice" \ -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 }}Decline a brand move POST
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.
Remove a brand's custom domain DELETE
It stops answering at once, and Synq takes it out of Cloudflare: every app that signs in with its issuer stops working, while the brand's own issuer goes on. Once it has served, the hostname is kept from other brands for 30 days. Needs `org.brands.edit`, on any plan. Recorded as `brand.custom_domain_removed`.