create_work_item_links
Atomically create 1-50 outgoing links from a source work item, validating roles and targets, with optional revision and suspect flags.
Instructions
Create 1-50 outgoing links from one source work item, atomically.
Role and target existence are validated before writing. Per spec: target_project_id defaults to the source, revision pins (else HEAD), suspect flags re-review. A duplicate role+target rolls back the whole batch — re-query list_work_item_links before retrying. link_ids are the delete-path ids, input order.
Phantom success: a document-attached source already has an auto-created heading link; a NEW same-role link reports created but is NOT persisted — verify with list_work_item_links.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"project_id": "<project_id>",
"work_item_id": "<work_item_id>",
"links": "<links>"
},
"name": "create_work_item_links"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| links | Yes | Links to create under the source work item (1-50). | |
| dry_run | No | Preview payload without writing; guards still query Polarion. | |
| project_id | Yes | Source work item's project ID. | |
| work_item_id | Yes | Source work item ID. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| created | Yes | ||
| dry_run | Yes | ||
| link_ids | No | ||
| payload_preview | No |