PerspecTaskList all tasks
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
Query Parameters
Defaults to false. In tree mode, encrypted tasks are pruned UNLESS they lie on the path to an unencrypted task — so an encrypted parent of a readable task is kept (with encrypted: true and no title/description keys) to preserve structure, while fully-encrypted branches are hidden. In flat mode, encrypted tasks are simply omitted. Set to true to include ALL end-to-end-encrypted tasks for full visibility.
Defaults to false. When true, each task's children are returned as full nested task objects (recursively) instead of id strings. A task that was already expanded elsewhere in the tree will not be expanded again — only its short id string will appear in the children array of subsequent parent tasks, 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 the list omits done tasks (status COMPLETED and CANCELLED) so an agent sees only open work and to save context. Set to true to include all completed and cancelled tasks. Exception in tree mode: a completed task is kept if any of its descendants is still open — this preserves the path/context to that open task even when showCompleted is false.
Response Body
application/json
curl -X GET "https://example.com/tasks"[
{
"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"
]
}
]