Skip to content

Recent alert history

GET
/api/v1/alerts/history
curl --request GET \
--url https://example.com/api/v1/alerts/history \
--header 'Authorization: <Authorization>'

Returns the most recent dispatched alerts, newest first, capped at 500.

limit
integer

Maximum rows (default 100, max 500)

OK

Media typeapplication/json
Array<object>
object
channel_id
integer
channel_name
string
created_at
string
detail

Detail is the rendered match context (bounded at match time).

string
entity

Entity is what matched: a hostname, a query name, or “node” for inactive/recovered rules. Part of the Redis dedupe key.

string
environment
string
id
integer
node_uuid
string
rule_id

RuleID / ChannelID are denormalized as uint rather than FKs so deleting a rule or channel does not cascade-delete history.

integer
rule_name
string
Examplegenerated
[
{
"channel_id": 1,
"channel_name": "example",
"created_at": "example",
"detail": "example",
"entity": "example",
"environment": "example",
"id": 1,
"node_uuid": "example",
"rule_id": 1,
"rule_name": "example"
}
]

Unauthorized

Media typeapplication/json
object
code
string
error
string
Examplegenerated
{
"code": "example",
"error": "example"
}

Forbidden

Media typeapplication/json
object
code
string
error
string
Examplegenerated
{
"code": "example",
"error": "example"
}

Alerts disabled

Media typeapplication/json
object
code
string
error
string
Examplegenerated
{
"code": "example",
"error": "example"
}