Tasks represent actions that need to be completed and must be associated with a project. Tasks have an optional due date, can be assigned to a user and can have subtasks.
Returns all tasks. This is a cursor-paginated endpoint. For more information, please refer to our documentation on pagination.
/v1/tasks
cursor
string
For pagination, the marker (an opaque string value) representing the first item on the next page
limit
integer
For pagination, the limit of entries to be returned. If not provided, up to 500 items will be returned.
assignee_id
integer
If supplied, only tasks that are assigned to this user are returned
project_id
integer
If supplied, only tasks that are assigned to this project are returned
parent_task_id
integer
If null
is supplied then only parent tasks are returned. If integer is supplied then only subtasks of a specific task are returned. By default all tasks are returned.
done
number
Whether the task is done or not. 0
= Not done, 1
= Done. If not omitted then returns both done and not done tasks.
Values
0
1
OK
Returns the details of a specific task.
/v1/tasks/{id}
id
integer
required
The ID of the task
OK
Adds a new task.
/v1/tasks
application/json
title
string
required
The title of the task
project_id
number
required
The ID of a project
description
string
The description of the task
parent_task_id
number
The ID of a parent task. Can not be ID of a task which is already a subtask.
assignee_id
number
The ID of the user who will be the assignee of the task
done
Whether the task is done or not. 0 = Not done, 1 = Done.
Values
0
1
due_date
string
The due date of the task. Format: YYYY-MM-DD.
Format
date
Created
Updates a task.
/v1/tasks/{id}
id
integer
required
The ID of the task
application/json
title
string
The title of the task
project_id
number
The ID of the project this task is associated with
description
string
The description of the task
parent_task_id
number
The ID of a parent task. Can not be ID of a task which is already a subtask.
assignee_id
number
The ID of the user who will be the assignee of the task
done
Whether the task is done or not. 0 = Not done, 1 = Done.
Values
0
1
due_date
string
The due date of the task. Format: YYYY-MM-DD.
Format
date
OK
Marks a task as deleted. If the task has subtasks then those will also be deleted.
/v1/tasks/{id}
id
integer
required
The ID of the task
OK