Skip to main content
ZStack
Alerting & Response/Alert Rules

CreateAlertInhibitionRule

Create a new inhibition rule for correlating and suppressing alerts

POST/api/v1/alerting/inhibition-rules

Operation ID

CreateAlertInhibitionRule

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

Body Fields

  • name
    StringRequired

    Human-readable rule name

    Example: Suppress disk alerts when host down

  • description
    StringRequired

    Rule description

    Example: Suppress disk alerts when host is unreachable

  • sourceMatch
    StringRequired

    Source alert matcher expression

    Example: alertname=HostDown

  • targetMatch
    StringRequired

    Target alert matcher expression

    Example: alertname=DiskFull

  • equalLabels
    StringRequired

    Labels that must match between source and target

    Example: host,cluster

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • uuid
    String

    Unique identifier of the inhibition rule

    Example: inhib-001

  • name
    String

    Human-readable rule name

    Example: Suppress disk alerts when host down

  • description
    String

    Rule description

    Example: Suppress disk alerts when host is unreachable

  • sourceMatch
    String

    Source alert matcher expression

    Example: alertname=HostDown

  • targetMatch
    String

    Target alert matcher expression to suppress

    Example: alertname=DiskFull

  • equalLabels
    String

    Comma-separated labels that must match between source and target

    Example: host,cluster

  • enabled
    Boolean

    Whether this inhibition rule is active

    Example: true

  • createDate
    String

    Timestamp when the rule was created

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

  • lastOpDate
    String

    Timestamp of the last modification

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