Skip to main content

Delivery Attempt

The delivery attempt is a read-only audit record that is created when we attempt to delivery an event to an endpoint. The delivery attempt is created when the event is sent to the endpoint and is updated when the endpoint responds to the event. The delivery attempt is created with the status of "Pending" and is updated to "Success", "Failure", or "Cancelled" when the endpoint responds to the event.

Configuration

There are no configurable attributes as the record is read-only and can only be updated by the system.

Attributes

AttributeTypeDescription
idstringThe unique identifier of the delivery attempt.
event_idstringThe unique identifier of the event.
endpoint_idstringThe unique identifier of the endpoint.
endpoint_urlstringThe endpoint URL at the time of delivery.
statusstringThe status of the delivery attempt.
responsestringThe HTTP response body returned by the endpoint.
response_status_codeintegerThe HTTP response code returned by the endpoint.
response_headersJSONThe HTTP response headers returned by the endpoint.
attempted_atDateTimeThe date and time the delivery attempt was made.
scheduled_atDateTimeThe date and time the event delivery will be attempted.

Endpoint URL

This is the URL of the endpoint at the time of delivery. If the endpoint URL is updated after the event is sent, the endpoint URL will not be updated in the delivery attempt.

Status

The status of the delivery attempt can be one of the following:

StatusEnumDescription
pending2The delivery attempt is pending.
success0The delivery attempt was successful.
failure1The delivery attempt failed.
canceled3The delivery attempt was cancelled. This can happen if the event is deleted.

Entity relations

A delivery attempt has several relations to other entities:

Endpoint

A delivery attempt is always associated with an endpoint.

Event

A delivery attempt is always associated with an event.