List tasks
Lists the tenant's tasks, paginated, with optional filters.
Lists the tenant's tasks, paginated, with optional filters.
The per-tenant API key, copied from Settings → API & integrations.
Sent as the x-api-key request header. The key is tenant-scoped and acts
with Admin-equivalent, tenant-wide access.
In: header
Query Parameters
Page size, 1–200. Defaults to 50.
Opaque cursor from a previous page's nextCursor. Omit for the first page.
Filter by project id, or other for tasks with no project.
Filter by completion status.
Filter by assignee user id.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/tasks"{ "data": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "title": "string", "detail": "string", "projectId": "5a8591dd-4039-49df-9202-96385ba3eff8", "projectName": "string", "assigneeId": "665a9750-71bd-4b96-bacd-9efa4ae022dd", "assigneeName": "string", "done": true, "doneAt": "2019-08-24T14:15:22Z", "doneBy": "string", "createdAt": "2019-08-24T14:15:22Z" } ], "nextCursor": "string"}{ "error": { "code": "unauthorized", "message": "Missing or invalid API key." }}{ "error": { "code": "validation", "message": "One or more inputs are invalid.", "fields": { "fieldName": "A message explaining what's wrong with this field." } }}Get a task GET
Fetch a single task by id.
Update, reassign, or mark a task done PATCH
Edits a task and/or ticks it. A `done` boolean marks the task done/undone; `title`, `detail`, `projectId`, and `assigneeId` edit the task (reassign is just an `assigneeId` change). Field edits apply first, then the done flip, so one call can reassign and mark done together.