Deletes a single task template by its unique identifier. Task templates are reusable task definitions that
can be instantiated into actual tasks. Deleting a template does not affect tasks already created from it.
The operation can optionally cascade to child templates when recursive mode is enabled. This is an
asynchronous operation that returns an operation ID for tracking the deletion progress.
Key Features:
- Delete individual task templates by their unique ID for targeted template management
- Removes template definition and all its metadata including associations and custom properties
- Does not affect existing tasks that were created from the deleted template
- Supports recursive deletion to remove template hierarchies including all child templates
- Returns async operation ID for tracking deletion progress and completion
- Maintains audit trail of template deletion actions for compliance
- Validates permissions and ownership before performing deletion
Authorization Logic:
- User must have a valid JWT token with management scopes
- User must have program update permissions
- User must have permission to manage the specified task template
- When recursive=true, user must have permission for all child templates in the hierarchy
Usage Example:
Delete a specific outdated task template that is no longer needed in your workflow library, such as removing
an old "Product Launch Checklist" template after creating an updated version. Use recursive=true when deleting a parent template that has child sub-task templates and you want to remove the entire template hierarchy.
Existing tasks created from this template remain unaffected and continue to function normally.