Skip to main content
GET
Get task
Requires the tasks:read scope. You must be a member of the task’s workspace. Access-restricted members receive 403 if the task belongs to a list outside their permitted scope.

Path parameters

string
required
The numeric task ID.

Response

number
required
Task identifier.
number
required
Workspace this task belongs to.
number | null
List this task belongs to. null if not in a list.
string
required
Task title.
string | null
Task description as an HTML string. null if not set.
string
required
Task priority. One of urgent, high, medium, low, or none.
number
required
Workspace-scoped sequential task number.
string | null
UTC ISO-8601 due date. null if not set.
string | null
UTC ISO-8601 start date. null if not set.
number
required
User ID of the task creator.
string
required
UTC ISO-8601 creation timestamp.
object | null
Current task status. null if no status is assigned.
array
required
Array of users assigned to the task. Empty array if unassigned.
array
required
Labels attached to the task. Empty array if no labels are assigned.
array
required
Direct subtasks of this task. Empty array if the task has no subtasks.
array
required
Confirmed file attachments on the task. Empty array if none.
array
required
Custom fields that apply to this task’s list, each with its current value. Fields restricted to other lists or folders are not returned. Fields the user does not have access to are also omitted.