NEnetxms
Notification Channels

Update a notification channel

Changed on

Update an existing notification channel. Only provided fields are updated. Channels provided by chat bots cannot be updated.

put/v1/notification-channels/{channel-name}

Request

  • Base URL
    http://127.0.0.1:8000
  • URL
    http://127.0.0.1:8000/v1/notification-channels/{channel-name}
  • Auth
    HTTP bearer

Path parameters

channel-namestring required

Channel name

Request body

descriptionstring

Channel description

driverNamestring

Notification driver name

configurationstring

Driver-specific configuration (XML or NXSL script)

Response

Notification channel updated successfully

namestring

Channel name

descriptionstring

Channel description

driverNamestring

Notification driver name

configurationstring

Driver-specific configuration

driverInitializedboolean

Whether the driver was initialized successfully

needSubjectboolean

Whether the driver requires a subject field

needRecipientboolean

Whether the driver requires a recipient field

errorMessagestring

Last error message

sendStatusinteger

Last send status code

healthCheckStatusboolean

Health check status

lastMessageTimestring

Timestamp of last sent message

messageCountinteger

Total messages sent

failureCountinteger

Total send failures

digestedCountinteger

Total messages absorbed into digest

queueSizeinteger

Current message queue size

providedByChatBotboolean

Whether the channel is provided by a chat bot (such channels cannot be modified, renamed, or deleted)

Changes