Segments
Delete tag
Remove a tag definition when unused.
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 for required headers.
Sample request
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. |