Skip to content
Console
On this page

List webhook deliveries

Lists webhook deliveries.

Lists webhook deliveries.

  • Path GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/webhook_endpoints/webhook-endpoint/webhook_deliveries
  • Scope events:read
  • Effect read — nothing is written.
  • Collection webhook_deliveries
  • Query page_size, page_token, filter, order_by
  • Pagination the answer carries webhook_deliveries and, when there is more, next_page_token

Request

FieldTypeWhat it is
parentstringThe parent to list in. Required.
page_sizeint32At most this many; default 50, clamped to 1000.
page_tokenstringnext_page_token of the previous page.
filterstringAIP-160 filter over labels and filterable fields.
order_bystringAIP-132 ordering over filterable fields.

Response

FieldTypeWhat it is
webhook_deliveriesWebhookDelivery[]The page.
next_page_tokenstringThe token of the next page; empty on the last page.

WebhookDelivery

FieldTypeWhat it is
namestringorgs/{org}/projects/{project}/envs/{env}/webhook_endpoints/{webhook_endpoint}/webhook_deliveries/{webhook_delivery}.
uidstringwhd_<cell><ulid>; never reused. Output only.
metaResourceMetaResource metadata.
eventstringThe retained Event delivered. Unset when its admission environment is unknown, differs from the endpoint's environment, or the Event is gone. Output only.
subscriptionstringThe sole retained Subscription association. Unset when zero or multiple Subscriptions share this delivery; use subscriptions for the complete set. Output only.
stateDeliveryStateThe delivery state. Output only. One of pending, delivered, dead_lettered, cancelled.
attemptsDeliveryAttempt[]Every attempt, oldest first. Output only.
next_attempt_timetimestampWhen the next attempt is due. Output only.
event_typestringThe CloudEvents type of the event delivered. Output only.
subscriptionsstring[]Every retained Subscription association in the endpoint's environment, ordered by resource name. Direct and test deliveries can have none. Output only.

ResourceMeta

FieldTypeWhat it is
generationint64Increases by one on every change to spec. Output only.
etagstringStrong ETag (AIP-154): changes on any change to spec, status, or metadata. Send it back as If-Match or etag to make Update and Delete conditional; a mismatch fails with ABORTED / 409 ETAG_MISMATCH. Output only.
create_timetimestampWhen the Resource was created. Output only.
update_timetimestampWhen the Resource last changed. Output only.
delete_timetimestampSet while the Resource is being deleted. Output only.
labelsmap<string, string>Caller-writable, indexed labels (AIP-122 label rules).
annotationsmap<string, string>Caller-writable, unindexed annotations.
display_namestringCaller-writable human-readable name.
creatorstringThe principal that created the Resource. Output only.

DeliveryAttempt

FieldTypeWhat it is
attempt_numberint32The attempt number, from 1. Output only.
outcomeDeliveryAttemptOutcomeHow the attempt ended. Output only. One of delivered, retryable_failure, terminal_failure, ambiguous.
http_statusint32The endpoint's HTTP status, when it answered. Output only.
error_codestringA machine-readable failure code. Output only.
start_timetimestampWhen the attempt started. Output only.
end_timetimestampWhen the attempt ended. Output only.
evidence_digeststringsha256:<hex> of the recorded response evidence. Output only.

Errors

Every error arrives in the body Errors describes.

Examples

curl "https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/webhook_endpoints/webhook-endpoint/webhook_deliveries" \
  -H "Authorization: Bearer $SYLPHX_API_KEY"