Skip to main content
GET
List Tasks
Lists one workspace’s tasks, filtered to the audiences you may see: internal members see internal and shared tasks, external members see shared only. Name the workspace with workspaceId, or list one task’s children with parentId alone (its workspace); never both. Auth: Authorization: Bearer tr_...

Query parameters

Response

Each entry has the task’s fields as on Get Task, with latestRound as { number, outcome } (so “round 2 · sent back” reads from the row) and without approvedRound, links, children and timeline; read those with Get Task. Every entry names its assignee, reviewer, createdBy and completedBy as principals. Tasks come newest first by creation time, or by finish time with order=finished. Replay cursor with the same filters and order. Nothing sorts or filters on dueAt. nextCursor is null on the last page. To take the next matching task rather than list it, start by tags.

Error codes

Operator mirror

GET /v0/operator/tasks takes the same parameters with an operator session, acting as the bound account.