GET /tasks returns up to 100 current tasks across the workspace. Current means the task is open and is not snoozed into the future.
Tasks with due dates come first, earliest due date first. Tasks without a due date follow them. Tasks with the same due date retain creation order. The endpoint is read-only and does not return completed, cancelled, or currently snoozed tasks.
A deliberately small resource API for server-side twelfth integrations. It starts with workspace identity and current task reads; new resources are added only after their contracts and permissions are ready.
**Authentication.** Send a workspace API key as `Authorization: Bearer <key>`. Give each server, script or automation its own labelled key and never expose a key in browser code.
**Errors.** Every error is `application/problem+json` (RFC 9457), with a stable machine-readable `code` and a recovery `hint`.
**Compatibility.** Paths are stable and unversioned. Published operations evolve additively: existing paths, fields and documented error codes remain supported.
**Rate limits.** Responses carry `RateLimit-*` headers; a `429` also carries `Retry-After`.
GET/tasks
List current tasks
Returns up to 100 current tasks across the workspace. A current task is open and not snoozed into the future. Tasks are ordered by due date first, then creation time; tasks without a due date follow dated tasks.
Responses
Status
Description
200
The workspace's current tasks. TasksResponse
200 body
application/json
Field
Type
Description
Example
tasks*
array[Task]Show fields
Field
Type
Description
Example
id*
string
Stable task identifier.
task_01JABCDEFGHJKMNPQRSTVWXYZ
title*
string
Short description of the work.
Review the Nintendo order
details*
string,null
Additional task context when available.
dueAt*
string,null:date-time
Due time in RFC 3339 format, or null when the task has no due date.
2026-10-21T03:00:00.000Z
bookKey*
string,null
Buying-remit key, or null for a workspace-wide task.
dept:toys
assigneeName*
string,null
Display name of the assignee, when assigned.
Sam Lee
assigneeEmail*
string,null:email
Email address of the assignee, when assigned.
sam@example.com
sourceSessionId*
string,null
Identifier of the source task that produced this one, when applicable.
sourceTitle*
string,null
Title of the source task, when applicable.
sourceSummary*
string,null
Summary of the source task, when available.
sourceKind*
string,null
Extensible source-task kind, when applicable.
401
The workspace API key is missing, invalid or revoked. Problem