Archive API docs

Object

WebhookDelivery

One delivery attempt lifecycle for a (webhook event, subscription) pair. Surfaces the dead-letter / observability state for a subscription.

Fields

attemptCount Int!
Lifetime number of attempts made (also the backoff-ladder index). The ladder is 8 attempts total — one immediate try plus backoffs at 1m/5m/30m/2h/6h/12h/24h (±20% jitter), spanning ≈44.6h nominal (up to ~53.5h with max jitter).
createdAt DateTimeWithZone!
When the delivery was created.
eventId ID!
ID of the webhook event being delivered.
id ID!
Unique identifier of the delivery.
lastAttemptAt DateTimeWithZone
When the most recent attempt was made. Null before the first attempt.
lastError String
Error message from the most recent failed attempt. Null on success.
lastResponseStatus Int
HTTP status of the most recent attempt. Null for transport-level failures.
nextAttemptAt DateTimeWithZone
When the next attempt is scheduled. Null when terminal (exhausted or dropped, no retry queued). Pushed to the cooldown while the endpoint host circuit breaker is open (deferred, not failed).
responseTimeMs Int
Round-trip time of the most recent attempt in milliseconds.
status WebhookDeliveryStatus!
Current status of this delivery attempt. FAILED is retried on the backoff ladder until terminal (then redeliverable); DROPPED is backpressure/rate-limit and is never retried (recover via webhookEvents).
subscriptionId ID!
ID of the subscription this delivery belongs to.
updatedAt DateTimeWithZone!
When the delivery was last updated.