Alerts
Enterprise

List Alert Attempts

Changed on

Returns a paginated list of alert delivery attempts. Composite-key filters (alert_id, channel_id, event_id) compose to support per-alert, per-webhook, per-event, and single-row views.

get/api/v2/alert-attempts

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v2/alert-attempts
  • Auth: one of:
    • HTTP bearer
    • API key in header Authorization and API key in header RequestDate and API key in header Signature

Query parameters

skipinteger

The number of items to skip in a paginated response.

This query parameter is used for determining the number of objects to skip in pagination.

limitinteger

The limit of results requested by the client.

This query parameter is used for setting an upper limit of objects returned in paginated responses.

sort_bystring

Sort by column. Can be used multiple times; prepend a hyphen for descending order. See parameter description for details about which columns are sortable.

Sortable columns are created_at, succeeded_at, next_attempt_at, attempts. Default -created_at (most recent first).

alert_idstring

Filter results by column string-formatted uuid value. Valid filter predicates are eq, neq.

channel_idstring

Filter results by column string-formatted uuid value. Valid filter predicates are eq, neq.

event_idstring

Filter results by column string-formatted uuid value. Valid filter predicates are eq, neq.

succeededstring

Filter results by column boolean value. Valid filter predicates are eq, neq.

When set to true, returns only rows with succeeded_at IS NOT NULL.

created_atstring

Filter results by column timestamp value formatted as an RFC-3339 string. Valid filter predicates are eq, neq, gt, gte, lt, lte.

Filter results by created_at value. See filter schema details for valid predicates.

Response

OK

countinteger

The total number of results.

skipinteger

The number of items to skip in a paginated response.

limitinteger

The limit of results requested by the client.

Changes