Eine Webhook-Zustellung erneut versuchen

POST /v1/webhook-endpoints/{endpoint_id}/deliveries/{delivery_id}:retry · Berechtigung webhook-endpoints:write · alle Tarife

Stellt eine succeeded- oder abandoned-Zustellung der letzten 30 Tage als neue Zustellung desselben Ereignisses erneut in die Warteschlange und gibt die neue Zustellung zurück. Die neue Zustellung behält die webhook-id des Ereignisses, und ihr replay_no ist um eins höher. Eine Zustellung, die noch pending oder retrying ist, wird vom Zeitplan erneut versucht und kann nicht manuell erneut versucht werden. Der Anfragetext ist optional; falls angegeben, ist er ein leeres Objekt.

Anfrage

Feld Typ Pflichtangabe Beschreibung
endpoint_id path ja Webhook-Endpunkt-ID (whe_…).
delivery_id path ja Zustellungs-ID (whd_…).
Idempotency-Key header nein Gibt die Antwort für eine wiederholte Anfrage mit demselben Schlüssel zurück, ohne erneut in die Warteschlange zu stellen.

Antwort

200 OK mit der neuen Zustellung.

{
  "id": "whd_01k8a3m9t1w3x5y7z9b2c4d6f8",
  "endpoint_id": "whe_01k8a3m5q7t9v1w3x5y7z9b2c4",
  "event_id": "evt_01k8a3m7s9v1w3x5y7z9b2c4d6",
  "event_seq": 1042,
  "event_type": "user.created",
  "replay_no": 1,
  "status": "pending",
  "attempt_count": 0,
  "next_attempt_at": "2026-10-26T10:00:00Z",
  "last_http_status": null,
  "last_error_class": null,
  "last_latency_ms": null,
  "created_at": "2026-10-26T10:00:00Z",
  "completed_at": null
}

Fehler

HTTP code Wann
400 unknown_field Der Anfragetext ist kein leeres Objekt.
404 not_found Dieser Endpunkt oder diese Zustellung existiert in dieser Umgebung nicht.
409 conflict Die Zustellung ist pending oder retrying, älter als 30 Tage, oder der Endpunkt ist nicht enabled.
401 unauthenticated Die Anmeldedaten fehlen, sind ungültig oder wurden widerrufen.
403 insufficient_permissions Die Anmeldedaten haben nicht die Berechtigung webhook-endpoints:write.
503 service_unavailable Die Webhook-Verwaltung ist vorübergehend nicht verfügbar; wiederholen Sie die Anfrage nach Ablauf von Retry-After.

Beispiel

curl -X POST https://api.eu.keenauth.com/v1/webhook-endpoints/whe_01k8a3m5q7t9v1w3x5y7z9b2c4/deliveries/whd_01k8a3m6r8t0v2w4x6y8z0b3d5:retry \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Idempotency-Key: 9c3e5a7b-1d4f-4b6a-8e0c-2d4f6a8c0e2b"

CLI: keenauth webhook-endpoints deliveries retry whe_01k8a3m5q7t9v1w3x5y7z9b2c4 whd_01k8a3m6r8t0v2w4x6y8z0b3d5