Update a notification channel

Limited availability 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 you have a channel_type of email with johndoe and janedoe currently set as usernames, 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 change 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

Path Params
string
enum
required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:
integer
required

The unique identifier assigned to the monitoring alerts notification channel. Run the List notification channels operation and store the id for the applicable one.

Body Params
details
object
string

The name of the notification channel for identification purposes. This value needs to be unique for each notification channel.

Responses

Language
Credentials
LoadingLoading…
Response
Choose an example:
application/json