Skip to main content
POST
cURL
Return one dead_letter delivery to the delivery queue with a fresh attempt budget. Use it after a failed delivery exhausts its retries, or after re-enabling an endpoint whose queued deliveries were dead-lettered while it was disabled.

What redelivery does

  • status becomes pending, attempt_count resets to 0, and next_attempt_at is now, so the delivery worker claims it like any queued delivery, under the same per-owner and per-origin concurrency limits.
  • The resend is signed with the endpoint’s current signing secret and sent to its current URL.
  • The delivery keeps its event_id and Idempotency-Key header, so a receiver that already processed the event can deduplicate it. x-0xinsider-delivery-attempt starts again at 1.
  • last_response_status and last_error keep the previous failure’s values until the next attempt records its own.
  • PATCH /api/v1/webhooks/{id} {"enabled": true} re-enables an endpoint but resends nothing by itself; redeliver each dead-lettered delivery you want retried.

Handle the 409

error.param names the cause.
  1. delivery_id: the delivery is already delivered, or still queued (pending, retry, or processing). Only a dead_letter delivery can be redelivered.
  2. endpoint: the endpoint would not receive it: disabled, not verified, or no longer subscribed to the delivery’s event_type. error.message names the fix.
  3. error.reason: "idempotency_in_progress": the same keyed request is still running.
404 covers an endpoint or delivery the caller does not own, including a delivery removed by the seven-day retention of delivered and dead_letter history. List Webhook Deliveries lists the deliveries this endpoint requeues.

Authorizations

Authorization
string
header
required

API key or OAuth 2.1 access token in the Authorization header as Bearer oxi_sk_live_... or Bearer oxi_at_.... Data calls require an active Pro subscription and return live data. A 401 carries WWW-Authenticate: Bearer resource_metadata="https://api.0xinsider.com/.well-known/oauth-protected-resource" (RFC 6750 section 3, RFC 9728).

Headers

Idempotency-Key
string

Optional safe-retry key. Reuse the same value only when retrying the exact same mutation request body; a different body returns 422 and an in-flight matching request returns 409.

Required string length: 1 - 255

Path Parameters

id
integer<int64>
required

Webhook endpoint id owned by the authenticated API key user.

delivery_id
integer<int64>
required

Delivery id from GET /api/v1/webhooks/{id}/deliveries. It must belong to the webhook endpoint named by id.

Response

The requeued delivery, in the same shape as one GET /api/v1/webhooks/{id}/deliveries row.

object
string
required
Allowed value: "webhook_delivery"
data
object
required

Owner-scoped view of one webhook delivery attempt. Deliberately omits the request body and the endpoint signing secret: a delivery log never re-exposes the payload or any secret material.

meta
object
required