Skip to content

get_task

get_task

Return the full detail of a single task — status, assignees, attached lists, parent reference, subtask count, and rich-text description. The task must belong to the authenticated user’s team.

FieldTypeRequiredDescription
taskIdnumberyesNumeric ID of the task to fetch.
{ "taskId": 421 }

A single text content block containing a JSON object with the task detail. The shape matches the OpenAPI Get a task by id response.

FieldTypeDescription
idnumberNumeric ID of the task.
keystringStable UUID key for the task.
numbernumberAuto-incrementing task number within the team.
titlestringTask title.
prioritystring | nullOne of low, medium, high, urgent, or null.
dueDatestring | nullISO 8601 date the task is due, or null.
completedAtstring | nullISO 8601 timestamp the task was completed, or null if still open.
createdAtstringISO 8601 timestamp of creation.
updatedAtstringISO 8601 timestamp of the last update.
descriptionstring | nullCommonMark markdown rendering of the task body, or null if there’s none.
customAttributesarray of objectsValues set for the team’s custom attributes.
statusobjectCurrent status with id, name, color, isCompleted.
assigneesarray of objectsUsers assigned to the task. May be empty.
taskListsarray of objectsLists the task is attached to.
parentobject | nullParent task {id, number, title} if this is a subtask, otherwise null.
subtaskCountnumberNumber of subtasks directly nested under this task.

The tool returns isError: true with an explanatory text block when no task with that ID exists in the user’s team.