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
textstringText 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)stringText 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

Task Entity

FieldTypeDescription
idstringThe task ID
statusnumberThe status the task is in (0 = todo, 1 = in progress, 2 = done)
textstringThe text 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
historyThe history of the task
subtasksThe subtasks of the task

Social Media

Twitter

Instagram

Discord

GitHub

YouTube

bnder logo