SynqDocs
Management APIDiscord servers

Change a connected Discord server

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.

PATCH/v1/orgs/{org}/discord-servers/{server}

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.

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}$
server*string

The Discord server's id

Match^dsv_[0-9a-hjkmnp-tv-z]{26}$

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X PATCH "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/discord-servers/dsv_01h455vb4pex5vsknk084sn02q" \  -H "Authorization: Bearer $SYNQ_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "verify_channel": "1187390245566009876",    "verified_channel": "1187390245566009877",    "invite_url": "https://discord.gg/mollyverse",    "listed": true  }'
{  "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"}