List alert delivery history

GET

/api/v1/alert-rules/deliveries

const url = 'http://localhost:3000/api/v1/alert-rules/deliveries';
const options = {method: 'GET', headers: {'X-API-Key': '<X-API-Key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url http://localhost:3000/api/v1/alert-rules/deliveries \
  --header 'X-API-Key: <X-API-Key>'

Alert occurrences with their fired/resolved timestamps and delivery outcome, newest first. Optionally filtered by rule or device.

Authorizations

api-key
bearer

Parameters

Query Parameters

ruleId

string format: uuid

deviceId

string format: uuid

limit

string

Default 50, maximum 200

offset

string

Responses

200

application/json

object

items

required

Array<object>

object

required

string format: uuid

ruleId

required

string format: uuid

ruleName

required

string

deviceId

object

notificationTargetId

required

string format: uuid

notificationTargetName

required

string

channel

required

string

state

required

string

Allowed values: OPEN RESOLVED

firedAt

required

string format: date-time

resolvedAt

object

deliveredAt

When the transport confirmed delivery. Null while pending or failed.

object

error

Transport failure detail after the retry budget was exhausted.

object

total

required

Total matching records, ignoring limit/offset

number

Example

{
  "items": [
    {
      "ruleName": "CPU above 80% on edge nodes",
      "notificationTargetName": "Ops on-call email",
      "channel": "EMAIL",
      "state": "OPEN"
    }
  ],
  "total": 128
}