Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Look up a delivery Beta

GET/api/v1/trigger-delivery/deliveries/{id}

This endpoint is in beta. Its request and response may change.

Finds one trigger event by an ID your server received: the message ID from the webhook-id header, or the event ID, which is the payload's dedupe_key. Returns the event's trigger, subscription and connection, and every attempt to deliver it to each of your endpoints, oldest first. The event's payload isn't returned.

This page as markdownTriggers overview

Authorization

Authorization: Bearer $TOKEN, an access token from the client credentials grant. See Authentication.

Path parameters

idstringrequired
The message ID (msg_..., the webhook-id header) or the event ID (the payload's dedupe_key).

Response 200

attemptsarray of object
The event's delivery attempts to every endpoint in this environment, oldest first. Each names the endpoint_id and endpoint_url it was sent to.
Show 11 child attributes
endpoint_idstring
ID of the endpoint this attempt was made against.
endpoint_urlstring
URL this attempt was sent to.
idstring
ID of this delivery attempt.
msg_idstring
ID of the trigger event message this attempt delivered. Every attempt to deliver the same event shares this ID.
responsestring
Response body the endpoint returned for this attempt. A long body may be truncated.
response_duration_msinteger
How long the endpoint took to respond to this attempt, in milliseconds.
response_status_codeinteger
HTTP status code the endpoint returned for this attempt.
response_truncatedboolean
True when response was cut to its first 4096 bytes. Set only by List the attempts for a delivery and Look up a delivery, which apply that cap.
statusstring (enum)
Whether this attempt succeeded, is still in flight, failed, or was canceled. A failed delivery is retried, so FAIL on one attempt does not mean the event was never delivered — check the newest attempt for that message.
SUCCESSPENDINGFAILSENDINGCANCELED
timestampstring
When this attempt was made.
trigger_typestring (enum)
Why this attempt was made: TRIGGER_DELIVERY_ATTEMPT_TRIGGER_TYPE_SCHEDULED for the first attempt or an automatic retry, TRIGGER_DELIVERY_ATTEMPT_TRIGGER_TYPE_MANUAL for a retry someone started by hand.
TRIGGER_DELIVERY_ATTEMPT_TRIGGER_TYPE_SCHEDULEDTRIGGER_DELIVERY_ATTEMPT_TRIGGER_TYPE_MANUAL
connection_idstring
ID of the connection the event came from. Present even after the connection is deleted. Empty when the event carries none.
connection_key_idstring
Name of the connection the event came from, the value other AgentKit endpoints take as connector. Empty when the connection no longer exists.
connection_providerstring
Provider of the connection the event came from. Empty when the connection no longer exists.
event_idstring
Event ID of the event: the payload's dedupe_key and correlation_id. Empty when the event was sent without one.
message_timestampstring
When the event was accepted for delivery.
msg_idstring
Message ID of the event, sent to each endpoint as the webhook-id header.
subscription_idstring
ID of the trigger subscription that sent the event. Present even after the subscription is deleted. Empty when the event carries none.
trigger_modestring (enum)
How the trigger detects events, from the newest version of its definition: WEBHOOK or POLL. TRIGGER_MODE_UNSPECIFIED when the subscription or the definition no longer exists.
WEBHOOKPOLL
trigger_namestring
Key of the trigger that fired, as the subscription was created with. Empty when the subscription no longer exists.
truncatedboolean
True when the event has more than the 50 attempts returned. The newest 50 are returned, so the earliest attempts are missing when this is true.

Errors

Every error has the same body: code, message and details. See Errors and rate limits.

400Invalid request - id is empty, longer than 256 characters, contains characters other than letters, digits, ., _ and -, or is an attempt ID (atmpt_)
404Not found - no trigger event with this message ID or event ID exists in this environment (error_code NOT_FOUND), or Triggers isn't turned on for your environment (error_code RESOURCE_NOT_FOUND)
429Too many requests - deliveries are being read too often. Retry shortly; the request is not retried on your behalf
500Internal error - the delivery could not be looked up; retry the request