Tasks
List tasks
List and filter tasks you have access to.
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
A user id, email address, name, or
me for the caller — tasks this person is involved in at all (assignee, creator or shared).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.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.One of
chat, review, report or task — with linked_id, only tasks that link to that item. Send both or neither.A matter id — only tasks filed in this matter. See List matters.