---
search:
  tags:
    - tags
    - DELETE
seo:
  description: >-
    Soft deletes a tag and automatically removes it from all associated…
    Reference for the DELETE /tags/{type}/{id} endpoint in the Leadtime Public
    API API.
sidebar:
  badge: DELETE
  label: Soft delete a tag
title: Soft delete a tag
type: openapi-operation
---
Soft deletes a tag and automatically removes it from all associated entities (tasks, projects, components, or documentation pages). The tag is marked as deleted but not permanently removed from the database.

**How soft deletion works:**
- The tag is marked as deleted (isDeleted flag set to true)
- The tag is automatically removed from all entities that were using it
- Tasks, projects, or components will no longer show this tag
- The tag will not appear in list endpoints
- Historical data is preserved (the tag still exists in the database)

**Use cases:**
- Remove tags that are no longer needed
- Clean up duplicate or incorrectly named tags
- Archive tags that are no longer in use

**Note:** Soft deletion means the tag can potentially be restored if needed, but this endpoint does not provide restoration functionality.

**Permission requirements:**
- Task tags: Requires Tasks.manageTags permission
- Project tags: Must be an employee (not organization member)
- Project component tags: Requires ProjectComponentsLibrary.edit OR Projects.manageComponents permission
- Project documentation tags: Requires Projects.manageDocumentation permission

<Operation source="api-reference" id="tagscontroller-delete" />