APITopics

Topics

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

Get all topics

Get all topics in the guild. Can be filtered by project id and limited. Default limit is 100

GET /guilds/guildId/topics
Parameters

guildId The id of a discord guild
limit The number of items to return
project_id The ID of the project
Responses 200 Response (Retrieved topics):

Response FieldTypeDescription
topicsarrayThe list of topics

Create a topic

Create a new topic in the guild

POST /guilds/guildId/topics
Parameters

guildId The id of a discord guild
Request body

Request FieldTypeDescription
namestringThe name of the topic
project_idstringThe ID of the project
in_bin (optional)booleanWhether the topic is a bin

Responses 200 Response (Created topic):

Response FieldTypeDescription
idstringThe ID of the topic
namestringThe name of the topic
project_idstringThe ID of the project
delete_at (optional)stringThe date and time the topic was deleted
in_binbooleanWhether the topic is a bin

Get a topic

Get a topic by the topic id

GET /guilds/guildId/topics/topicId
Parameters

guildId The id of a discord guild
topicId The ID of the topic
Responses 200 Response (Retrieved topic):

Response FieldTypeDescription
idstringThe ID of the topic
namestringThe name of the topic
project_idstringThe ID of the project
delete_at (optional)stringThe date and time the topic was deleted
in_binbooleanWhether the topic is a bin

Update a topic

Update an existing topic in the guild

PUT /guilds/guildId/topics/topicId
Parameters

guildId The id of a discord guild
topicId The ID of the topic
Request body

Request FieldTypeDescription
name (optional)stringThe name of the topic
project_id (optional)stringThe ID of the project
in_bin (optional)booleanIf the topic is a bin

Responses 200 Response (Updated topic):

Response FieldTypeDescription
idstringThe ID of the topic
namestringThe name of the topic
project_idstringThe ID of the project
delete_at (optional)stringThe date and time the topic was deleted
in_binbooleanWhether the topic is a bin

Delete a topic

Delete a topic in the guild and all documents inside the topic

DELETE /guilds/guildId/topics/topicId
Parameters

guildId The id of a discord guild
topicId The ID of the topic
Responses 204 Response (Topic deleted): Empty response.

Social Media

X (Twitter)

Instagram

Discord

GitHub

YouTube

WhatsApp

bnder logo