API referenceDiscord

POST /discord/guilds/{guildId}/roles

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

POST
/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)

Request Body

application/json
  1. body
name*string
Lengthlength <= 100
color?integer
Range0 <= value <= 16777215
hoist?boolean
mentionable?boolean
permissions?string

Bitfield as a string of digits

Response Body

{data}

application/json
  1. response
data?
Example Request
curl -X POST 'https://example.com/api/v1/discord/guilds/string/roles?accountId=string' \  -H 'Content-Type: application/json' \  -d '{  "name": "string"}'
Example Response
{  "data": {    "id": "string",    "name": "string",    "color": 0,    "position": 0,    "permissions": "string",    "managed": true,    "mentionable": true,    "hoist": true  }}

GET /discord/guilds/{guildId}/roles GET

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

PATCH /discord/guilds/{guildId}/roles/{roleId} PATCH

Edit a role: at least one of name, color, hoist, mentionable, permissions