Skip to main content
POST
cURL
Use this endpoint to retry a delivery whose status is dead_letter. It returns the delivery in the same format as Webhook deliveries. Re-enabling an endpoint through Update a webhook does not resend failed events. Use this route for individual deliveries or Event replay to recover recorded large-trade events.

Parameters

What the requeue changes

The resend is sent to the endpoint’s current url and signed with its current secret, not the ones in use when the delivery first failed.

Retry schedule

The wait after each failure is capped at the value below, and the 8th failure returns the delivery to dead_letter. Webhook deliveries explains how each wait is chosen, how a Retry-After from your server changes it, and what each retry_schedule_reason value means.

Example

Handle a 409 or a 422

What it does not do

  • Find the delivery for you. Take delivery_id from Webhook deliveries.
  • Requeue in bulk. It is one call per delivery, so for a long gap catch up from Event replay instead.
  • Reach a row that retention deleted. delivered and dead_letter rows are kept for 7 days, after which the delivery_id returns 404.
  • Answer anything but 404 for an endpoint or a delivery you do not own. That is the same answer as an id that never existed.

Authorizations

Authorization
string
header
required

Legacy default or named integration API key, or OAuth 2.1 access token, in the Authorization header as Bearer oxi_sk_live_... or Bearer oxi_at_.... Default keys retain full access; integration keys are limited to their approved read, webhooks, export and usage scopes and expire within 90 days. All credentials share the owner's account limits. 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

X-Query-Validation
enum<string>

Opt into strict query-name validation. The default is compatible: unknown names are ignored and reported in X-Query-Ignored. With strict, an unknown name returns 400 bad_request with error.reason unknown_query_parameter before the handler runs, including when its percent escape is incomplete.

Available options:
strict
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