Delete tasks

Deletes multiple tasks from the space in a single bulk operation. The deletion can optionally cascade to
child tasks when recursive mode is enabled. This endpoint performs asynchronous deletion and returns
operation IDs for tracking the deletion progress. Deleted tasks are permanently removed from the system
along with their metadata, associations, and custom properties.

Key Features:

  • Efficiently deletes multiple tasks in a single API call for batch operations
  • Supports recursive deletion to remove entire task hierarchies including all child tasks
  • Removes tasks and all their metadata including custom properties, associations, and comments
  • Returns async operation IDs for tracking deletion progress and results
  • Maintains audit trail of all task deletion actions for compliance and tracking
  • Processes deletions asynchronously for better performance with large batches
  • Does not affect programs or other entities associated with the deleted tasks

Authorization Logic:

  1. User must have a valid JWT token with management scopes
  2. User must have permission to delete all specified tasks
  3. Program update permissions may be required based on tenant configuration

Usage Example:

Delete multiple completed tasks to clean up the workspace after program completion, or remove cancelled
tasks that are no longer needed. For example, bulk delete all tasks associated with a cancelled marketing
campaign, or remove obsolete tasks during workspace reorganization. When recursive=true, deleting a parent
task will also remove all its subtasks automatically.

Path Params
string
required
length between 7 and 22

The unique identifier of the space containing the target entity. This determines the scope of entity queries and ensures proper access control. The space must be accessible to the authenticated user with appropriate permissions. It can be the unique identifier (GUID) of the space or the word "default" to indicate the default programs space. Common values include "default" and "rkr83lapKkyCJuLLWqLqzB".

Body Params
ids
array of strings

Array of task or task template identifiers to be deleted in this bulk operation. Each ID must be a valid stable string identifier in base64url format (e.g., yT97zSH8tnz8OWxeVFzKTj). Provide between 1 and 100 IDs per request for optimal performance. All specified tasks must exist and the authenticated user must have delete permissions for each task. Used to target specific tasks for permanent removal from the workspace.

ids
boolean | null

Controls whether the deletion operation cascades to remove all descendant subtasks in the task hierarchy. When true, deleting a parent task will also permanently delete all nested child tasks and their subtasks recursively. When false or omitted, only the specified tasks are deleted while preserving their children as orphaned tasks. Use true for complete cleanup of task trees, false for selective parent removal during hierarchy restructuring.

Responses

Language
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json