Retry a webhook delivery

POST /v1/webhook-endpoints/{endpoint_id}/deliveries/{delivery_id}:retry · permission webhook-endpoints:write · all plans

Queues a succeeded or abandoned delivery of the last 30 days again as a new delivery of the same event and returns the new delivery. The new delivery keeps the event's webhook-id and has replay_no one higher. A delivery that is still pending or retrying is retried by the schedule and cannot be retried by hand. The body is optional; when given it is an empty object.

Request

Field Type Required Description
endpoint_id path yes Webhook endpoint ID (whe_…).
delivery_id path yes Delivery ID (whd_…).
Idempotency-Key header no Replays the response for a repeated request with the same key, without queueing again.

Response

200 OK with the new delivery.

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

Errors

HTTP code When
400 unknown_field The body is not an empty object.
404 not_found No such endpoint or delivery in this environment.
409 conflict The delivery is pending or retrying, older than 30 days, or the endpoint is not enabled.
401 unauthenticated The credential is missing, invalid or revoked.
403 insufficient_permissions The credential lacks webhook-endpoints:write.
503 service_unavailable Webhook administration is temporarily unavailable; retry after the Retry-After period.

Example

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