Test Alert Rule
Queues a one-shot "test" notification on every channel configured for the rule. Lets you verify webhook signatures, email deliverability, and the rendered notification payload without waiting for a real threshold crossing.
The call returns 202 Accepted immediately; the alert-worker picks the request up on its next poll cycle and dispatches the test, then records a status:"test" row on the rule's events list. Allow up to ~30 seconds for delivery.
Path parameters
uuid string (uuid) Req
Alert rule UUID.
Errors
401 Unauthorized
Missing auth.
403 Forbidden
Plan doesn't include the
metric_alerts entitlement.404 Not Found
No rule with that UUID owned by the caller.
Request
curl -X POST "https://api.ngris.com/v1/traffic/alerts/<uuid>/test" \
-H "X-API-KEY: <your_api_key>"
Response — 202 Accepted
{
"status": "queued",
"message": "Test notification queued — should arrive on every configured channel within ~30 seconds."
}