RevKeen Docs
Api reference

Retry a webhook delivery

Queue an immediate retry of this delivery. The delivery is marked pending and next_retry_at is set to now; the dispatcher picks it up on its next tick. Calling retry on an already-pending delivery just advances its retry time. Dead-lettered deliveries can be retried once; succeeded deliveries cannot.

Related endpoints

  • GET /webhook-deliveries — List webhook deliveries
  • GET /webhook-deliveries/{id} — Retrieve a webhook delivery

Common errors

  • 404 resource_missing — the referenced resource does not exist or is not visible to your key.
  • 409 conflict — Idempotency-Key collision with a different body, or a concurrent state-transition conflict.

Idempotency

Pass an Idempotency-Key header (UUID v4 recommended) to make retries safe. Keys are valid for 24 hours; see the idempotency guide.

POST
/webhook-deliveries/{id}/retry

Authorization

x-api-key<token>

Your RevKeen API key (powered by Unkey). Get it from Dashboard > Settings > API Keys. Use rk_sandbox_* for test mode and rk_live_* for production.

In: header

Path Parameters

id*string

Webhook delivery ID

Formatuuid

Response Body

application/json

application/json

application/json

curl -X POST "https://api.revkeen.com/v2/webhook-deliveries/00000000-0000-0000-0000-000000000000/retry" \  -H "x-api-key: $REVKEEN_API_KEY"
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "object": "webhook_delivery",
    "endpoint_id": "7c1cbf21-0b6c-4c27-9d60-8a9f0a7e6d91",
    "event_id": "1f8d9e0b-3a2e-4d9a-b0fe-1c2a3f4d5e6f",
    "event_type": "invoice.paid",
    "status": "pending",
    "attempts": 2,
    "max_attempts": 8,
    "last_status_code": 502,
    "last_error": "connect ETIMEDOUT",
    "last_error_code": "ETIMEDOUT",
    "last_duration_ms": 1532,
    "last_attempt_at": "2019-08-24T14:15:22Z",
    "next_retry_at": "2019-08-24T14:15:22Z",
    "delivered_at": "2019-08-24T14:15:22Z",
    "dead_lettered_at": "2019-08-24T14:15:22Z",
    "dead_letter_reason": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
Edit on GitHub