API referenceDiscord

GET /discord/guilds/{guildId}/roles

Every role of the server (unordered; sort by position). Every call takes accountId: a Discord account of the organization bound to that server (404 otherwise). Discord's 403 (bot permissions or role hierarchy) is passed on; servers that installed the bot before a permission was asked for must re-invite it

GET
/discord/guilds/{guildId}/roles

Authorization

BearerAuth
headerAuthorizationBearer <token>

API key sk_...

Path Parameters

guildId*string

Discord server (guild) id

Query Parameters

accountId*string

Discord account id bound to this server (or the channel's server)

Response Body

{data}

application/json
  1. response
data?array<>
Example Request
curl -X GET 'https://example.com/api/v1/discord/guilds/string/roles?accountId=string'
Example Response
{  "data": [    {      "id": "string",      "name": "string",      "color": 0,      "position": 0,      "permissions": "string",      "managed": true,      "mentionable": true,      "hoist": true    }  ]}

POST /discord/channels/{channelId}/messages/{messageId}/crosspost POST

Publish an announcement-channel message to every following server (400 before Discord is called when the channel is not an announcement channel)

POST /discord/guilds/{guildId}/roles POST

Create a role (needs Manage Roles; it cannot sit at or above the bot's highest role)