v5

latestOpenAPI 3.1.02026-08-081,0211,3082.1 MB
ALERTS_V1

Test Notification

Send a test notification using a draft rule config.

Runs the same evaluator + chart pipeline as a real alert against real ClickHouse data, then dispatches via the chosen notifier (email / slack / webhook). Hard-fails on validation or chart-generation errors; returns 200 with {ok: false, error} for delivery failures.

Rate limited to 10 requests/minute per tenant.

post/api/v1/alerts/notifications/test

Request body

namestring nullable
rule_typestring
platformstring nullable
entity_typestring required
alert_messagestring nullable
reference_timestring date-time nullable

Evaluate as if 'now' were this timestamp (ISO-8601). Defaults to UTC now.

Response

Successful Response

okboolean required
targetstring required

Channel type — 'email', 'slack', or 'webhook'

chart_urlstring nullable
errorstring nullable