PerspecTaskGet a task by id
Authorization
bearerAuth Your PerspecTask API key (starts with pt_live_). Each key carries scopes: tasks:read (GET), tasks:write (full create/update), and tasks:write:meta (create/update everything EXCEPT editing title/description of existing tasks — for automation that manages workflow without rewriting human-authored content).
In: header
Path Parameters
Query Parameters
Defaults to false. In tree mode, encrypted descendants are pruned unless they lie on the path to an unencrypted task (so you see the structure leading to a task you can read). Set to true to keep ALL encrypted tasks in the subtree (returned with encrypted: true and no title/description keys). The requested task itself is always returned regardless.
Defaults to false. When true, this task's children are returned as full nested task objects (recursively) instead of id strings. A task that was already expanded elsewhere in the subtree will not be expanded again — only its short id string will appear in subsequent parents' children, preserving the relationship without repeating the full object.
Like tree but without deduplication: a task with multiple parents appears under each parent. Mutually exclusive with tree.
Defaults to false. Set to true to include created as a human-friendly relative time (e.g. "5 minutes ago"). Ignored when showCreatedDate is true.
Defaults to false. Set to true to include created as an absolute ISO 8601 timestamp. Takes precedence over showCreated when both are set.
Defaults to false. By default completed and cancelled subtasks are pruned from the tree. Exception: a completed task is kept if any of its descendants is still open (to preserve context/path). Set to true to include all completed and cancelled tasks regardless.
Response Body
application/json
curl -X GET "https://example.com/tasks/string"{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"title": "string",
"description": "string",
"encrypted": true,
"deadline": "string",
"deadline_date": "2019-08-24T14:15:22Z",
"status": "ACTIVE",
"completion": "string",
"worked_time": 0,
"priority": 1,
"created": "string",
"children": [
"4feb20ac-04ac-4bd8-9baa-d4924dafff88"
],
"parents": [
"4a2a1780-dcad-496e-bb7c-2bbf3a673e26"
]
}