Delete task status
Soft deletes a task status from the workspace.
How soft delete works:
- The status is marked as deleted but not permanently removed
- Existing tasks using this status retain the status reference
- The status no longer appears in status lists or can be assigned to new tasks
- The status can potentially be restored if needed
Important considerations:
- The status will be removed from all task types where it was assigned
- Tasks currently using this status will keep the status but it will not be available for new assignments
- This action should be used carefully as it affects workflows
Note: Consider updating tasks to use a different status before deleting if you want to maintain workflow continuity.
DELETE
/administration/task-settings/statuses/{id}Authorization
AuthorizationOAuth2 access token · headerrequiredScopes:
api:writeor
AuthorizationBearer token (JWT) · headerrequiredPath parameters
idstringrequiredResponses
200
Task status deleted successfully
successboolean401
Unauthorized - Invalid or missing authentication token
403
Forbidden - Insufficient API scopes or permissions