Labels

Bnder API documentation for Labels. Read the API Overview to get started and learn more.

Get all labels

Get all labels for a guild by the guilds id

GET/consumer/v1/guilds/guildId/labels
ParametersDescription
guildIdThe id of a discord guild

Request body

empty

Response

Status: 200 - All labels for the guild

FieldTypeDescription
labelsarrayList of labels

Create a label

Create a label for a guild

POST/consumer/v1/guilds/guildId/labels
ParametersDescription
guildIdThe id of a discord guild

Request body

FieldTypeDescription
namestringThe name of the label
colorstringThe color of the label
descriptionstringThe description of the label

Response

Status: 200 - The created label

FieldTypeDescription
idstringThe id of the label
namestringThe name of the label
colorstringThe color of the label
descriptionstringThe description of the label

Update a label

Update a label for a guild by the guild and label id

PUT/consumer/v1/guilds/guildId/labels/labelId
ParametersDescription
guildIdThe id of a discord guild
labelIdThe ID of the label

Request body

FieldTypeDescription
namestringThe name of the label
colorstringThe color of the label
descriptionstringThe description of the label

Response

Status: 200 - The updated label

FieldTypeDescription
idstringThe id of the label
namestringThe name of the label
colorstringThe color of the label
descriptionstringThe description of the label

Delete a label

Delete a label for a guild by the guild and label id

DELETE/consumer/v1/guilds/guildId/labels/labelId
ParametersDescription
guildIdThe id of a discord guild
labelIdThe ID of the label

Request body

empty

Response

Status: 204 - The label was deleted

empty response