Alerts and Notification Channels APIs

List of APIs to manage alerts and notification channels

Notification Channel APIs

Configure channel

post

/alerts/v1/notifications/create

Body

object

Example: {"manager":"grafana","name":"functional-metrics-email","type":"email","config":{"recipientAddresses":"[e-mail];[e-mail]","subject":"Obsrv Prod Alert"}}

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'http://localhost:3000/alerts/v1/notifications/create' \
  --header 'Content-Type: application/json' \
  --data '{"manager":"grafana","name":"functional-metrics-email","type":"email","config":{"recipientAddresses":"[e-mail];[e-mail]","subject":"Obsrv Prod Alert"}}'

200

200

No body

Successful response

Publish Channel

get

/alerts/v1/notifications/publish/{alert_id}

Path parameters

alert_idstringrequired

Unique identifier for the alert

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'http://localhost:3000/alerts/v1/notifications/publish/{alert_id}'

200

200

No body

Successful response

Search Notificaation Channels

post

/alerts/v1/notifications/search

Body

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'http://localhost:3000/alerts/v1/notifications/search'

200

200

No body

Successful response

Update Specific Channel

patch

/alerts/v1/notifications/update/{alert_id}

Path parameters

alert_idstringrequired

Unique identifier for the alert

Body

object

Example: {"name":"updated name"}

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PATCH \
  --url 'http://localhost:3000/alerts/v1/notifications/update/{alert_id}' \
  --header 'Content-Type: application/json' \
  --data '{"name":"updated name"}'

200

200

No body

Successful response

Delete Channel

delete

/alerts/v1/notifications/delete/{alert_id}

Path parameters

alert_idstringrequired

Unique identifier for the alert

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'http://localhost:3000/alerts/v1/notifications/delete/{alert_id}'

200

200

No body

Successful response

Verify Configured Channel

post

/alerts/v1/notifications/test

Body

object

Example: {"message":"Testing Email integration. If you can read this, it's working!","payload":{"manager":"grafana","name":"udhw","type":"email","error":{"selectChannel":true,"configureChannel":true},"config":{"recipientAddresses":"[e-mail]"}}}

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'http://localhost:3000/alerts/v1/notifications/test' \
  --header 'Content-Type: application/json' \
  --data '{"message":"Testing Email integration. If you can read this, it's working!","payload":{"manager":"grafana","name":"udhw","type":"email","error":{"selectChannel":true,"configureChannel":true},"config":{"recipientAddresses":"[e-mail]"}}}'

200

200

No body

Successful response

Alerts APIs

Add Rule

post

/alerts/v1/create

Header parameters

Acceptstring

Example: application/json, text/plain, */*

Accept-Languagestring

Example: en-GB,en

Cache-Controlstring

Example: no-store

Connectionstring

Example: keep-alive

Content-Typestring

Example: application/json

Cookiestring

Example: connect.sid=s%3A5w5I87Tior-cvNu-SijqRFKGxy_b-WIP.lDKfWAJZbxW0kMaUqj%2B0Ivu%2FvNXXL8S796Fa7%2BNyM9Q; grafana_session=4eb514f6fef4ad6884e47e50254af650; grafana_session_expiry=1687239735

Originstring

Example: http://localhost:3001

Pragmastring

Example: no-store

Refererstring

Example: http://localhost:3001/alertRules/add

Sec-Fetch-Deststring

Example: empty

Sec-Fetch-Modestring

Example: cors

Sec-Fetch-Sitestring

Example: same-origin

Sec-GPCinteger

Example: 1

User-Agentstring

Example: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36

Body

string

Example: "{\n \"name\": \"Total Api Calls1\",\n \"manager\":\"grafana\",\n \"description\": \"This alert is set up to notify you when the CPU usage on a host reaches a Low level.\",\n \"expression\": \"(node_total_api_calls) > 20\",\n \"category\": \"Infra\",\n \"severity\":\"warning\",\n \"frequency\": \"1m\",\n \"interval\": \"1m\",\n \"labels\": {\n \"component\": \"api\",\n \"notificationChannel\": \"slack\"\n },\n \"annotations\":{\n \"summary\":\"Host Low CPU usage\"\n },\n \"metadata\": {\n \"query\": [\n {\n \"refId\": \"A\",\n \"datasourceUid\": \"$datasourceUid\",\n \"queryType\": \"\",\n \"relativeTimeRange\": {\n \"from\": 600,\n \"to\": 0\n },\n \"model\": {\n \"refId\": \"A\",\n \"hide\": false,\n \"editorMode\": \"code\",\n \"expr\": \"node_total_api_calls\",\n \"legendFormat\": \"__auto\",\n \"range\": true\n }\n },\n {\n \"refId\": \"B\",\n \"datasourceUid\": \"__expr__\",\n \"queryType\": \"\",\n \"model\": {\n \"refId\": \"B\",\n \"hide\": false,\n \"type\": \"reduce\",\n \"datasource\": {\n \"uid\": \"__expr__\",\n \"type\": \"__expr__\"\n },\n \"conditions\": [\n {\n \"type\": \"query\",\n \"evaluator\": {\n \"params\": [],\n \"type\": \"gt\"\n },\n \"operator\": {\n \"type\": \"and\"\n },\n \"query\": {\n \"params\": [\n \"B\"\n ]\n },\n \"reducer\": {\n \"params\": [],\n \"type\": \"last\"\n }\n }\n ],\n \"reducer\": \"last\",\n \"expression\": \"A\"\n },\n \"relativeTimeRange\": {\n \"from\": 600,\n \"to\": 0\n }\n },\n {\n \"refId\": \"C\",\n \"datasourceUid\": \"__expr__\",\n \"queryType\": \"\",\n \"model\": {\n \"refId\": \"C\",\n \"hide\": false,\n \"type\": \"threshold\",\n \"datasource\": {\n \"uid\": \"__expr__\",\n \"type\": \"__expr__\"\n },\n \"conditions\": [\n {\n \"type\": \"query\",\n \"evaluator\": {\n \"params\": [\n 20\n ],\n \"type\": \"gt\"\n },\n \"operator\": {\n \"type\": \"and\"\n },\n \"query\": {\n \"params\": [\n \"C\"\n ]\n },\n \"reducer\": {\n \"params\": [],\n \"type\": \"last\"\n }\n }\n ],\n \"expression\": \"B\"\n },\n \"relativeTimeRange\": {\n \"from\": 600,\n \"to\": 0\n }\n }\n ]\n }\n}"

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'http://localhost:3000/alerts/v1/create' \
  --header 'Content-Type: */*' \
  --data '"\"{\\n    \\\"name\\\": \\\"Total Api Calls1\\\",\\n    \\\"manager\\\":\\\"grafana\\\",\\n    \\\"description\\\": \\\"This alert is set up to notify you when the CPU usage on a host reaches a Low level.\\\",\\n    \\\"expression\\\": \\\"(node_total_api_calls) > 20\\\",\\n    \\\"category\\\": \\\"Infra\\\",\\n    \\\"severity\\\":\\\"warning\\\",\\n    \\\"frequency\\\": \\\"1m\\\",\\n    \\\"interval\\\": \\\"1m\\\",\\n    \\\"labels\\\": {\\n        \\\"component\\\": \\\"api\\\",\\n        \\\"notificationChannel\\\": \\\"slack\\\"\\n    },\\n    \\\"annotations\\\":{\\n        \\\"summary\\\":\\\"Host Low CPU usage\\\"\\n    },\\n    \\\"metadata\\\": {\\n        \\\"query\\\": [\\n            {\\n                \\\"refId\\\": \\\"A\\\",\\n                \\\"datasourceUid\\\": \\\"$datasourceUid\\\",\\n                \\\"queryType\\\": \\\"\\\",\\n                \\\"relativeTimeRange\\\": {\\n                    \\\"from\\\": 600,\\n                    \\\"to\\\": 0\\n                },\\n                \\\"model\\\": {\\n                    \\\"refId\\\": \\\"A\\\",\\n                    \\\"hide\\\": false,\\n                    \\\"editorMode\\\": \\\"code\\\",\\n                    \\\"expr\\\": \\\"node_total_api_calls\\\",\\n                    \\\"legendFormat\\\": \\\"__auto\\\",\\n                    \\\"range\\\": true\\n                }\\n            },\\n            {\\n                \\\"refId\\\": \\\"B\\\",\\n                \\\"datasourceUid\\\": \\\"__expr__\\\",\\n                \\\"queryType\\\": \\\"\\\",\\n                \\\"model\\\": {\\n                    \\\"refId\\\": \\\"B\\\",\\n                    \\\"hide\\\": false,\\n                    \\\"type\\\": \\\"reduce\\\",\\n                    \\\"datasource\\\": {\\n                        \\\"uid\\\": \\\"__expr__\\\",\\n                        \\\"type\\\": \\\"__expr__\\\"\\n                    },\\n                    \\\"conditions\\\": [\\n                        {\\n                            \\\"type\\\": \\\"query\\\",\\n                            \\\"evaluator\\\": {\\n                                \\\"params\\\": [],\\n                                \\\"type\\\": \\\"gt\\\"\\n                            },\\n                            \\\"operator\\\": {\\n                                \\\"type\\\": \\\"and\\\"\\n                            },\\n                            \\\"query\\\": {\\n                                \\\"params\\\": [\\n                                    \\\"B\\\"\\n                                ]\\n                            },\\n                            \\\"reducer\\\": {\\n                                \\\"params\\\": [],\\n                                \\\"type\\\": \\\"last\\\"\\n                            }\\n                        }\\n                    ],\\n                    \\\"reducer\\\": \\\"last\\\",\\n                    \\\"expression\\\": \\\"A\\\"\\n                },\\n                \\\"relativeTimeRange\\\": {\\n                    \\\"from\\\": 600,\\n                    \\\"to\\\": 0\\n                }\\n            },\\n            {\\n                \\\"refId\\\": \\\"C\\\",\\n                \\\"datasourceUid\\\": \\\"__expr__\\\",\\n                \\\"queryType\\\": \\\"\\\",\\n                \\\"model\\\": {\\n                    \\\"refId\\\": \\\"C\\\",\\n                    \\\"hide\\\": false,\\n                    \\\"type\\\": \\\"threshold\\\",\\n                    \\\"datasource\\\": {\\n                        \\\"uid\\\": \\\"__expr__\\\",\\n                        \\\"type\\\": \\\"__expr__\\\"\\n                    },\\n                    \\\"conditions\\\": [\\n                        {\\n                            \\\"type\\\": \\\"query\\\",\\n                            \\\"evaluator\\\": {\\n                                \\\"params\\\": [\\n                                    20\\n                                ],\\n                                \\\"type\\\": \\\"gt\\\"\\n                            },\\n                            \\\"operator\\\": {\\n                                \\\"type\\\": \\\"and\\\"\\n                            },\\n                            \\\"query\\\": {\\n                                \\\"params\\\": [\\n                                    \\\"C\\\"\\n                                ]\\n                            },\\n                            \\\"reducer\\\": {\\n                                \\\"params\\\": [],\\n                                \\\"type\\\": \\\"last\\\"\\n                            }\\n                        }\\n                    ],\\n                    \\\"expression\\\": \\\"B\\\"\\n                },\\n                \\\"relativeTimeRange\\\": {\\n                    \\\"from\\\": 600,\\n                    \\\"to\\\": 0\\n                }\\n            }\\n        ]\\n    }\\n}\""'

200

200

No body

Successful response

Publish Alert Rules

get

/alerts/v1/publish/{alert_id}

Path parameters

alert_idstringrequired

Unique identifier for the alert

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'http://localhost:3000/alerts/v1/publish/{alert_id}'

200

200

No body

Successful response

Get Alert Rule

get

/alerts/v1/get/{alert_id}

Path parameters

alert_idstringrequired

Unique identifier for the alert

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'http://localhost:3000/alerts/v1/get/{alert_id}'

200

200

No body

Successful response

Search Alert Rule

post

/alerts/v1/search

Body

object

Example: {"request":{}}

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'http://localhost:3000/alerts/v1/search' \
  --header 'Content-Type: application/json' \
  --data '{"request":{}}'

200

200

No body

Successful response

Update Rule

This URL will provide access to users to edit any properties in the Alert rule and save the changes.

patch

/alerts/v1/update/{alert_id}

Path parameters

alert_idstringrequired

Unique identifier for the alert

Body

object

Example: {"description":"This alert rule is designed to promptly notify you when one or more servers in your infrastructure become unresponsive or inaccessible.","labels":{"severity":"warning"}}

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PATCH \
  --url 'http://localhost:3000/alerts/v1/update/{alert_id}' \
  --header 'Content-Type: application/json' \
  --data '{"description":"This alert rule is designed to promptly notify you when one or more servers in your infrastructure become unresponsive or inaccessible.","labels":{"severity":"warning"}}'

200

200

No body

Successful response

Delete Configured Alert Rules

This URLwill provided access to user to delete any custom rule.

delete

/alerts/v1/delete/{alert_id}

Path parameters

alert_idstringrequired

Unique identifier for the alert

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'http://localhost:3000/alerts/v1/delete/{alert_id}'

200

200

No body

Successful response

Alerts Silience APIs

Add Silence

post

/alerts/v1/silence/create

Body

object

Example: {"startDate":"2024-01-11T07:56:23Z","endDate":"2024-01-11T08:56:23Z","alertId":"c7464d32-1d8d-4eaf-9b23-1313a3ff8149","manager":"grafana"}

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'http://localhost:3000/alerts/v1/silence/create' \
  --header 'Content-Type: application/json' \
  --data '{"startDate":"2024-01-11T07:56:23Z","endDate":"2024-01-11T08:56:23Z","alertId":"c7464d32-1d8d-4eaf-9b23-1313a3ff8149","manager":"grafana"}'

200

200

No body

Successful response

Get Silence

get

/alerts/v1/silence/get/{alert_id}

Path parameters

alert_idstringrequired

Unique identifier for the alert

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'http://localhost:3000/alerts/v1/silence/get/{alert_id}'

200

200

No body

Successful response

Fetch All Silences

get

/alerts/v1/silence/search

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'http://localhost:3000/alerts/v1/silence/search'

200

200

No body

Successful response