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
200Task status deleted successfully
successboolean401Unauthorized - 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"const response = await fetch("https://leadtime.app/api/public/administration/task-settings/statuses/string", {
method: "DELETE",
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
});import requests
response = requests.delete(
"https://leadtime.app/api/public/administration/task-settings/statuses/string",
headers={
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
},
)Response
{
"success": true
}Unauthorized - Invalid or missing authentication token
Forbidden - Insufficient API scopes or permissions