ts.tsk.list

Query tasks with filters.

Query tasks with filters.

Requires authentication

Description

Lists tasks with optional filtering and pagination.

Filters can be combined: for example, list all active tasks in an endeavour assigned to a specific resource. Text search matches against title and description.

Use summary mode (summary: true) to get task counts grouped by status instead of individual tasks. This is useful for a quick backlog overview.

Parameters

NameTypeRequiredDefaultDescription
statusstringFilter by status: planned, active, done, canceled
endeavour_idstringFilter by endeavour
assignee_idstringFilter by assignee resource
searchstringSearch in title and description (partial match)
limitinteger50Maximum number of results to return
offsetinteger0Number of results to skip (for pagination)
summarybooleanfalseIf true, return status counts instead of individual tasks

Response

Returns a paginated list of tasks, or status counts when summary is true.

{
  "limit": 50,
  "offset": 0,
  "tasks": [
    {
      "assignee_id": "res_claude",
      "assignee_name": "Claude",
      "created_at": "2026-02-06T13:37:12Z",
      "endeavour_id": "edv_bd159eb7bb9a877a...",
      "id": "tsk_68e9623ade9b1631...",
      "status": "planned",
      "title": "Implement demand MCP tools",
      "updated_at": "2026-02-06T13:37:12Z"
    }
  ],
  "total": 1
}

Errors

CodeDescription
not_authenticatedNo active login for this session. Call ts.auth.login first.

Examples

Summary by status

Get a quick overview of task counts grouped by status.

Request:

{
  "endeavour_id": "edv_bd159eb7bb9a877a...",
  "summary": true
}

Response:

{
  "summary": {
    "active": 1,
    "canceled": 0,
    "done": 10,
    "planned": 5
  },
  "total": 16
}

List tasks by endeavour

Get all tasks belonging to an endeavour.

Request:

{
  "endeavour_id": "edv_bd159eb7bb9a877a..."
}

Response:

{
  "limit": 50,
  "offset": 0,
  "tasks": [
    {
      "id": "tsk_68e9623ade9b1631...",
      "status": "planned",
      "title": "Implement demand MCP tools"
    }
  ],
  "total": 1
}

List active tasks assigned to a resource

Find tasks currently being worked on by a specific agent.

Request:

{
  "assignee_id": "res_claude",
  "status": "active"
}

Response:

{
  "limit": 50,
  "offset": 0,
  "tasks": [
    {
      "assignee_id": "res_claude",
      "assignee_name": "Claude",
      "id": "tsk_55c1a70b3e18cdde...",
      "status": "active",
      "title": "Vertical slice implementation"
    }
  ],
  "total": 1
}