API referenceWebhooks

Redrive a single failed webhook delivery

Re-attempts one previously-unsuccessful delivery (status failed or exhausted) to this endpoint, reconstructing the event byte-for-byte from the [event ledger](/events/event-ledger) with the same X-Dairo-Event-Id, so consumer-side dedupe stays exact and a redrive never changes the payload.

Endpoint
POST https://api.dairo.app/v1/webhooks/{webhook}/deliveries/{delivery}/redrive

Re-attempts one previously-unsuccessful delivery (status failed or exhausted) to this endpoint, reconstructing the event byte-for-byte from the event ledger with the same X-Dairo-Event-Id, so consumer-side dedupe stays exact and a redrive never changes the payload. A delivery that already succeeded (delivered), is still pending, or is a synthetic webhook.ping cannot be redriven and returns 422 — check the row's redrivable flag first. If the original event has aged out of the ledger, the call returns 404. The response reports delivered (true only on a 2xx response). Rate limited to 60 redrives per hour; requires the webhooks:write scope.

Scope: webhooks:write. Send the API key as a bearer token; Scopes lists what each one reaches.

Request

cURL
curl -X POST "https://api.dairo.app/v1/webhooks/webhook/deliveries/delivery/redrive" \
  -H "Authorization: Bearer $DAIRO_API_KEY"

Path parameters

NameTypeRequiredDescription
webhookstringyesThe webhook's ID.
deliverystringyes

Response

200 Success. Body: application/json, object.

200
{}

Errors

Every error has the same body, {"error": {"type", "code", "message", "param"}}; branch on code. Errors lists every code.

StatusMeaning
400The request is malformed or a value is invalid (invalid_request, invalid_domain, idempotency_key_mismatch).
401The API key is missing or invalid.
403The key lacks the scope this endpoint needs (scope_missing) or may not do this (not_permitted).
404No such resource in this account (resource_not_found).
429Rate limit, plan limit, budget or spend cap reached (rate_limited, plan_limit_reached, budget_exceeded, spend_cap_reached).
500An unexpected error; retry with backoff, then contact support (internal_error).

On this page