Guilds
Bnder API documentation for Guilds. Read the API Overview to get started and learn more.
Get all guild limits
Get all guild limits and current usage
GET /guilds/guildId/limits
Parameters
guildId The id of a discord guild
Responses
200 Response (All guild limits and usages):
Response Field | Type | Description |
---|---|---|
max_projects | number | Maximal number of projects that can be created in the guild |
max_topics | number | Maximal number of topics that can be created in the guild |
max_labels | number | Maximal number of labels that can be created in the guild |
current_projects | number | Current number of projects in the guild |
current_topics | number | Current number of topics in the guild |
current_labels | number | Current number of labels in the guild |
premium_seats | number | Number of premium seats in the guild. This includes a seat for the guild owner. |
premium_users | array | User IDs of premium users in the guild |
max_task_assignees | number | Maximal number of labels that can be assigned to a single object in the guild |
max_labels_per_object | number | Maximal number of labels that can be added to a task or document in the guild |
max_event_invitees | number | Maximal number of invitees that can be added to an event in the guild |
free_task_assignees | number | Number of task assignees that can be added to a task in the guild without a premium plan |
free_projects | number | Number of projects that can be created in the guild without a premium plan |
free_topics | number | Number of topics that can be created in the guild without a premium plan |
free_labels | number | Number of labels that can be created in the guild without a premium plan |
free_labels_per_object | number | Number of labels that can be assigned to a single object in the guild without a premium plan |
free_event_invitees | number | Number of invitees that can be added to an event in the guild without a premium plan |
storage_bytes_used | number | Storage used in bytes |
storage_bytes_limit | number | Storage limit in bytes |
free_milestones | number | Number of milestones that can be created in the guild without a premium plan |
max_milestones | number | Maximal number of milestones that can be created in the guild |
Get all supported timezones
Get all supported timezones
GET /guilds/guildId/timezones
Parameters
guildId The id of a discord guild
Responses
200 Response (All supported timezones):
Response Field | Type | Description |
---|---|---|
timezones | array | List of timezones in the guild |
Get a guild
Get guild settings and properties by the guild id
GET /guilds/guildId
Parameters
guildId The id of a discord guild
Responses
200 Response (The guild):
Response Field | Type | Description |
---|---|---|
language | string | Language of the guild |
logging_webhook_url (optional) | string | URL to send logs to |
auto_labeling_enabled | boolean | Whether auto labeling is enabled |
auto_priority | boolean | Whether auto priority is enabled |
timezone | string | Timezone of the guild |
dateformat | string | Date format of the guild |
private_responses | boolean | Whether private responses are enabled |
user_languages | boolean | Whether user languages are enabled |
user_timezones | boolean | Whether user timezones are enabled |
default_assignee | number | Default assignee for tasks |
error_reporting | boolean | Whether error reporting is enabled |
week_start_day | string | Week start day for the guild |
github_key (optional) | string | GitHub key for the guild, uses for GitHub integration |
private_messages_enabled | boolean | Whether private messages are enabled |
log_level | number | Log level for the guild |
task_cleanup_policy (optional) | number | Days after which tasks in the done state should be deleted. 0 removes it |
Update settings for a guild
Update settings for a guild
PUT /guilds/guildId
Parameters
guildId The id of a discord guild
Request body
Request Field | Type | Description |
---|---|---|
language (optional) | string | The language of the guild. Must be a valid language code or ‘en’ for English. |
logging_webhook_url (optional) | string | The URL of the logging webhook for the guild. |
log_level (optional) | number | The logging level for the guild. |
auto_labeling_enabled (optional) | boolean | Whether auto-labeling is enabled for the guild. |
timezone (optional) | string | The timezone of the guild. |
dateformat (optional) | string | The date format of the guild. |
private_responses (optional) | boolean | Whether private responses are enabled for the guild. |
auto_priority (optional) | boolean | Whether auto-priority is enabled for the guild. |
user_languages (optional) | boolean | Whether auto-assign is enabled for the guild. |
user_timezones (optional) | boolean | Whether user timezones are enabled for the guild. |
default_assignee (optional) | number | The default assignee for tasks. |
error_reporting (optional) | boolean | Whether error reporting is enabled for the guild. |
week_start_day (optional) | string | The day of the week that the guild considers the start of the week. |
private_messages_enabled (optional) | boolean | Whether private messages are enabled for the guild. |
task_cleanup_policy (optional) | number | Days after which tasks in the done state should be deleted. 0 removes it |
Responses 200 Response (Updated guild):
Response Field | Type | Description |
---|---|---|
language | string | Language of the guild |
logging_webhook_url (optional) | string | URL to send logs to |
auto_labeling_enabled | boolean | Whether auto labeling is enabled |
auto_priority | boolean | Whether auto priority is enabled |
timezone | string | Timezone of the guild |
dateformat | string | Date format of the guild |
private_responses | boolean | Whether private responses are enabled |
user_languages | boolean | Whether user languages are enabled |
user_timezones | boolean | Whether user timezones are enabled |
default_assignee | number | Default assignee for tasks |
error_reporting | boolean | Whether error reporting is enabled |
week_start_day | string | Week start day for the guild |
github_key (optional) | string | GitHub key for the guild, uses for GitHub integration |
private_messages_enabled | boolean | Whether private messages are enabled |
log_level | number | Log level for the guild |
task_cleanup_policy (optional) | number | Days after which tasks in the done state should be deleted. 0 removes it |