Project workspace

list-work-item-children-tool

List the child work items (sub-issues) of a work item.

Returns the child work items (sub-issues) of a work item — real work items linked to the parent through their parent_id, each with its own issue key. Rows are ordered by board position and match the shape returned by list-work-items-tool.

These are distinct from checklist subtasks: child work items are full work items you can transition, comment on, and link, while subtasks are lightweight to-do rows.

Inputs

NameTypeRequiredDescription
work_item_keystringyesIssue key of the parent 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": 51,
      "issue_key": "ACM-140",
      "title": "Swap the payment intents endpoint",
      "priority": "high",
      "due_date": "2026-06-01",
      "estimation": 120,
      "order": 1,
      "sprint_id": 7,
      "version": 2,
      "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://…" }
      }
    }
  ],
  "total": 1
}

Errors

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

On this page