Query
webhookDeliveries
Paginate webhook deliveries (dead-letter surface) for the current workspace, newest first. Filter by subscription and/or status. History is retained for 30 days.
Arguments
Object, input and enum types open in place — use + to reveal their fields. A type that is already open above the row stops at a ↻ circular marker, and anything nested past the depth limit links out to its own page instead.
- after String default null
- Cursor for fetching the next page of results.
- filter WebhookDeliveryFilterInput default {}
- Filter criteria. Optionally narrow by subscription and/or status.
- status WebhookDeliveryStatus default null
- Only return deliveries in this status.
- DELIVERING
- Currently being delivered (claimed for one attempt).
- DROPPED
- Dropped without delivery by backpressure (backlog cap reached) or rate-limiting (per-subscription events/sec bucket exhausted). Not retried; the business event remains in the outbox (webhookEvents). Never used for auto-disable.
- FAILED
- The attempt failed. Terminal failures are redeliverable.
- PENDING
- Queued or scheduled for a (re)attempt.
- SUCCEEDED
- Delivered successfully (endpoint returned a 2xx).
- subscriptionId ID default null
- Only return deliveries for this subscription. A foreign id yields an empty page.
- first Int default 20
- Number of deliveries to return (page size).
Returns
A paginated connection of WebhookDelivery nodes. See Pagination for the connection shape.
- edges [WebhookDeliveryEdge!]!
- List of edges with cursors.
- cursor String!
- Cursor for this node.
- node WebhookDelivery!
- The webhook delivery.
- 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 about 44.6h nominal (up to about 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).
- DELIVERING
- Currently being delivered (claimed for one attempt).
- DROPPED
- Dropped without delivery by backpressure (backlog cap reached) or rate-limiting (per-subscription events/sec bucket exhausted). Not retried; the business event remains in the outbox (webhookEvents). Never used for auto-disable.
- FAILED
- The attempt failed. Terminal failures are redeliverable.
- PENDING
- Queued or scheduled for a (re)attempt.
- SUCCEEDED
- Delivered successfully (endpoint returned a 2xx).
- subscriptionId ID!
- ID of the subscription this delivery belongs to.
- updatedAt DateTimeWithZone!
- When the delivery was last updated.
- nodes [WebhookDelivery!]!
- List of webhook deliveries.
- 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 about 44.6h nominal (up to about 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).
- DELIVERING
- Currently being delivered (claimed for one attempt).
- DROPPED
- Dropped without delivery by backpressure (backlog cap reached) or rate-limiting (per-subscription events/sec bucket exhausted). Not retried; the business event remains in the outbox (webhookEvents). Never used for auto-disable.
- FAILED
- The attempt failed. Terminal failures are redeliverable.
- PENDING
- Queued or scheduled for a (re)attempt.
- SUCCEEDED
- Delivered successfully (endpoint returned a 2xx).
- subscriptionId ID!
- ID of the subscription this delivery belongs to.
- updatedAt DateTimeWithZone!
- When the delivery was last updated.
- pageInfo PageInfo!
- Pagination information.
- endCursor String
- Cursor for the last node in this page.
- hasNextPage Boolean!
- Whether there are more results after this page.
- hasPreviousPage Boolean!
- Whether there are results before this page.
- startCursor String
- Cursor for the first node in this page.
- totalCount Int
- Total number of items available.