list_work_item_links
List a work item's traceability links in either forward (outgoing) or back (incoming) direction, including suspect status.
Instructions
List a work item's outgoing or incoming links.
A single call returns one direction; call twice (direction="forward"
then direction="back") when both sides of the traceability graph are
needed. Forward links use the /linkedworkitems endpoint and expose
the originating role (e.g. parent, relates_to, verifies).
Back links fall back to a linkedWorkItems: Lucene query that does
not surface the originating role on this server, so role is None
for every back-direction item — recover it by calling forward on the
source work item.
The suspect flag marks links whose target has changed since the
link was last reviewed; it is only meaningful in the forward direction.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | Polarion project ID. | |
| work_item_id | Yes | Work Item ID (e.g. 'MCPT-001'). | |
| direction | No | 'forward' (outgoing) or 'back' (incoming); call twice if both needed. | forward |
| page_size | No | Number of links per page (1-100, default 100). | |
| page_number | No | Page number to retrieve (1-based, default 1). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | ||
| total_count | Yes | ||
| page | Yes | ||
| page_size | Yes | ||
| has_more | No | True if more pages follow. |