Get A Task By ID

GET 
/projects/tasks/:taskId

Fetches one task or subtask by id. Fields are returned under task. A subtask’s parent id is task.properties.parentTaskId. TipTap content is task.properties.body. properties.statusGroup is server-derived and read-only; a task is complete when it is done. The home list is properties.primaryListId. Embedded subtasks are not returned — use Search Tasks with subtaskViewMode=expanded.

Request

Version stringrequired

API Version

Available optionsv3

taskId stringrequired

Task id

locationId string

Location id. Required for channel: APP. Ignored for OAuth/PIT — those use the location on the auth token. Do not send in path, body, or headers.

application/json

Successful response

application/json

Schema

Schema

taskobjectrequired

Task

Example (auto)

{
  "task": {
    "id": "6a102435124ecfb348bd5509",
    "locationId": "ve9EPM428h8b87FE9C12Kg",
    "objectKey": "task",
    "assignees": [
      "user_1"
    ],
    "properties": {
      "title": "Follow up with client",
      "status": "to_do",
      "dueDate": "2026-09-20T17:00:00.000Z",
      "priority": 2,
      "primaryListId": "6a102435124ecfb348bd5507"
    }
  }
}