Retry a delivery
Queues the delivery for an immediate attempt, regardless of its state (failed, canceled,
succeeded or pending), except while an attempt is in flight (delivering), which returns
409. The attempt counter continues from its current value, the same event (same webhook-id) is
sent to the endpoint’s current URL with its current secret, and the delivery is marked
manual: true, so it does not affect endpoint health. A delivery that has used all 12 attempts
receives one additional attempt, with no further automatic retries if it fails. If the endpoint is
disabled when the attempt runs, the delivery is canceled (endpoint_disabled).
Side effects. Sets the delivery back to pending, due immediately; the dispatcher sends it within seconds.
Idempotency. Repeating the call while the first retry is still pending leaves a single pending attempt. Once that attempt has run, a new call queues another.
Access
- Required scope:
full. Human users need the owner or admin role. - Rate limit: General API (120–600 requests/min per workspace, by plan) plus the configuration-mutations limit — 10 requests/min per workspace, shared with other configuration changes. See Rate limits.
- Plan: Requires an active subscription (
active,trialingorpast_due); without one the request is refused with403 BILLING_ERROR(metadata.kind: subscription_required). See Billing and usage.
Authentication
Workspace API key: jl_ followed by 64 lowercase hex characters, created by the workspace owner in the
dashboard (Settings → API Keys) and sent as Authorization: Bearer jl_.... The plaintext is shown once,
at creation; Jelliu stores only a SHA-256 hash. A workspace can hold up to 25 active keys.
Operations restricted to admins or owners reject keys without the full scope with 403, and say so in
their description. No key, whatever its scope, can mint or revoke API keys or rotate a webhook secret —
that requires a signed-in owner session. A revoked key stops authenticating within about 10 seconds.
See Authentication.
Path parameters
Id of a webhook delivery (dlv_ plus 26 characters), as returned in id by GET /api/webhooks/{webhookId}/deliveries and sent in the x-jelliu-delivery-id header. A delivery of another workspace, an unknown id or a value that is not a delivery id answers 404.