Skip to main content
GET
Returns a cursor-paginated page of tasks, ordered by priority, then due date, then most recently created. Filtering by status=completed alone is the exception: finished work comes back most recently completed first, since priority order there buries the latest completions. Results are scoped to what your API key’s user can see. Pass the cursor from a response to fetch the next page; a null cursor means you have reached the end. The cursor marks the row where the next page starts, so you can change limit between pages. Archived and draft tasks are excluded unless you filter for them. assigned_to and involving take a user id, email address, name, or me. A user id is applied as given, so the tasks of a deactivated user stay listable. An email or name that matches nobody, or more than one person, is a 400 rather than an empty page; the ambiguous case lists the candidates. me names your API key’s user, so assigned_to=me lists your own tasks; a user named “me” must then be referenced by id or email. me added 2026-10-25. When an item has an agent assigned, assigned_agent.id is the agent’s record id and assigned_agent.counsel_id is the agent id List agents returns; either is accepted wherever an agent is referenced. counsel_id added 2026-09-05. linked_type and linked_id find the tasks that link to an item, such as every task about a review. Added 2026-10-13. matter_id lists the tasks filed in one matter, and without_matter the tasks filed in none. Send one of them at most. Both need matters to be enabled for your organisation, and answer 400 without them. An empty matter_id or without_matter is a 400. A matter_id that matches no matter answers an empty page, as a matter with no tasks you can read does. A task in a matter you cannot read still lists if you can read the task; its matter then has a null name and is_masked set. Added 2026-11-18.

Query parameters

string
Free-text search across title, description, additional context and comment text.
string
Comma-separated: not_started, in_progress, waiting_on_external, completed, cancelled.
string
One of no_priority, urgent, high, medium, low.
string
A user id, email address, name, or me for the caller — only tasks assigned to this person.
string
A user id, email address, name, or me for the caller — tasks this person is involved in at all (assignee, creator or shared).
string
Task team id.
string
A team id or team name — only tasks assigned directly to this team, not to its members. An unknown or ambiguous team, or one you cannot view, returns 400. Requires teams to be enabled for your organisation.
string
Comma-separated tag list.
string
Comma-separated source groups — only tasks that came in through any of them: email (forwarding address and connected mailboxes), slack, teams, whatsapp, web_app (web, iOS, Android, Office add-ins, template drafting, report and playbook chats), api, scheduled, agent (created by an agent run, RSS or an evaluation). An unknown value is a 400. Each task’s raw channel is returned in source_channel.
string
ISO 8601 timestamp, e.g. 2026-01-01 or 2026-01-01T09:00:00Z — only tasks due at or after it.
string
ISO 8601 timestamp — only tasks due at or before it.
string
One of chat, review, report or task — with linked_id, only tasks that link to that item. Send both or neither.
string
The linked item’s UUID. For linked_type=task, a display id like #123 also works.
string
A matter id — only tasks filed in this matter. See List matters.
boolean
default:"false"
Only tasks filed in no matter.
string
Pagination cursor from a previous response.
string
Page size, 1–100. Defaults to 20. Values below 1 are rejected.