Project workspace

list-work-item-subtasks-tool

List the checklist subtasks of a work item.

Returns the checklist subtasks of a work item — lightweight to-do items with a title, an optional description, and a resolved flag — ordered by position. These are the "Subtasks" shown on the work item detail panel.

Subtasks are not work items: they have no issue key and cannot be transitioned or linked. For child work items (sub-issues) use list-work-item-children-tool instead.

Inputs

NameTypeRequiredDescription
work_item_keystringyesIssue key of the work item (e.g. ACM-123).

Permissions

  • project_management::view_backlog.

Example

{
  "work_item_key": "ACM-123"
}

Response

{
  "work_item": { "id": 42, "issue_key": "ACM-123", "title": "Stripe SDK upgrade" },
  "data": [
    {
      "id": 301,
      "title": "Write the migration",
      "description": "Add the new columns behind a feature flag.",
      "is_resolved": true,
      "order": 1
    },
    {
      "id": 302,
      "title": "Add the tests",
      "description": null,
      "is_resolved": false,
      "order": 2
    }
  ],
  "total": 2
}

Errors

  • An unknown work_item_key returns a validation error.
  • A caller without project_management::view_backlog receives an authorization error.

On this page