list-work-items-tool

List work items for a project, optionally scoped to a sprint or the backlog, with rich filters.

Returns cursor-paginated row snapshots that match the backlog row shape used by the in-app backlog view. When sprint_id is omitted the result is the project's backlog (items not in any sprint).

Inputs

Name	Type	Required	Description
`project_id`	integer	yes	Project to list work items for.
`sprint_id`	integer	no	Sprint to scope to. Omit (or pass null) to list the backlog.
`search`	string	no	Substring match against title or issue key (case-insensitive).
`priorities`	array of strings	no	E.g. `["highest", "high", "medium"]`.
`work_type_ids`	array of integers	no	Keep only these work types.
`workflow_status_ids`	array of integers	no	Keep only these workflow statuses.
`deadline_ids`	array of integers	no	Keep only items linked to these deadlines.
`assignee_user_ids`	array of integers	no	Filter by deadline owner (proxy for assignee).
`hide_resolved`	boolean	no	When true, exclude items whose workflow status is a resolution.
`cursor`	string	no	Cursor from a previous response's `next_cursor`.
`per_page`	integer	no	Page size, 1–100. Default 50.

Permissions

project_management::view_backlog covers any sprint or the backlog.
project_management::view_active_sprint covers requests scoped to the currently active sprint of the project.

Example

{
  "project_id": 3,
  "sprint_id": 7,
  "hide_resolved": true,
  "per_page": 25
}

Response

{
  "data": [
    {
      "id": 42,
      "issue_key": "ACM-123",
      "title": "Stripe SDK upgrade",
      "priority": "high",
      "due_date": "2026-06-01",
      "estimation": 240,
      "order": 1,
      "sprint_id": 7,
      "version": 7,
      "work_type": { "id": 5, "name": "Task", "icon": "check", "color": "#3b82f6" },
      "workflow_status": { "id": 12, "name": "In progress", "color": "#fbbf24", "is_resolution": false },
      "deadline": { "id": 21, "description": "Launch v2", "user": { "id": 18, "name": "Pia Nielsen", "email": "pia@example.com", "avatar_url": "https://…" } }
    }
  ],
  "pagination": { "per_page": 25, "next_cursor": null, "has_more": false, "total": 1 }
}

Errors

An unknown project_id or sprint_id returns a validation error.
A caller without either of the read permissions (or one with view_active_sprint scoping a non-active sprint) receives an authorization error.