update_work_item_links
Update suspect or revision flags on an existing work item link. Clear a suspect flag after review or pin a link to a specific revision.
Instructions
Update suspect / revision on one existing outgoing work item link.
Use this to clear a suspect flag after a reviewer signs off, or to
pin a link to a specific revision. Identify the link first with
list_work_item_links(direction="forward"): the role and target
work item ID together address one specific link.
suspect and revision are tri-state: an explicit True /
False / string value updates that attribute, while None (the
default) leaves the existing server-side value alone. This differs
from create_work_item_links where suspect defaults to False
(a concrete value). At least one of suspect / revision must be
provided -- passing both as None is rejected because Polarion
would 400 on the resulting empty PATCH body.
To update multiple links, call this tool once per link. Unlike
create_work_item_links / delete_work_item_links, the PATCH
endpoint has no server-side bulk equivalent.
Polarion does not validate link role ids server-side, so a typo in
role returns 404 -- the link simply does not exist under that role.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | Source work item's project ID. | |
| work_item_id | Yes | Source work item ID (the link's outgoing endpoint). | |
| role | Yes | Link role id of the existing link. | |
| target_work_item_id | Yes | Target work item ID (the link's incoming endpoint). | |
| target_project_id | No | Target's project; defaults to the source's project. | |
| suspect | No | New suspect flag value; None leaves it unchanged. | |
| revision | No | New revision pin; None leaves the existing pin unchanged. | |
| dry_run | No | When True, return payload preview without calling Polarion. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| updated | Yes | True on a real PATCH; False on dry-run. | |
| dry_run | Yes | Whether this was a dry-run. | |
| link_id | Yes | Composite 5-segment id computed from inputs. | |
| payload_preview | Yes | JSON:API PATCH body; None after real ops. |