List notification channels

get

https://api.linode.com/{apiVersion}/monitor/alert-channels

Beta Returns all of the monitoring alert notification channels available to your user. A notification channel is a method of communication used to send a monitoring alert.

📘
Filtering is supported for specific objects, labeled as Filterable. However, only the +and and +or operators are supported, and you can't nest filter operators.

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

OAuth scopes. Your user needs these scopes assigned. Learn more.
- Scopes: monitor:read_only

CLI

linode-cli alerts channels-list

Learn more

Responses

Response body

object

data

array of objects

data

object

alerts

object

Details about the alerts where you've applied this notification channel.

channel_type

string

enum

The type of notification used with the channel. Currently, only email is supported.

email

content

object

deprecated

Deprecated, Read-only The configuration of the alert notification channel.

📘
This only applies to legacy notification channels with a type of system. This appears as an empty object if the type is user.

created

date-time

When the notification channel was created.

created_by

string

For a user notification channel, this is the user on your account that created it. For a system notification channel, this value is returned as system.

details

object

The configuration of the notification channel.

integer

Filterable The unique identifier for the notification channel.

label

string

Filterable The name of the notification channel for identification purposes.

type

string

enum

The type of notification channel. This can be either system for a channel provided by Akamai, or user for one you've created.

system user

updated

date-time

When the notification channel was last updated. This is the same as created if the channel hasn't been updated.

updated_by

string

For a user notification channel, this is the user on your account that last updated it. For a system notification channel, this is returned as system. If it hasn't been updated, this value is the same as created_by.

page

integer

Read-only The current page.

pages

integer

Read-only The total number of pages.

results

integer

Read-only The total number of results.

Language

Credentials


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.linode.com/v4beta/monitor/alert-channels \
3
     --header 'accept: application/json'


xxxxxxxxxx
59
}
1
{
2
  "data": [
3
    {
4
      "alerts": {
5
        "alert_count": 5,
6
        "type": "alerts-definitions",
7
        "url": "/monitor/alerts-definitions/10000"
8
      },
9
      "channel_type": "email",
10
      "created": "2025-03-20 01:41:09",
11
      "created_by": "johndoe",
12
      "details": {
13
        "email": {
14
          "recipient_type": "user",
15
          "usernames": [
16
            "johndoe",
17
            "janedoe"
18
          ]
19
        }
20
      },
21
      "id": 10000,
22
      "label": "Notification channel #1",
23
      "type": "user",
24
      "updated": "2025-03-20 01:41:09",
25
      "updated_by": "johndoe"
26
    },
27
    {
28
      "alerts": {
29
        "alert_count": 3,
30
        "type": "alerts-definitions",
31
        "url": "/monitor/alert-channels/10001/alerts"
32
      },
33
      "channel_type": "email",
34
      "content": {
35
        "email": {
36
          "email_addresses": [
37
            "Users-with-read-write-access-to-resources"
38
          ]
39
        }
40
      },
41
      "created": "2025-03-20 01:41:09",
42
      "created_by": "system",
43
      "details": {
44
        "email": {
45
          "recipient_type": "read_write_users",
46
          "usernames": []
47
        }
48
      },
49
      "id": 10001,

200Returns a paginated list of monitoring alerts notification channels.

defaultSee Errors for the range of possible error response codes.