Skip to main content

Delete Work Item

Deletes the specified work item and sends it to the Recycle Bin, so that it can be restored back, if required. Optionally, if the destroy parameter has been set to true, it destroys the work item permanently. WARNING: If the destroy parameter is set to true, work items deleted by this command will NOT go to recycle-bin and there is no way to restore/recover them after deletion. It is recommended NOT to use this parameter. If you do, please use this parameter with extreme caution.

External Documentation

To learn more, visit the Azure DevOps documentation.

Basic Parameters

ParameterDescription
IDID of the Work Item to be deleted. You can get the Work Item ID using the List Work Items IDs action.
OrganizationThe Azure DevOps Organization. You can view the Organizations list in the Azure DevOps Organizations page.
ProjectThe Project ID or Project name. You can view the Projects list in the Azure DevOps Projects page.

Advanced Parameters

ParameterDescription
Permanently DeleteOptional parameter, if set to true, the work item is deleted permanently. Please note: the destroy action is PERMANENT and cannot be undone.

Example Output

{
"code": 0,
"deletedBy": "The user who deleted the work item type.",
"deletedDate": "The work item deletion date.",
"id": 0,
"message": "The exception message for work item operation in a batch request.",
"name": "Name or title of the work item.",
"project": "Parent project of the deleted work item.",
"type": "Type of work item.",
"url": "REST API URL of the resource"
}

Workflow Library Example

Delete Work Item with Azure Devops and Send Results Via Email

Workflow LibraryPreview this Workflow on desktop