---
title: "Delete Tag"
description: "Deletes a tag and removes it from all monitors it was assigned to. Only the tag owner or an admin may delete a tag."
---

`DELETE /api/tags/{id}`

Path parameter `{id}` is the tag's numeric `id`.

Deleting a tag cascades: all monitor-tag assignments for that tag are also removed automatically.

## Example (cURL)

```bash
BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"
TAG_ID=1

curl -X DELETE "$BASE_URL/api/tags/$TAG_ID" \
  -H "Authorization: Bearer $TOKEN"
```

## Response

Returns `204 No Content` on success.

## Common errors

- `401 Unauthorized` when you are not logged in
- `403 Forbidden` when you are not the tag owner or an admin
- `404 Not Found` when the tag does not exist or is not visible to you