API
Tasks

Tasks

Read the API Overview to get started and learn more.

Create Task

Create a new task.

POST
/
guilds
/
guildId
/
tasks

Request body

FieldTypeDescription
textstringTitle of the task
description (optional)stringDescription of the task
assigned_user_ids (optional)string[]All ids of users assigned to the task
assigned_role_ids (optional)string[]All ids of roles assigned to the task
status (optional)numberThe tasks status. (Defaults to 0) (Min. 0, Max. 2)
deadline (optional)stringDeadline of the task
label_ids (optional)string[]Ids of the labels assigned to a task
priority (optional)numberPriority of the task. (Defaults to 1) (Min. 0, Max. 3)
repeat_interval_days (optional)numberHow many days should be between the task getting repeated (Min. 1, Max. 365)
repeat_end_date (optional)stringWhen the task should not get repeated anymore

Response body

Returns TaskEntity

Returns a 200 status

Update task

Change the data of a task.

POST
/
guilds
/
guildId
/
projects
/
projectId
/
tasks
/
taskId

Request body

FieldTypeDescription
status (optional)numberStatus of the task (Min. 0, Max. 2)
text (optional)stringTitle of the task
description (optional)stringDescription of the task
assigned_user_ids (optional)string[]All ids of users assigned to the task
assigned_role_ids (optional)string[]All ids of roles assigned to the task
project_id (optional)stringId of a project
deadline (optional)stringDate of the deadline or "" when deadline should be removed
priority (optional)numberTasks priority (0 = low, 1 = normal, 2 = high, 3 = urgent)
repeat_days_interval (optional)numberDays until the task repeats again (Min. 1, Max. 365)
repeat_end_date (optional)stringDate until the task gets repeated
label_ids (optional)string[]All ids of labels assigned to the task
in_bin (optional)booleanWhether the task should be in bin

Response body

Returns TaskEntity

Returns a 200 status

Delete task

Delete a task.

DELETE
/
guilds
/
guildId
/
projects
/
projectId
/
tasks
/
taskId

Request body

-

Response body

-

Returns a 204 status

Update task order in project

Changes the order how tasks are displayed in the app.

PUT
/
guilds
/
guildId
/
projects
/
projectId
/
tasks

Request body

FieldTypeDescription
todo_tasksstring[]Ids of all tasks in the todo status in the order shown in the app
in_progress_tasksstring[]Ids of all tasks in the "in progress" status in the order shown in the app
done_tasksstring[]Ids of all tasks in the done status in the order shown in the app

Response body

FieldTypeDescription
todo_tasksstring[]Ids of all tasks in the todo status in the order shown in the app
in_progress_tasksstring[]Ids of all tasks in the "in progress" status in the order shown in the app
done_tasksstring[]Ids of all tasks in the done status in the order shown in the app

Returns a 200 status

Get tasks in project

Returns all ids of tasks inside a project.

GET
/
guilds
/
guildId
/
projects
/
projectId
/
tasks

Request body -

Response body

FieldTypeDescription
todo_tasksstring[]Ids of all tasks in the todo status in the order shown in the app
in_progress_tasksstring[]Ids of all tasks in the "in progress" status in the order shown in the app
done_tasksstring[]Ids of all tasks in the done status in the order shown in the app

Returns a 200 status

Get task data

Get data to one specific task.

GET
/
guilds
/
guildId
/
projects
/
projectId
/
tasks
/
taskId

Request body -

Response body Returns TaskEntity

Returns a 200 status

Add a comment

Add a comment to a task.

POST
/
guilds
/
guildId
/
projects
/
projectId
/
tasks
/
taskId
/
comments

Request body

FieldTypeDescription
textstringThe comment

Response body

Returns a 200 status

Returns TaskEntity

Delete a comment

Delete a comment from a task.

DELETE
/
guilds
/
guildId
/
projects
/
projectId
/
tasks
/
taskId
/
comments

Request body

FieldTypeDescription
textstringThe comment
author_idstringThe id of the author of the comment
datestringThe date the comment was created

Response body

Returns a 200 status

Returns TaskEntity

Task Entity

FieldTypeDescription
idstringThe task ID
statusnumberThe status the task is in (0 = todo, 1 = in progress, 2 = done)
textstringThe title of a task
description (optional)stringThe description of a task
assigned_user_idsstring[]Ids of assigned users
assigned_role_idsstring[]Ids of assigned roles
project_idstringId of the tasks project
deadline (optional)stringDeadline set for a task
prioritynumberPriority of the task (0 = low, 1 = normal, 2 = high, 3 = urgent)
repeat_days_interval (optional)numberIn what interval (in days) the task should be repeated (1-365)
repeat_end_date (optional)stringDate when the task should not be repeated
label_idsstring[]Ids of labels assigned to the task
creation_datestringThe date the task was created at
creator_idstringId of the user who created the task. ("api" when it was created by an api user)
in_binbooleanWhether the task is currently in the bin
delete_at (optional)stringThe date when the task is deleted
historyHistory[]The history of the task
subtasksSubtask[]The subtasks of the task
commentsComment[]The comments of the task

History Entity

FieldTypeDescription
idnumberId of the action that was performed on the task
executorstringId of a user that performed an action. "system" or "api" for non-users
timestampDateThe timestamp when the action was performed
dataAdditional data

History Actions

IdDescription
0Task created
1Text edited
2Status edited
3Task moved to bin
4Task moved to another project
5Assignees added
6Task restored from bin
7Deadline edited
8Repeat interval removed
9Repeat interval set
10Assignees removed
11Label added
12Label removed
13Priority changed
14Subtask added
15Subtask removed
16Commit mention
17Description edited

Subtask Entity

FieldTypeDescription
creation_dateDateThe date when the subtask was created
textstringText of the subtask
completedbooleanWhether the subtask is completed or not

Comment Entity

FieldTypeDescription
textstringThe comment
author_idstringThe id of the author of the comment
created_atstringThe date the comment was created

Social Media

X (Twitter)

Instagram

Discord

GitHub

YouTube

bnder logo