Notification Channels API

Contents

• Notification Channels API

  • Creating notification channels

  • Searching notification channels

  • Obtain information on a single notification

  • Updating notification channels

  • Deleting notification channels

Creating notification channels

Create a notification channel

POST /v2/notifications/

Path Parameters

Name	Type	Description
type*	String	The type of notification channel to create.
description*	String	A name for the channel.
destination*	String	The destination for the notification. ie the email address for email, slack webhook URL for slack, etc.
auto_resolve	String	Only used by VictorOps and PagerDuty channels. Defaults to false. More info here.

201: Created HTTP/1.1 201 Content-Type: application/json { "id": "id", "url": "/v2/notifications/<notification_id>" }

404: Not Found Invalid form data

409: Conflict Channel with the description already exists.

Request format:

HTTP/1.1 200
Content-Type: application/json

{
  "type": "email" | "pagerduty" | "slack" | "webhook" | "victorops" | "opsgenie",
  "description": "Descriptive name for channel",
  "destination": "Destination key of the channel.",
  "auto_resolve": True | False
}

Curl example

curl -H "Content-Type: application/json" -X POST -d \
'{"type": "email", "description": "A test notification", "destination": "[e-mail]"}' \
"https://[e-mail]/v2/notifications/"

---

Searching notification channels

Search notification channels

GET /v2/notifications/?query

Returns a JSON object containing information on notification channels matching the search query. Returns all the notifications if the parameter is left empty.

Path Parameters

Name	Type	Description
type	String	Format: &type=<type_1>&type=<type_2> The notification type to search for. Can specify multiple types to search for more than 1.
description	String	Format: &descriptions=<descriptions_1>&descriptions=<descriptions_2> The descriptions to search for. Can specify multiple descriptions to search for more than 1.
id	String	Format: &id=<id_1>&id=<id_2> The notification id to search for. Can specify multiple ids to search for more than 1.
page	String	Format: &page=1 The page number to query. Used if there are more items than can be displayed in a single request (default: 1).
max	String	Format: &max=50 The maximum number of items to display. Limit of 100 (default: 100).
auto_resolve	String	For use with VictorOps and PagerDuty channels only.

200: OK HTTP/1.1 200 Content-Type: application/json { "notifications": [ { "type": "email" | "pagerduty" | "slack" | "webhook" | "victorops" | "opsgenie", "destination": "The destination for the notification", "description": "Descriptive name for channel", "id": "notification channel id", "auto_resolve": True | False } ] "next_page": False | page number }

400: Bad Request Invalid

Curl example

curl -X GET "https://[e-mail]/v2/notifications/?type=email&type=slack"

Specifying multiple fields performs an OR operation and returns notifications that match either criteria.

---

Obtain information on a single notification

Obtain information on a single alert

GET /v2/notifications/<notification_id>/

Returns a single notification identified by the notification id.

Path Parameters

Name	Type	Description
type*	String	The type of notification channel to create.
description*	String	A name for the channel.
destination*	String	The destination for the notification. ie the email address for email, slack webhook URL for slack, etc.
auto_resolve	String	Only used by VictorOps and PagerDuty channels. Defaults to false.

200: OK HTTP/1.1 200 Content-Type: application/json { "type": "email" | "pagerduty" | "slack" | "webhook" | "victorops" | "opsgenie", "description": "Descriptive name for channel", "destination": "Destination key of the channel." "id": "notification channel id", "auto_resolve": True | False }

400: Bad Request Doesn't exist

Curl example

curl -X GET "https://[e-mail]/v2/notification/123-456-789/"

Obtain information of the notification channel identified by the id 123-456-789.

---

Updating notification channels

Update notification channels

PUT /v2/notifications/<notification_id>/

Updates a notification channel identified by the notification id.

Path Parameters

Name	Type	Description
type	String	The type of notification channel to create.
description	String	A name for the channel.
destination	String	The destination for the notification. ie the email address for email, slack webhook URL for slack, etc.
auto_resolve	String	Only used by VictorOps and PagerDuty channels. Defaults to false.

200: OK HTTP/1.1 200 Content-Type: application/json { "type": "email" | "pagerduty" | "slack" | "webhook" | "victorops" | "opsgenie", "description": "Descriptive name for channel", "destination": "Destination key of the channel." "id": "notification channel id", "auto_resolve": True | False }

400: Bad Request Invalid form data

404: Not Found Doesn't exist

409: Conflict Notification channel with the description already exists.

Curl example

curl -H "Content-Type: application/json" -X PUT \
 -d '{"destination": "[e-mail]"}' \
"https://[e-mail]/v2/notifications/123-456-789/"

Updates the destination of notification 123-456-789. Each field is optional and only the specified fields are updated.

---

Deleting notification channels

DELETE /v2/notifications/<notification_id>/ - Deletes a notification channel identified by the notification id.

Curl example

curl -X DELETE "https://[e-mail]/v2/notifications/123-456-789/"

Delete the notification channel identified by the id 123-456-789.

Status Codes:

• 200 - OK

• 404 - Notification channel doesn’t exist.