---
title: "Tag löschen"
description: "Löscht einen Tag und entfernt ihn von allen Monitoren, denen er zugewiesen war. Nur der Ersteller oder ein Admin darf löschen."
---

`DELETE /api/tags/{id}`

Pfadparameter `{id}` ist die numerische `id` des Tags.

Das Löschen eines Tags kaskadiert: Alle Monitor-Tag-Zuweisungen für diesen Tag werden automatisch ebenfalls entfernt.

## Beispiel (cURL)

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

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

## Antwort (Response)

Gibt `204 No Content` bei Erfolg zurück.

## Häufige Fehler

- `401 Unauthorized` wenn du nicht angemeldet bist
- `403 Forbidden` wenn du nicht der Ersteller des Tags oder ein Admin bist
- `404 Not Found` wenn der Tag nicht existiert oder für dich nicht sichtbar ist