TasksGet task

Get task

GET

Returns one task by id, including assigneeIds and predecessors — the two relations that List tasks omits.

A task your token can’t reach answers 404 — never 403 — since a foreign id looks identical to a nonexistent one. See Authentication → for the full denial contract.

Path parameters

NameTypeRequiredDescription
taskIdstring (uuid)YesThe task to retrieve.

Response fields

NameTypeDescription
idstring (uuid)Stable task identifier.
namestringTask name as shown in the timeline.
descriptionstring or nullOptional task description.
startDate / endDatestring (ISO 8601)Scheduled window, returned with its UTC offset.
estimationnumber or nullOptional task estimate.
progressintegerCompletion percentage from 0 to 100.
statusstringCurrent workflow status.
statusKeystring or nullOptional custom workflow status key.
prioritystringCurrent task priority.
orderIndexnumberSort position within the project.
indentationintegerHierarchy depth in the task tree.
parentIdstring (uuid) or nullParent task identifier, when nested.
assigneeIdsarray of UUIDsProject member or resource identifiers assigned to the task.
predecessorsarray of objectsDependency edges, including predecessor id, type, and lag.