Get a task by id

GET /v1/tasks/{taskId}

Returns the full detail for a single task: status, assignees, attached lists, parent task reference, subtask count, and the rich-text description.

Request

Path parameters

Name	Type	Required	Description
taskId	string	yes	Numeric ID of the task.

No request body.

Response

200 OK — task detail object.

Field	Type	Description
id	number	Numeric ID of the task.
key	string	Stable UUID key for the task.
number	number	Auto-incrementing task number within the team.
title	string	Task title.
priority	string | null	One of low, medium, high, urgent, or null.
dueDate	string | null	ISO 8601 date the task is due, or null.
completedAt	string | null	ISO 8601 timestamp the task was completed, or null if still open.
createdAt	string	ISO 8601 timestamp of creation.
updatedAt	string	ISO 8601 timestamp of the last update.
description	string | null	CommonMark markdown rendering of the task body, or null if there’s none.
customAttributes	array of objects	Values set for the team’s custom attributes — see below.
customAttributes[].id	number	ID of the custom attribute.
customAttributes[].value	any	Value for that attribute. The shape depends on the attribute type.
status	object	Current status — see below.
status.id	number	Numeric ID of the status.
status.name	string	Display name.
status.color	string | null	Hex color used in the UI, or null.
status.isCompleted	boolean	true if this status counts as “done”.
assignees	array of objects	Users assigned to the task. May be empty.
assignees[].id	string	User ID (UUID).
assignees[].name	string	User’s display name.
assignees[].email	string	User’s email address.
taskLists	array of objects	Lists the task is attached to. A task can belong to several lists.
taskLists[].id	number	Numeric ID of the list.
taskLists[].name	string	Display name of the list.
parent	object | null	The parent task if this is a subtask, otherwise null.
parent.id	number	Numeric ID of the parent task.
parent.number	number	Parent task’s number.
parent.title	string	Parent task’s title.
subtaskCount	number	Number of subtasks directly nested under this task.

404 Not Found is returned with { "error": "Task not found" } if no task with that ID exists in the current team.