Skip to main content
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 DocumentationTo 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

{
	"id": 161,
	"type": "<string>",
	"name": "<string>",
	"project": "<string>",
	"deletedDate": "<string>",
	"deletedBy": "<string>",
	"code": 337,
	"url": "<string>",
	"resource": {
		"id": 804,
		"rev": 609,
		"fields": {
			"System.AreaPath": "<string>",
			"System.TeamProject": "<string>",
			"System.IterationPath": "<string>",
			"System.WorkItemType": "<string>",
			"System.State": "<string>",
			"System.Reason": "<string>",
			"System.CreatedDate": "2024-03-06T22:10:14",
			"System.CreatedBy": "<string>",
			"System.ChangedDate": "2023-04-16T05:59:16",
			"System.ChangedBy": "<string>",
			"System.CommentCount": 424,
			"System.Title": "<string>",
			"Microsoft.VSTS.Common.StateChangeDate": "2022-10-18T17:25:44",
			"Microsoft.VSTS.Common.Priority": 792,
			"System.Description": "<string>",
			"System.Tags": "<string>"
		},
		"_links": {
			"self": {
				"href": "<string>"
			},
			"workItemType": {
				"href": "<string>"
			},
			"fields": {
				"href": "<string>"
			}
		},
		"url": "<string>"
	}
}

​
Workflow Library Example

Delete Work Item with Azure Devops and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop
⌘I