Archive API docs
esc
    Jump to
    Getting started Token, first query, response Explorer Run queries in the browser items The connection most integrations start with Changelog Additions and deprecations

    Narrow by kind with a prefix — q: queries, m: mutations, t: types, g: guides, f: fields and arguments.

    Object

    WebhookDelivery

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

    Fields

    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.

    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.
    eventType String
    Event type of the delivered event, e.g. content_view.item_added, operation.completed, or a system type such as subscription.ping. Null only when the event row is no longer retained (events are pruned after 30 days).
    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, for 2xx and non-2xx responses alike. Null when that attempt got no HTTP response (timeout or connection error) or before the first attempt.
    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.