# Delete tag

Remove a tag definition when unused.

Source: https://statusdashboard.com/docs/api/subscriptions/segments/tags-delete

`DELETE /app/segments/tags/{tagId}`

Deletes a tag only when it has no registry members and is not referenced by a segment. Requires the **Segments** plan feature and admin role.

***

## Path parameters
| Parameter | Type | Description   |
| --------- | ---- | ------------- |
| `tagId`   | uuid | Tag to delete |

***

## Request
See [API Basics](/docs/api) for required headers.

***

## Sample request
```bash
curl -X DELETE https://api.statusdashboard.com/app/segments/tags/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer bcf847abf5c6:def456"
```

## Sample response
**Status: `204 No Content`**

No response body.

***

## Error responses
| Status | When                                                    |
| ------ | ------------------------------------------------------- |
| `403`  | Not admin or feature not enabled.                       |
| `404`  | Tag not found.                                          |
| `409`  | Tag has registry members or is referenced by a segment. |