/alerts/silences - List active+pending silences (hierarchy-wide)

GET /alerts/silences
Bearer auth

Cross-system parallel of GET /systems/{id}/alerts/silences. Returns every active or pending Alertmanager silence in the caller's scope, enriched with organization_id (the tenant that owns the silence) and system_key (extracted from the silence matchers). Expired silences and silences without a system_key matcher are excluded — only silences our UI ever creates are addressable.

Scope follows the same three modes as /alerts/totals:

  • organization_id omitted → caller's full hierarchy (cross-tenant fan-out).
  • organization_id=X → single tenant X.
  • organization_id=X&include=descendants → X plus its sub-tree.

Requires read:systems permission.

Query parameters

  • organization_id array[string]

    Target organization ID(s). Repeat the param for multiple values. Optional for all roles except Customer (where it is ignored).

  • include string

    Set to descendants together with organization_id to expand each value to its sub-tree.

    Value is descendants.

  • system_key array[string]

    Filter silences by one or more system keys (exact match on the system_key matcher). Repeat the param for multiple values.

Responses

  • 200 application/json

    Paginated list of system-scoped silences

    Hide response attributes Show response attributes object
    • code integer
    • message string
    • data object
      Hide data attributes Show data attributes object
      • silences array[object]
        Hide silences attributes Show silences attributes object
        • id string

          Alertmanager silence ID

        • matchers array[object]
          Hide matchers attributes Show matchers attributes object
          • name string

            Label name

          • value string

            Label value

          • isRegex boolean

            Whether the value is a regex

        • startsAt string(date-time)
        • endsAt string(date-time)
        • updatedAt string(date-time)
        • createdBy string
        • comment string
        • status object
          Hide status attribute Show status attribute object
          • state string

            Runtime state of the silence

            Values are active, expired, or pending.

        • organization_id string

          Tenant that owns the silence (Mimir stores silences per-tenant).

        • system_key string

          System key extracted from the silence matchers.

      • warnings array[string]

        Per-tenant fan-out errors. Always present (empty when every tenant responded OK). Each entry is a string org <logto_id>: <error>.
  • 401 application/json

    Unauthorized - invalid or missing token

    Hide response attributes Show response attributes object
    • code integer
    • message string
    • data object | null
  • 403 application/json

    Forbidden - insufficient permissions

    Hide response attributes Show response attributes object
    • code integer
    • message string
    • data object | null
  • 500 application/json

    Internal server error

    Hide response attributes Show response attributes object
    • code integer
    • message string
    • data object | null
GET /alerts/silences 
curl \
 --request GET 'https://api.your-domain.com/api/alerts/silences' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "code": 200,
  "message": "silences retrieved successfully",
  "data": {
    "silences": [
      {
        "id": "d9f91c6e-1b33-484e-befa-bfb41020e178",
        "organization_id": "m4m3mdjdiizs",
        "system_key": "NETH-D417-A2C2-7810-43D2-984B-2164-34C1-B22E",
        "matchers": [
          {
            "name": "system_key",
            "value": "NETH-D417-A2C2-7810-43D2-984B-2164-34C1-B22E",
            "isRegex": false
          },
          {
            "name": "alertname",
            "value": "HighCPUUsage",
            "isRegex": false
          },
          {
            "name": "severity",
            "value": "warning",
            "isRegex": false
          }
        ],
        "startsAt": "2026-05-12T08:16:36Z",
        "endsAt": "2026-05-12T09:16:36Z",
        "updatedAt": "2026-05-12T08:16:36Z",
        "createdBy": "amelia.foster",
        "comment": "muted during maintenance window",
        "status": {
          "state": "active"
        }
      }
    ],
    "warnings": []
  }
}
Response examples (401) 
{
  "code": 401,
  "message": "invalid token",
  "data": {}
}
Response examples (403) 
{
  "code": 403,
  "message": "insufficient permissions",
  "data": {}
}
Response examples (500) 
{
  "code": 500,
  "message": "internal server error",
  "data": {}
}