Skip to main content
Alerting & Response/Alert Rules

ListAlertInhibitionRules

List all alert inhibition rules for suppressing correlated alerts

GET/api/v1/alerting/inhibition-rules

Operation ID

ListAlertInhibitionRules

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

This API requires no request parameters.

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • items
    List

    List of inhibition rules

    Example: (nested array)

    • 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

  • total
    Integer

    Total number of inhibition rules

    Example: 3

  • limit
    Integer

    Maximum items per page

    Example: 20

  • offset
    Integer

    Offset from start of result set

    Example: 20