Delete work item
devops_work_item_deleteDelete an Azure DevOps work item by ID, moving it to the Recycle Bin for restoration or permanently destroying it when destroy is true.
Instructions
Delete a work item by ID. By default the item is sent to the Recycle Bin and can be restored. Set destroy=True to permanently destroy the item — WARNING: this is irreversible.
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": {
"work_item_id": "<work_item_id>"
},
"name": "devops_work_item_delete"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| destroy | No | If True, permanently destroys the work item (requires 'Permanently delete work items' permission in Project Settings → Security; if not enabled, the server returns 404). WARNING: permanent destruction cannot be undone. Defaults to False (moves to Recycle Bin). | |
| work_item_id | Yes | The numeric ID of the work item to delete. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |