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
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"'