Task Commands
đź’ˇ
To understand the concept of tasks, take a look at this page.
/task create
title
My task
description
Do this and then do that
assignee
@User
project
default
deadline
10/30/2023 09:00
repeat_days
10
label
My label
This command creates a new task. The task will get a random id and the given title will be linked to it.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | title | The title of the task |
| No | description | The description of a task |
| No | assignee | A user or role from the server that should get assigned to the task |
| No | project | The project the task should be created in |
| No | deadline | The deadline of the task. Can be set to a date with time or as a relative date (e.g. 1w2d) |
| No | repeat_days | The interval in days the task should be repeated |
| No | label | A label that will be added to the task |
Required permission: MANAGE_TASKS
/task assign
task_id
12345
assignee
@User
This command adds a new assignee to the specified task. Roles and users can get assigned to a task. There can be a maximum of 15 assignees per task, counting users and roles.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | task_id | The id of the task (can be found in the task list or when creating a task) |
| Yes | assignee | A user or role from the server that should get assigned to the task |
Required permission: MANAGE_TASKS
/task unassign
task_id
12345
assignee
@User
This command removes an assignee from a task.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | task_id | The id of the task (can be found in the task list or when creating a task) |
| Yes | assignee | A user or role from the server that should get removed from the task |
Required permission: MANAGE_TASKS
/task info
task_id
12345
show
FALSE
Provides detailed information about the task.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | task_id | The id of the task (can be found in the task list or when creating a task) |
| No | show | Whether the response should be shown to everyone, or only to the command executor |
/task todo
task_id
12345
Sets the status of the task with the given id to todo.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | task_id | The id of the task (can be found in the task list or when creating a task) |
/task inprogress
task_id
12345
Sets the status of the task with the given id to inprogress.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | task_id | The id of the task (can be found in the task list or when creating a task) |
/task done
task_id
12345
Sets the status of the task with the given id to done.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | task_id | The id of the task (can be found in the task list or when creating a task) |
/task edit
task_id
12345
title
My new task title
description
The new description of the task
Allows the command author to change the task title and/or description.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | task_id | The id of the task (can be found in the task list or when creating a task) |
| No | title | The new v of the task |
| No | description | The new description of the task |
Required permission: MANAGE_TASKS
/task list
project
default
assignee
@User
filter
IN_PROGRESS
show
FALSE
Displays all tasks assigned to the specified assignee.
Command Options
| Required | Name | Description |
|---|---|---|
| No | project | The project the tasks have to be in. If not specified, the currently selected project will be used. |
| No | assignee | A user or role from the server that should be assigned to the task. If not specified, the command will list all tasks assigned to the command executor. |
| No | filter | The status the tasks have to be in |
| No | show | Whether the response should be shown to everyone, or only to the command executor |
/task project
project
default
filter
IN_PROGRESS
label
My label
show
FALSE
Displays all tasks inside a selected project.
Command Options
| Required | Name | Description |
|---|---|---|
| No | project | The project the tasks have to be in. If not specified, the currently selected project will be used. |
| No | filter | The status the tasks have to be in |
| No | label | A label the tasks should have |
| No | show | Whether the response should be shown to everyone, or only to the command executor |
/task move
task_id
12345
project
default
Moves a task to a different project.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | task_id | The id of the task (can be found in the task list or when creating a task) |
| Yes | project | The new project the task should be moved to. |
Required permission: MANAGE_TASKS
/task deadline
task_id
12345
deadline
12/31/2024 23:59
Sets the deadline of a task.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | task_id | The id of the task (can be found in the task list or when creating a task) |
| No | deadline | The new deadline of a task in the dateformat selected by a server admin or as a relative date (e.g. 1 day 2 hours) or in a relative short form (1w2d). If no deadline is set the deadline will be removed from the task. |
Required permission: MANAGE_TASKS
/task delete
task_id
12345
Move task to recycle bin. Tasks moved to the recycle bin are permanently deleted after 30 days.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | task_id | The id of the task (can be found in the task list or when creating a task) |
Required permission: MANAGE_TASKS
/task restore
task_id
12345
Restores a deleted task that was previously moved to the Recycle Bin.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | task_id | The id of the task (can be found in the task list or when creating a task) |
Required permission: MANAGE_TASKS
/task repeat
task_id
12345
repeat_days
7
repeat_end
5 weeks
Makes the task repeatable. If the repeat_days option is set, the task will be repeated every x days. This means the task will be moved back into the todo state when it reached the done state after the repeat interval is reached.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | task_id | The id of the task (can be found in the task list or when creating a task) |
| No | repeat_days | The interval in days the task should be repeated |
| No | repeat_end | The date the task should be repeated until. The date can be set as a relative date (e.g. 1w2d) or in a relative short form (1w2d). If no repeat_end is set the task will be repeated indefinitely. If repeat_end is set to a date in the past, the task will not be repeated. |
Required permission: MANAGE_TASKS
/task history
task_id
12345
Displays the history of a task. The history contains all changes made to the task.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | task_id | The id of the task (can be found in the task list or when creating a task) |
Required permission: VIEW_TASKS
/task priority
task_id
12345
priority
high
Changes the priority of a task. The default priority is normal.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | task_id | The id of the task (can be found in the task list or when creating a task) |
| Yes | priority | The priority of the task. Can be set to low, normal, high and urgent. |
Required permission: MANAGE_TASKS
/task subtasks
task_id
12345
action
add
title
Remove the test button
number
1
Manages subtasks of a task. Subtasks are tasks that are linked to a parent task. They can be used to split a task into smaller tasks.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | task_id | The id of the task (can be found in the task list or when creating a task) |
| Yes | action | The action that should be performed on the subtasks. Can be set to add, remove, complete or uncomplete. |
| No | title | The title of the subtask that should be added. Only required for the add action. |
| No | number | The number of the subtask that should be removed, completed or uncompleted. Only required for the remove, complete and uncomplete action. |
Required permission: MANAGE_TASKS
Project Commands
đź’ˇ
To understand the concept of projects, take a look at this page.
/project create
project
My project
This will create a new project with the specified name. After the creation, all users on the server will be able to switch to the new project.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | project | The name of the project to create |
Required permission: MANAGE_PROJECTS
/project create-personal
project
My own project
This will create a new personal project with the specified name. You will have full control over this project and can add other users to it.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | project | The name of the project to create |
Required permission: CREATE_PERSONAL_PROJECTS
/project select
project
My project
This command allows you to select a different project. When new tasks are created, they will be created in the selected project.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | project | The name of the project (can be found in the project list or when creating a project) |
/project list
Displays all projects on the server.
/project rename
project
My project
new_name
New project
Renames a project. If no project is specified, the currently selected project will be renamed.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | project | The name of the project (can be found in the project list or when creating a project) |
| Yes | new_name | The new name of the project |
Required permission: MANAGE_PROJECTS
/project manager
project
My project
manager
@Jan
When no manager option is specified, the bot will display the current manager of the project. If a manager is specified, the bot will set the user as the manager of the project.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | project | The name of the project (can be found in the project list or when creating a project) |
| No | manager | A user that will be set as a manager of the project. If not specified, the current manager will be displayed. |
Required permission: MANAGE_PROJECTS
/project delete
project
My project
Moves the specified project to the recycle bin. It can be restored until it is permanently deleted after 30 days. All tasks in this project will also be moved to the Recycle Bin. If deleted immediately, the project and all tasks within the project will be irrevocably deleted. The bot won't ask for confirmation.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | project | The name of the project to delete |
Required permission: MANAGE_PROJECTS
/project restore
project
My project
Restores a project from the Recycle Bin
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | project | The name of a deleted project to restore |
Required permission: MANAGE_PROJECTS
Permission Commands
đź’ˇ
To understand the concept of permissions, take a look at this page.
/permission grant
mentionable
@User
permission
MANAGE_TASKS
project
My Project
This will grant the mentioned user or role the specified permission.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | mentionable | The user or role to grant the permission to. |
| Yes | permission | The permission to grant. |
| No | project | A name of an existing project if the permissions should be granted only on a project level. |
Required permission: MANAGE_PERMISSIONS
/permission revoke
mentionable
@User
permission
MANAGE_TASKS
project
My Project
Removes specified permisson from mentioned user. Users or roles with administrator permissions & server owners won't be affected by this. If the user has a role with the permission granted, he can still execute commands requiring that permission.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | mentionable | The user or role to revoke the permission from. |
| Yes | permission | The permission to revoke. |
| No | project | A name of an existing project if the permissions should be revoked only on a project level. |
Required permission: MANAGE_PERMISSIONS
/permission list
mentionable
@User
project
My Project
This will display all permissions and show if the user has the permission.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | mentionable | The user or role to list permissions for. |
| No | project | A name of an existing project if the permissions should be listed only on a project level. |
Required permission: MANAGE_PERMISSIONS
/permission preset
preset
contributor
mentionable
@User
project
My Project
Apply a preset to a user or role. Presets are a collection of permissions.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | preset | The name of the preset to apply. |
| Yes | mentionable | The user or role to apply the preset to. |
| No | project | A name of an existing project if the preset should be applied only on a project level. |
Required permission: MANAGE_PERMISSIONS
Label Commands
/label create
name
My label
color
red
Creates a new label with the given name and color.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | name | The name of the label. |
| No | color | The color of the label, if any. |
Required permission: MANAGE_LABELS
/label delete
name
My label
Deletes a label with the given name.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | name | The name of an existing label. |
Required permission: MANAGE_LABELS
/label list
Lists all labels.
/label add
object_id
13
name
My label
Adds a label with the given name to the object (task or document) with the given ID.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | object_id | The id of the object (task or document) to add the label to. |
| Yes | name | The name of the label to add. |
/label remove
object_id
13
name
My label
Removes a label with the given name from the object (task or document) with the given ID.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | object_id | The id of the object (task or document) to remove the label from. |
| Yes | name | The name of the label to remove. |
/label edit
name
My label
new_name
New label
color
blue
Removes a label with the given name from the object (task or document) with the given ID.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | name | The name of the label to edit. |
| Yes | new_name | The new name of the label. |
| No | color | The new color of the label, if any. |
Preferences Commands
/preferences language
language
francais
Changes the language of the bot, only for you.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | language | The language you want to use. |
/preferences timezone
timezone
Europe/Berlin
Changes the timezone the bot uses when working with dates, only for you.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | timezone | The timezone you want to use. |
/preferences event_reminders
enabled
true
Enables or disables event reminders for you. Only affects the Calendar Manager.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | enabled | Whether you want to receive event reminders. |
/preferences direct_messages
enabled
true
Enables or disables direct messages from the bot when a new task gets assigned to you. Only affects the Task Manager.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | enabled | Whether you want to receive direct messages from the bot. |
General commands
/setup
Starts the setup process for the bot. This will guide you through the setup of the Task Manager, Knowledge Manager and Calendar Manager.
/support
Gives you the link to our Discord server (https://bnder.net/discord).
/invite
Gives you the link to invite the bot to your server.
/settings language
language
francais
Changes the language of the bot on the server. (This will affect the Task Manager, Knowledge Manager and Calendar Manager if all are on the server).
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | language | The language you want the bots to use. |
Required permission: MANAGE_SETTINGS
/settings logging
webhook_url
discord.com/...
Sets a webhook to log events. If no webhook is set, logging will be disabled. Read more about logging here. This only affects the Task Manager for now.
Command Options
| Required | Name | Description |
|---|---|---|
| No | webhook_url | A discord webhook url to log events. |
Required permission: MANAGE_SETTINGS
/settings log_level
level
Create & Delete
Sets the level of logging. Read more about logging and log levels here. This only affects the Task Manager for now.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | level | The level which determines what events should be logged |
Required permission: MANAGE_SETTINGS
/settings auto_labeling
enabled
true
Enables or disables the auto labeling feature. Read more about auto labeling here.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | enabled | True or false |
Required permission: MANAGE_SETTINGS
/settings auto_priority
enabled
true
Enables or disables the auto priority feature. Read more about auto priority here.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | enabled | True or false |
Required permission: MANAGE_SETTINGS
/settings timezone
timezone
America/New_York
Changes the timezone of the bot on the server. This will affect the Task Manager and the Knowledge Manager.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | timezone | The timezone you want the bots to use. |
Required permission: MANAGE_SETTINGS
/settings dateformat
dateformat
MM/dd/yyyy HH:mm
Changes the date format of the bot on the server. This will affect the Task Manager and the Knowledge Manager.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | dateformat | The date format you want the bots to use. |
Required permission: MANAGE_SETTINGS
/settings user_languages
enabled
true
Allows/Disallows user to use the /preferences command to change the language only for them.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | enabled | True or false |
Required permission: MANAGE_SETTINGS
/settings user_timezones
enabled
true
Allows/Disallows user to use the /preferences command to change the timezone only for them.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | enabled | True or false |
Required permission: MANAGE_SETTINGS
/settings default_assignee
default_assignee
Creator
Can change the default assignee for new tasks, between "None", "Creator" and "Project manager".
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | default_assignee | None, Creator or Project manager |
Required permission: MANAGE_SETTINGS
/settings week_start_day
day
monday
Changes the day the week starts on the server. This will affect the Calendar Manager.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | day | The day of the week you want the week to start on. Can be set to monday or sunday. |
Required permission: MANAGE_SETTINGS
/settings private_messages
enabled
true
Allows/Disallows the bot to send private messages to users. These messages are sent when a user or a role of a user gets assigned to a task. Only affects the Task Manager.
Command Options
| Required | Name | Description |
|---|---|---|
| Yes | enabled | True or false |
Required permission: MANAGE_SETTINGS
/integration github
Starts the integration process with GitHub. This will allow you to link a GitHub repository to a project in the Task Manager.
Required permission: MANAGE_SETTINGS
