deleteWorkItem

Contents

This mutation deletes an existing work item.

Query

deleteWorkItem (WorkItemDeleteResponse!)
Deletes a single work item.

When a work item is deleted, its descendants at all levels are also deleted. For safety, this mutation will not delete work items with more than 1000 descendants. This is an attempt to prevent the case where a typo accidentally causes the enterprise’s top-level item to get deleted. Changes of that magnitude should be performed by a user, who can confirm they are correct.

Argument Type Description
app String! The api name of the app to delete the work item from.
type String! The template api name of the item to delete.
id ID! The id of the item to delete.

Example

mutation {
  deleteWorkItem(
    app: "App_1__app"
    type: "Program__t"
    id: "1") {
    deleteCount
  }
}
{
  "data": {
    "deleteWorkItem": {
      "deleteCount": 500
    }
  }
}
Updated on September 9, 2025

Related Articles