Delete a task template

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:

  1. User must have a valid JWT token with management scopes
  2. User must have program update permissions
  3. User must have permission to manage the specified task template
  4. 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.

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".

string
required

Unique identifier of the specific task template to delete. Must be a valid template ID in base64url-encoded or GUID format (example: zK95yNV8rok6PXteVFyKTi) corresponding to an existing task template within the specified space. This parameter targets the exact template definition you want to remove from your template library. Obtain template IDs from template listing endpoints, template creation responses, or template selection interfaces. The template must exist in the specified space and the authenticated user must have delete permissions for it. Deleting a template removes its definition and metadata but does not affect tasks already created from it - those tasks remain intact and continue functioning normally. Required for all task template deletion operations.

Query Params
boolean
Defaults to false

Optional boolean flag indicating whether to cascade the deletion operation to include all child templates in the template hierarchy. When set to true, the system deletes the specified parent template along with all its child sub-task templates and their descendants, removing the entire template hierarchy. When set to false or omitted (default behavior), only the specified template is deleted and any child templates remain intact. Use recursive=true when removing outdated template hierarchies that are no longer needed, such as deleting a master 'Product Launch' template along with all its sub-task templates like 'Marketing Setup', 'Content Creation', 'Sales Enablement'. Requires delete permissions for all affected templates in the hierarchy. Set to false when you want to preserve child templates for potential reuse with other parent templates. Must be a proper boolean value (true/false), not a string.

Responses

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