Webhooks

List deliveries

The newest hundred deliveries to this subscription, newest first, each with its state, its attempt count and the status or one-line error of its newest attempt. Finished deliveries are kept until seven days after they were queued; pending ones are kept until they finish. This is where an exhausted delivery shows up — nothing is dropped silently.

Requires the viewer role or higher.

get/webhooks/{id}/deliveries

Request

  • Base URL: https://app.mandala.computer/api/v1
  • URL: https://app.mandala.computer/api/v1/webhooks/{id}/deliveries
  • Auth: HTTP bearer

Path parameters

idstring required

The webhook id.

Response

The deliveries, newest first.

idstring required

whd- and sixteen hex characters: the webhook-id header this delivery carried, fixed across attempts.

event_typestring required

The event’s type. gap for a gap frame; webhook.test for a test delivery.

computerstring required

The computer the event is about. Empty on a test delivery.

cursorstring required

The event’s own cursor — what to add as since= to the computer’s events_url to read on from it. Two kinds of delivery carry something else, which is not a socket position and must not be sent as since=: a test delivery’s is test: and its delivery id, and an event that arrived without a cursor of its own is keyed body: and a hash of its bytes.

state'pending' | 'in_flight' | 'delivered' | 'exhausted' | 'dropped' required

pending (an attempt is scheduled), in_flight (one is running), delivered (a 2xx came back), exhausted (eight attempts failed) or dropped (the subscription was disabled or deleted first).

attemptsinteger required

How many times it has been sent. Eight is the last.

next_atstring nullable required

When the next attempt is due, RFC 3339. null once the delivery is finished.

attempted_atstring nullable required

When the newest attempt started. null before the first.

last_statusinteger nullable required

The HTTP status of the newest attempt, or null when it got no answer.

last_errorstring nullable required

One line about the newest failure, for example timeout, dns, refused, reset, unreachable, tls, redirect, address refused or status NNN; other values are possible. A dropped delivery says why it was dropped. null after a success and before any attempt.

delivered_atstring nullable required

When the 2xx came back. null otherwise.

created_atstring required

RFC 3339 timestamp: when the event reached the queue.

Changes

No recorded changes to this operation across all 1 revision of this API.