Skip to main content
ZStack
Alerting & Response/Alert Channels & Integrations

UpdateAlertChannel

Update an existing notification channel configuration

PUT/api/v1/alerting/channels/{uuid}

Operation ID

UpdateAlertChannel

Since

1.0.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

application/json

Path Parameters

  • uuid
    StringRequired

    UUID of the channel to update

Body Fields

  • name
    StringRequired

    New channel name

    Example: Updated Ops Channel

  • description
    StringRequired

    New channel description

    Example: Updated description

  • config
    ObjectRequired

    New channel configuration. A redaction placeholder *** returned by a read API may be submitted unchanged to preserve the stored credential.

    Example: (nested object)

  • templateId
    StringRequired

    New template identifier

    Example: tmpl-email-002

  • status
    StringRequired

    New channel status

    Example: disabled

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • uuid
    String

    Unique identifier of the channel

    Example: chan-001

  • name
    String

    Human-readable channel name

    Example: Ops Email Channel

  • description
    String

    Description of the channel purpose

    Example: Email notifications for operations team

  • type
    String

    Channel type: email, webhook, dingtalk, etc.

    Example: email

  • status
    String

    Channel status: active or disabled

    Example: active

  • config
    Object

    Channel-specific configuration (varies by type). Stored credentials are returned as the redaction placeholder ***.

    Example: (nested object)

  • templateId
    String

    Message template identifier for rendering

    Example: tmpl-email-001

  • alertCount
    String

    Number of alerts sent through this channel

    Example: 150

  • createDate
    String

    Timestamp when the channel was created

    Example: 2026-01-15T08:00:00Z

  • lastOpDate
    String

    Timestamp of the last channel modification

    Example: 2026-01-15T08:00:00Z