search_tasks

search_tasks

Search across tasks the authenticated user has access to. A user has access to a task if they created it, are assigned to it, or are a member of a non-archived list the task is attached to. Soft-deleted tasks and tasks reachable only through archived lists are never returned. Filters compose with AND; array filters match any of the supplied values.

Input

Field	Type	Required	Description
query	string	no	Free-text title filter (case-insensitive substring match).
limit	number	no	Max results to return. Integer between 1 and 1000. Defaults to 1000.
isCompleted	boolean	no	true returns only completed tasks; false returns only non-completed. Omit to return both.
taskListIds	array of number	no	Match any of these task list IDs. Use list_task_lists to discover them.
assigneeIds	array of string	no	Match any of these assignee user IDs.
taskStatusIds	array of number	no	Match any of these status IDs. Use list_task_statuses to discover them.
priorities	array of string	no	Each value is one of low, medium, high, urgent.
dueDateFrom	string	no	Inclusive lower bound for dueDate (ISO YYYY-MM-DD).
dueDateTo	string	no	Inclusive upper bound for dueDate (ISO YYYY-MM-DD).

Example call

{
  "query": "onboarding",
  "limit": 100,
  "isCompleted": false,
  "taskListIds": [12, 19],
  "priorities": ["high", "urgent"],
  "dueDateFrom": "2026-05-01",
  "dueDateTo": "2026-05-31"
}

Output

A single text content block containing a JSON array of task summaries. The shape matches the OpenAPI List tasks response.

Field	Type	Description
id	number	Numeric ID of the task.
title	string	Task title.
number	number	Auto-incrementing task number within the team.
priority	string | null	One of low, medium, high, urgent, or null.
dueDate	string | null	ISO 8601 date the task is due, or null.
parentId	number | null	Parent task ID if this is a subtask, otherwise null.
createdAt	string	ISO 8601 timestamp the task was created.
updatedAt	string	ISO 8601 timestamp of the last update.
isCompleted	boolean	true if the task’s status is in a completed state.
status	object	Current status of the task — see below.
status.id	number	Numeric ID of the status.
status.name	string	Display name of the status.
assignees	array of objects	Users currently assigned. May be empty.
assignees[].id	string	User ID (UUID).
assignees[].name	string	User’s display name.
assignees[].email	string	User’s email address.
taskLists	array of objects	Lists this task is attached to. May be empty.
taskLists[].id	number	Numeric ID of the list.
taskLists[].name	string	Display name of the list.

Example output

[
  {
    "id": 421,
    "title": "Wire up onboarding email",
    "number": 87,
    "priority": "high",
    "dueDate": "2026-05-12",
    "parentId": null,
    "createdAt": "2026-05-01T09:14:22.000Z",
    "updatedAt": "2026-05-08T11:02:08.000Z",
    "isCompleted": false,
    "status": { "id": 3, "name": "In progress" },
    "assignees": [
      { "id": "u_abc123", "name": "Tom", "email": "tom@example.com" }
    ],
    "taskLists": [
      { "id": 12, "name": "Marketing site" }
    ]
  }
]