Update a notification channel

put

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

Beta Update an existing monitoring alert notification channel. A notification channel is the method of communication used to send a monitoring alert.

📘

To maintain existing settings in a notification channel, you need to provide them when updating an object. For example, if johndoe and janedoe are currently set as usernames in an email channel, you need to include them if you're updating the usernames object with a new value. Run the Get notification channel operation and review the channel's existing settings.

You can't update the channel_type for an existing notification channel.

You can't update the default notification channel, or a system notification channel.

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_write

CLI

linode-cli alerts channels-update 754
--details.email.usernames johndoe /
--details.email.usernames janedoe /
--details.email.usernames bobdoe

Learn more

Responses

Response body

object

alerts

object

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

alert_count

integer

The number of alerts that have been assigned to this notification channel. This will be 0 for a newly created channel.

type

string

enum

The alert's entity type. This will always be alert-definitions for an alert.

alert-definitions

url

The URL to access a list of all of the alerts assigned to this notification channel, based on its id.

channel_type

string

enum

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

email

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.

object

A notification channel set up to deliver an email for an alert.

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.

Language

Credentials


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


xxxxxxxxxx
25
 
1
{
2
  "alerts": {
3
    "alert_count": 5,
4
    "type": "alerts-definitions",
5
    "url": "/monitor/alerts-definitions/10000"
6
  },
7
  "channel_type": "email",
8
  "created": "2026-01-20 01:41:09",
9
  "created_by": "johndoe",
10
  "details": {
11
    "email": {
12
      "recipient_type": "user",
13
      "usernames": [
14
        "johndoe",
15
        "janedoe",
16
        "bobdoe"
17
      ]
18
    }
19
  },
20
  "id": 10000,
21
  "label": "New email channel for Managed Database alerts",
22
  "type": "user",
23
  "updated": "2026-01-21 02:33:21",
24
  "updated_by": "johndoe"
25
}

200The notification channel was updated.

defaultSee Errors for the range of possible error response codes.