# Webhook-Endpunkt löschen

`DELETE /v1/webhook-endpoints/{endpoint_id}` · Berechtigung `webhook-endpoints:write` · alle Tarife

Löscht einen Endpunkt. Seine ausstehenden und wiederholten Zustellungen werden in derselben Transaktion abgebrochen; der Zustellungsverlauf bleibt für seine 30-tägige Aufbewahrungsfrist erhalten. `If-Match` ist erforderlich; `*` löscht die jeweils gespeicherte Version.

## Anfrage

| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `endpoint_id` | path | ja | ID des Webhook-Endpunkts (`whe_…`). |
| `If-Match` | header | ja | Aktuelles `ETag` des Endpunkts oder `*`. |

## Antwort

`204 No Content`.

## Fehler

| HTTP | Code | Wann |
|---|---|---|
| 404 | `not_found` | Kein solcher Endpunkt in dieser Umgebung. |
| 412 | `precondition_failed` | `If-Match` stimmt nicht mit der aktuellen Version überein. |
| 428 | `precondition_required` | `If-Match` fehlt. |
| 401 | `unauthenticated` | Die Berechtigungsnachweise fehlen, sind ungültig oder widerrufen. |
| 403 | `insufficient_permissions` | Die Berechtigungsnachweise enthalten nicht `webhook-endpoints:write`. |
| 503 | `service_unavailable` | Die Verwaltung von Webhooks ist vorübergehend nicht verfügbar; wiederholen Sie die Anfrage nach der Zeit aus `Retry-After`. |

## Beispiel

```bash
curl -X DELETE https://api.eu.keenauth.com/v1/webhook-endpoints/whe_01k8a3m5q7t9v1w3x5y7z9b2c4 \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "3"'
```

CLI: `keenauth webhook-endpoints delete whe_01k8a3m5q7t9v1w3x5y7z9b2c4 --if-match '"3"'`