Skip to main content
ZStack
Alerting & Response/Alert Routing & Policies

UpdateAlertNotificationPolicy

Update an existing notification routing policy

PUT/api/v1/alerting/notification-policies/{uuid}

Operation ID

UpdateAlertNotificationPolicy

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 policy to update

Body Fields

  • name
    StringRequired

    New policy name

    Example: Updated Routing Policy

  • description
    StringRequired

    New policy description

    Example: Updated routing description

  • priority
    IntegerRequired

    New priority order

    Example: 2

  • matchers
    ListRequired

    Updated label matchers

    Example: (nested array)

    • key
      String

      Label key to match against

      Example: severity

    • operator
      String

      Match operator: eq, neq, regex, etc.

      Example: eq

    • value
      String

      Value to match against

      Example: critical

  • channelIds
    ListRequired

    Updated channel UUIDs

    Example: item1,item2

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • uuid
    String

    Unique identifier of the policy

    Example: policy-001

  • name
    String

    Human-readable policy name

    Example: Critical Alert Routing

  • description
    String

    Description of the policy routing logic

    Example: Route critical alerts to ops channels

  • priority
    Integer

    Priority order for policy evaluation (lower = higher priority)

    Example: 1

  • isDefault
    Boolean

    Whether this is the default catch-all policy

    Example: false

  • matchers
    List

    Label matchers for routing decisions

    Example: (nested array)

    • key
      String

      Label key to match against

      Example: severity

    • operator
      String

      Match operator: eq, neq, regex, etc.

      Example: eq

    • value
      String

      Value to match against

      Example: critical

  • channelIds
    List

    Channel UUIDs to deliver notifications to

    Example: item1,item2

  • groupBy
    List

    Fields to group notifications by

    Example: item1,item2

  • groupWait
    Integer

    Seconds to wait before sending first notification

    Example: 30

  • groupInterval
    Integer

    Seconds between grouped notification batches

    Example: 300

  • repeatInterval
    Integer

    Seconds before repeating a notification

    Example: 3600

  • status
    String

    Policy status: active or disabled

    Example: active

  • createDate
    String

    Timestamp when the policy was created

    Example: 2024-01-15T09:00:00Z

  • lastOpDate
    String

    Timestamp of the last policy modification

    Example: 2024-01-15T09:00:00Z