---
title: "Incident löschen (nur manuell)"
description: "Löscht einen manuell erstellten (Statusseiten-)Incident. Vom Monitoring erzeugte Incidents können nicht gelöscht werden."
---

`DELETE /api/incidents/:id`

Löscht einen **manuellen** Incident (eine von einem Admin erstellte Statusseiten-Ankündigung) samt seiner Timeline-Updates. Vom Monitoring erzeugte Incidents gehören den Workern und können niemals gelöscht werden — der Endpunkt lehnt sie mit `403 notManualIncident` ab.

## Authentifizierung

Erfordert eine gültige Session mit Editor-/Admin-Rechten, eingeschränkt auf den Kunden des Incidents.

- Header: `Authorization: Bearer <token>`

## Pfad-Parameter

- `id` (erforderlich): Die numerische ID des Incidents oder seine `publicId` (UUID).

## Beispiel (cURL)

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

curl -X DELETE "$BASE_URL/api/incidents/8d1f0c2e-6a2b-4f1e-9b7c-2e5a1d3c4b5a" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"
```

## Antwort

```json
{
  "ok": true
}
```

## Häufige Fehler

- `400 Incident id is required` wenn keine ID übergeben wird
- `401 Unauthorized` wenn du nicht angemeldet bist
- `403 Forbidden` wenn du keine Schreibrechte für den Kunden des Incidents hast
- `403 Only manual incidents can be deleted` (`data.code: notManualIncident`) wenn der Incident vom Monitoring erzeugt wurde
- `404 Incident not found` wenn kein Incident zur ID passt