Relancer une livraison webhook

POST /v1/webhook-endpoints/{endpoint_id}/deliveries/{delivery_id}:retry · autorisation webhook-endpoints:write · tous les forfaits

Remet en file d'attente une livraison succeeded ou abandoned des 30 derniers jours sous forme de nouvelle livraison du même événement, et renvoie la nouvelle livraison. La nouvelle livraison conserve le webhook-id de l'événement et a un replay_no supérieur de un. Une livraison encore pending ou retrying est relancée par le planning et ne peut pas être relancée manuellement. Le corps est facultatif ; s'il est fourni, il s'agit d'un objet vide.

Requête

Champ Type Obligatoire Description
endpoint_id path oui ID du point de terminaison webhook (whe_…).
delivery_id path oui ID de la livraison (whd_…).
Idempotency-Key header non Rejoue la réponse pour une requête répétée avec la même clé, sans remettre en file d'attente.

Réponse

200 OK avec la nouvelle livraison.

{
  "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
}

Erreurs

HTTP code Quand
400 unknown_field Le corps n'est pas un objet vide.
404 not_found Aucun point de terminaison ou aucune livraison de ce type dans cet environnement.
409 conflict La livraison est pending ou retrying, date de plus de 30 jours, ou le point de terminaison n'est pas enabled.
401 unauthenticated L'identifiant est absent, invalide ou révoqué.
403 insufficient_permissions L'identifiant ne dispose pas de webhook-endpoints:write.
503 service_unavailable L'administration des webhooks est temporairement indisponible ; réessayez après la durée indiquée par Retry-After.

Exemple

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