list-work-item-linked-items-tool

Returns the related work items linked to a work item — issue links such as blocks, is blocked by, duplicates, relates to, and split to — across both link directions. Each entry carries the human-readable relationship and the linked work item with its type and workflow status.

The direction is forward for links that start on this work item (e.g. this item blocks another) and inverse for links that point at it (e.g. this item is blocked by another). The relationship label already reflects the direction, so it reads naturally from the perspective of the requested work item.

Inputs

Name	Type	Required	Description
`work_item_key`	string	yes	Issue 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": [
    {
      "link_id": 88,
      "direction": "forward",
      "relationship": "Blocks",
      "work_item": {
        "id": 63,
        "issue_key": "ACM-155",
        "title": "Release the checkout rework",
        "work_type": { "id": 5, "name": "Task", "icon": "check", "color": "#3b82f6" },
        "workflow_status": { "id": 11, "name": "To do", "color": "#94a3b8", "is_resolution": false }
      }
    },
    {
      "link_id": 90,
      "direction": "inverse",
      "relationship": "Is blocked by",
      "work_item": {
        "id": 40,
        "issue_key": "ACM-118",
        "title": "Finalise the Stripe account migration",
        "work_type": { "id": 6, "name": "Bug", "icon": "bug", "color": "#ef4444" },
        "workflow_status": { "id": 13, "name": "Done", "color": "#22c55e", "is_resolution": true }
      }
    }
  ],
  "total": 2
}

Errors

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