SynqDocs
Management APIOwn bots

Read the org's own Discord app and Telegram bot

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`.

GET/v1/orgs/{org}/own-bots

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.

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}$

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/own-bots" \  -H "Authorization: Bearer $SYNQ_API_KEY"
{  "discord": {    "id": "bot_01h455vb4pex5vsknk084sn02q",    "platform": "discord",    "external_id": "1203847562019384756",    "name": "Mollyverse Bot",    "username": "MollyverseBot",    "serves": 0,    "setup": {      "interactions_endpoint_url": "https://app.acme.example",      "redirect_uri": "https://app.acme.example",      "webhook_url": "https://app.acme.example"    },    "created_at": "2026-10-21T12:00:00.000Z",    "updated_at": "2026-10-21T12:00:00.000Z"  },  "telegram": {    "id": "bot_01h455vb4pex5vsknk084sn02q",    "platform": "discord",    "external_id": "1203847562019384756",    "name": "Mollyverse Bot",    "username": "MollyverseBot",    "serves": 0,    "setup": {      "interactions_endpoint_url": "https://app.acme.example",      "redirect_uri": "https://app.acme.example",      "webhook_url": "https://app.acme.example"    },    "created_at": "2026-10-21T12:00:00.000Z",    "updated_at": "2026-10-21T12:00:00.000Z"  }}