deleteLinkedWorkItem
Deletes a single direct outgoing Work Item link in Polarion by role and target ID; set dry_run to preview the irreversible removal without affecting backlinks or external links.
Instructions
Deletes the direct outgoing links to other Work Items. (The same as the corresponding Java API method.) Does not pertain to external links or backlinks. Cardinality: targets a single item by ID. For the full collection or a batch, use deleteLinkedWorkItems instead. Effect: irreversible — data removed or overwritten by this call cannot be recovered through the API. Tip: set dry_run: true first to validate the arguments and preview the exact request without sending it to Polarion. The executor returns this preview as normal text, and as structured content when the tool declares an output schema.
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": {
"projectId": "<projectId>",
"workItemId": "<workItemId>",
"roleId": "<roleId>",
"targetProjectId": "<targetProjectId>",
"linkedWorkItemId": "<linkedWorkItemId>"
},
"name": "deleteLinkedWorkItem"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| roleId | Yes | The Role ID. | |
| dry_run | No | If true, validates the request and returns the exact request that would be sent to Polarion — with the Authorization header redacted and any binary payload summarized by byte length — without actually sending it. | |
| projectId | Yes | The Polarion project ID (its URL segment, e.g. `myproject`), case-sensitive. Required to scope the request to one project. If the ID is unknown, ask the user; getProjects lists IDs only with global read access. | |
| workItemId | Yes | The Work Item's ID within its project (e.g. `WI-123`), not the combined `project/id` path used in some link payloads. | |
| targetProjectId | Yes | The Target Project ID. | |
| linkedWorkItemId | Yes | The Linked Work Item ID. |