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 work unit that produced the task, when applicable.
sourceTitle*
string,null
Title of the source work unit, when applicable.
sourceSummary*
string,null
Summary of the source work unit, when available.
sourceKind*
string,null
Extensible source-work-unit kind, when applicable.
401
The workspace API key is missing, invalid or revoked. Problem
401 body
application/problem+json
Field
Type
Description
Example
type*
string:uri-reference
about:blank
title*
string
Short, human-readable summary.
status*
integer
HTTP status code.
401
code*
string
Stable error code for programmatic handling.
unauthorized
detail*
string
Explanation specific to this occurrence.
hint*
string
How to resolve or work around the error.
405
The resource is read-only. Problem
405 body
application/problem+json
Field
Type
Description
Example
type*
string:uri-reference
about:blank
title*
string
Short, human-readable summary.
status*
integer
HTTP status code.
401
code*
string
Stable error code for programmatic handling.
unauthorized
detail*
string
Explanation specific to this occurrence.
hint*
string
How to resolve or work around the error.
429
Rate limit exceeded. Retry after the window resets. Problem
429 body
application/problem+json
Field
Type
Description
Example
type*
string:uri-reference
about:blank
title*
string
Short, human-readable summary.
status*
integer
HTTP status code.
401
code*
string
Stable error code for programmatic handling.
unauthorized
detail*
string
Explanation specific to this occurrence.
hint*
string
How to resolve or work around the error.
500
Unexpected server error. Problem
500 body
application/problem+json
Field
Type
Description
Example
type*
string:uri-reference
about:blank
title*
string
Short, human-readable summary.
status*
integer
HTTP status code.
401
code*
string
Stable error code for programmatic handling.
unauthorized
detail*
string
Explanation specific to this occurrence.
hint*
string
How to resolve or work around the error.
Need another task field or view?
Tell us whether you need another field, completed tasks, filters, or pagination, and what the integration will do with it.