Send a test notification through an alert's channels.
Fires one synthetic notification so you can check a channel is actually
wired up. It touches no state: nothing is opened or resolved, no issue is
stored, and the synthetic_incident_id in the response belongs to no row —
do not try to fetch it.
Post the editor’s current channels to test edits you have not saved yet;
with no body, the alert’s saved channels are used. An empty email channel
falls back to the organization’s default recipients, exactly as a real
notification would. Delivery is best-effort: 200 means the fan-out ran, not
that every channel accepted it.
Authorizations
A scoped AgentEye API key. Mint one in the dashboard under Settings → API keys, or with POST /v1/keys. Each endpoint names the permission it requires; a key without it gets 403 and a required_permission field naming what was missing.
Path Parameters
The alert's id.
Body
Optional. Omit the body to use the alert's saved channels.
The editor's CURRENT (possibly-unsaved) channels. When present and a
JSON array, the test fans out to these instead of the alert's saved
channels, so "test" matches what the operator has selected/entered and
resolves recipients identically to a save (an empty email channel still
falls back to the org default recipients). Same shape as
alert_definitions.channels.
Response
Fan-out ran; returns ok and a throwaway synthetic_incident_id.