Remove the org's own Discord app or Telegram bot
Disconnects every server or group it serves (the list's `serves` says how many), from now on: whoever holds a role or is in a group keeps it, and nobody is checked there again. The bot leaves each of them, best effort. Connecting them again with Synq's bot starts afresh. Never wants the plan, so an org that moved down can still remove it. Needs `org.integrations.edit`. Recorded as `own_bot.removed`.
/v1/orgs/{org}/own-bots/{platform}Disconnects every server or group it serves (the list's serves says how many), from now on: whoever holds a role or is in a group keeps it, and nobody is checked there again. The bot leaves each of them, best effort. Connecting them again with Synq's bot starts afresh. Never wants the plan, so an org that moved down can still remove it. Needs org.integrations.edit. Recorded as own_bot.removed.
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}$discord or telegram
Value in
- "discord"
- "telegram"
Response Body
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X DELETE "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/own-bots/discord" \ -H "Authorization: Bearer $SYNQ_API_KEY"Make an org POST
Makes an org with its default brand, or with none (`first_brand: false`) for a brand moving in from another org, and makes the caller its owner. Only a person can: an API key acts in its own org. It wants a verified, non-disposable email address (`email_unverified` or `org_creation_closed`). Where Synq isn't open for sign-up, only the people it lets in can (`org_creation_closed`), and one person owns a limited number of free orgs (`org_quota_exceeded`; orgs on a paid plan don't count, an org on a trial does). Recorded as `org.created`.
Read the org's own Discord app and Telegram bot GET
What the org set: each bot's ids and names, how many servers or groups it serves, and what to set in Discord's portal. Never its token or client secret. Needs `org.integrations.view`.