Skip to content
Leadtime
English
Esc
navigateopen⌘Jpreview

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 · headerrequired
Scopes:api:write
or
AuthorizationBearer token (JWT) · headerrequired
Path parameters
idstringrequired
Responses
200Task status deleted successfully
successboolean
401Unauthorized - Invalid or missing authentication token
403Forbidden - Insufficient API scopes or permissions
Request
curl -X DELETE "https://leadtime.app/api/public/administration/task-settings/statuses/string" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Response
{
  "success": true
}