List the Discord servers an org connected
Every server the org connected for its token gates' roles, with how many roles its gates give there and how many people Synq manages, and the bot that serves the org on Discord. Needs `org.integrations.view`.
/v1/orgs/{org}/discord-serversEvery server the org connected for its token gates' roles, with how many roles its gates give there and how many people Synq manages, and the bot that serves the org on Discord. Needs org.integrations.view.
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}$Query Parameters
At most this many items, 200 at the most.
1 <= value <= 20050The previous page's next_cursor, for the page after it.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/discord-servers" \ -H "Authorization: Bearer $SYNQ_API_KEY"{ "data": [ { "id": "dsv_01h455vb4pex5vsknk084sn02q", "brand_id": "brd_01h455vb4pex5vsknk084sn02q", "guild_id": "1093847562019384756", "name": "Mollyverse", "icon_url": "https://app.acme.example", "status": "connected", "verify_channel_id": "string", "verified_channel_id": "string", "own_bot": true, "invite_url": "https://discord.gg/mollyverse", "listed": true, "listed_by": "brand", "counts": { "roles": 0, "gated": true, "managed": 0 }, "connected_at": "2026-10-21T12:00:00.000Z" } ], "next_cursor": "string", "bot": { "id": "1093847562019384756", "name": "Synq", "username": "SynqBot", "own": true }}Read a connected Discord server GET
Needs `org.integrations.view`.
Change a connected Discord server PATCH
Changes what is sent and keeps the rest. `verify_channel`: the channel Synq's bot keeps its “Verify with Synq” message in. The bot posts it there, or edits it in place when it is there already, and deletes the one it left in another channel. Its button starts each member's verification; it ends “Powered by Synq” as the brand's pages do. The bot needs View Channel, Send Messages and Embed Links in the channel (400 at `verify_channel` with the fix; 409 `discord_unavailable` on an API with no Discord bot). `invite_url`: an invite link for the member profile's Join button (null removes it). `listed`: whether the brand's member profile lists the server (null lists it): only with a way in, an invite link, so `true` with none is refused (400 at `listed`, with the fix), and a server whose link is removed stops showing until it has one again. `verified_channel`: where verified members go, a text channel of the server, usually one the gated roles unlock. Once a role is given, the member profile's Back to Discord opens it, and the bot's “You're verified” direct message links to it; null opens the server itself. The bot needn't post there (400 at `verified_channel` for a text channel the server doesn't have). Needs `org.integrations.edit`. Recorded as `discord_server.updated` with the fields changed.