---
search:
  tags:
    - administration
    - DELETE
seo:
  description: >-
    Soft deletes a task status from the workspace. Reference for the DELETE
    /administration/task-settings/statuses/{id} endpoint in the Leadtime Public
    API API.
sidebar:
  badge: DELETE
  label: Delete task status
title: Delete task status
type: openapi-operation
---
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.

<Operation source="api-reference" id="tasksettingscontroller-deletetaskstatus" />