Skip to main content
POST
Send an alert to the DevOps employee
Use an API key whose role is Owner, Admin or Editor: it needs agent.update, and an Editor key is the least it takes. Any other role is refused with 403. The employee only ever proposes: a person decides, and a remediation is never run. The same service and title again within the hour files nothing more. Past your organisation’s limit for the day nothing is filed and the answer says so.
AI employees are in beta. Every route answers 404 unless your deployment has switched the beta on, and these routes need a second switch, off by default. See Work that arrives by itself. No real Grafana has sent one of these yet.

Body

string
required
The service it is about. Letters, digits, dots, dashes and underscores.
string
required
What the alert is.
string
A short word, such as critical or warning.

From Grafana

Or send a Grafana alert webhook’s own body: point a webhook contact point at this address and put the key in its authorization header credentials. From each alert in alerts, this reads status, the labels alertname, severity and the first of service, service_name, app, job, and the annotation summary. Nothing else in it is read, and no URL in it is followed. A resolved alert files nothing. At most 10 alerts are filed per request.

Response

object[]
required
One per alert: service, title, status and task_id. status is filed, repeat (task_id is the work already filed) or over_limit.
object
required
How many were not filed: resolved, no_service and over_request_limit.
Last modified on November 4, 2026