---
updatedAt: 2026-09-08T20:26:09.000Z
agentTools:
  projectIndex: https://docs.observeinc.com/llms.txt
---

# List monitor mutes

Returns a paginated list of monitor mute rules, optionally filtered by a CEL expression.

# OpenAPI definition

````json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Observe by Snowflake API",
    "description": "# Overview\nWelcome to the Observe API Docs!\n\nThe Observe API is a RESTful API. POST bodies and responses are typically JSON-encoded.\n\n## Authentication\nRequests to the Observe API are authenticated with an API token. The token can be supplied using HTTP Bearer authentication:\n```\n// passing token as bearer token\ncurl -H \"Authorization: Bearer <customerid> <token>\" https://<customerid>.<observe-domain>.com/v1/...\n```\n",
    "version": "1.0.230307"
  },
  "servers": [
    {
      "url": "https://{customerid}.observeinc.com",
      "description": "US west server",
      "variables": {
        "customerid": {
          "default": "OBSERVE_CUSTOMERID",
          "description": "The customer ID for your instance."
        }
      }
    },
    {
      "url": "https://{customerid}.{cluster}.observeinc.com",
      "description": "Specific regional cluster (prod)",
      "variables": {
        "customerid": {
          "default": "OBSERVE_CUSTOMERID",
          "description": "The customer ID for your instance."
        },
        "cluster": {
          "enum": [
            "eu-1",
            "ap-1"
          ],
          "default": "eu-1",
          "description": "For regional clusters, choose one."
        }
      }
    },
    {
      "url": "https://{customerid}.{domain}.com",
      "description": "Specific Observe server",
      "variables": {
        "customerid": {
          "default": "OBSERVE_CUSTOMERID",
          "description": "The customer ID for your instance."
        },
        "domain": {
          "default": "OBSERVE_DOMAIN",
          "description": "The Observe domain for your instance."
        }
      }
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "MonitorMute",
      "x-displayName": "Monitor Mute",
      "description": "Manage monitor mute rules. Mute rules suppress alert notifications for one or more monitors during a defined time window. Learn more about [monitor mute rules](https://docs.observeinc.com/docs/mute-a-monitor).\n"
    }
  ],
  "paths": {
    "/v1/monitor-mutes": {
      "get": {
        "summary": "List monitor mutes",
        "description": "Returns a paginated list of monitor mute rules, optionally filtered by a CEL expression.",
        "operationId": "ListMonitorMutes",
        "tags": [
          "MonitorMute"
        ],
        "parameters": [
          {
            "name": "filter",
            "in": "query",
            "description": "CEL expression to filter results over mute rule fields (`label`, `target.kind`, `target.monitors.id`, `createdBy.id`). Supports `matches()` for regex. Example: `target.kind == \"Monitors\"`.\n",
            "schema": {
              "type": "string"
            },
            "required": false
          },
          {
            "name": "expand",
            "in": "query",
            "description": "When `true`, expands all referenced objects in the response: populates `record` on each `MonitorRef` in `target.monitors` with brief monitor metadata, and populates `label`, `timezone`, and `locale` on `createdBy` and `updatedBy`. `record` is omitted for any target monitor the caller is not authorized to read; its `id` is still returned, since the target id set is part of the rule's own configuration.\n",
            "schema": {
              "type": "boolean"
            },
            "required": false
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of results to return. Defaults to 200, max 1000.",
            "schema": {
              "type": "integer",
              "format": "int64",
              "default": 200,
              "minimum": 1,
              "maximum": 1000
            },
            "required": false
          },
          {
            "name": "offset",
            "in": "query",
            "description": "Number of results to skip for pagination. Defaults to 0.",
            "schema": {
              "type": "integer",
              "format": "int64",
              "default": 0,
              "minimum": 0
            },
            "required": false
          },
          {
            "name": "orderBy",
            "in": "query",
            "description": "Comma-separated fields to order by. Prefix with `-` for descending. Defaults to `id`. Example: `orderBy=createdAt,-label`.\n",
            "schema": {
              "type": "string"
            },
            "required": false
          }
        ],
        "responses": {
          "200": {
            "description": "Monitor mutes listed successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MonitorMute-ListResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse-400"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse-401"
          },
          "403": {
            "$ref": "#/components/responses/ErrorResponse-403"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse-429"
          },
          "5XX": {
            "$ref": "#/components/responses/ErrorResponse-5XX"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "Authorization: Bearer <customerid> <apitoken>\n"
      }
    },
    "schemas": {
      "ObjectId": {
        "type": "string",
        "format": "ObjectId"
      },
      "User": {
        "title": "User",
        "type": "object",
        "required": [
          "id"
        ],
        "properties": {
          "id": {
            "title": "User Identifier",
            "$ref": "#/components/schemas/ObjectId"
          },
          "label": {
            "title": "User Label",
            "type": "string"
          },
          "timezone": {
            "type": "string"
          },
          "locale": {
            "type": "string"
          }
        }
      },
      "Meta": {
        "description": "List Response Metadata",
        "type": "object",
        "required": [
          "totalCount"
        ],
        "properties": {
          "totalCount": {
            "description": "The total number of resources available, independent of pagination.\nThe API may return -1 if the total count is unknown or cannot be computed\nin reasonable time.\n",
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "ErrorMessage": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "A stable, machine-readable identifier for the kind of error."
          },
          "message": {
            "type": "string",
            "description": "Error message"
          }
        },
        "required": [
          "type",
          "message"
        ]
      },
      "Time": {
        "type": "string",
        "format": "RFC3339"
      },
      "NullableTime": {
        "type": [
          "string",
          "null"
        ],
        "format": "RFC3339"
      },
      "ObjectTags": {
        "title": "ObjectTags",
        "type": "object",
        "additionalProperties": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "description": "User-applied tags for organization and discovery, as a map of tag key\nto a list of values. For example: {\"env\": [\"prod\", \"staging\"], \"team\": [\"platform\"]}.\n"
      },
      "Monitor-Brief": {
        "title": "MonitorBrief",
        "type": "object",
        "description": "Brief monitor metadata included when a reference is expanded.",
        "required": [
          "name",
          "label",
          "description"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Name of the monitor, unique within its workspace.\n"
          },
          "label": {
            "type": "string",
            "deprecated": true,
            "description": "Same as `name`. Deprecated; read `name` instead."
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "The monitor's description. Null when no description is configured."
          },
          "objectTags": {
            "$ref": "#/components/schemas/ObjectTags",
            "description": "The monitor's current object tags, as a map of tag key to a list of values. An empty object when it has none. Included in alert responses; other references omit it.\n"
          }
        }
      },
      "Monitor-Ref": {
        "title": "MonitorRef",
        "type": "object",
        "description": "Reference to a monitor. Always carries the `id`. The `record` field is\npopulated with brief metadata only when `expand=true`.\n",
        "required": [
          "id"
        ],
        "properties": {
          "id": {
            "$ref": "#/components/schemas/ObjectId"
          },
          "record": {
            "$ref": "#/components/schemas/Monitor-Brief"
          }
        }
      },
      "MonitorMute-TargetKind": {
        "title": "MonitorMuteTargetKind",
        "type": "string",
        "description": "`Global` suppresses all monitors (requires a non-empty `filter`). `Monitors` targets a specific set of monitors by ID.\n",
        "enum": [
          "Global",
          "Monitors"
        ]
      },
      "MonitorMute-Target": {
        "title": "MonitorMuteTarget",
        "description": "Describes which monitors this mute rule applies to. `monitors` is always present: empty when `kind` is `Global`, non-empty when `kind` is `Monitors`.\n",
        "type": "object",
        "required": [
          "kind",
          "monitors"
        ],
        "properties": {
          "kind": {
            "$ref": "#/components/schemas/MonitorMute-TargetKind"
          },
          "monitors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Monitor-Ref"
            }
          }
        }
      },
      "MonitorMute-ScheduleKind": {
        "title": "MonitorMuteScheduleKind",
        "type": "string",
        "description": "`OneTime` defines a fixed window with an explicit start and optional end. `Recurring` fires on a cron schedule for a specified duration.\n",
        "enum": [
          "OneTime",
          "Recurring"
        ]
      },
      "MonitorMute-OneTime": {
        "title": "MonitorMuteOneTime",
        "description": "A one-time mute window. Always fully populated in responses.",
        "type": "object",
        "required": [
          "startTime",
          "endTime"
        ],
        "properties": {
          "startTime": {
            "$ref": "#/components/schemas/Time",
            "description": "Start of the mute window."
          },
          "endTime": {
            "$ref": "#/components/schemas/NullableTime",
            "description": "End of the mute window. `null` means until manually deleted."
          }
        }
      },
      "MonitorMute-CronSchedule": {
        "title": "MonitorMuteCronSchedule",
        "type": "object",
        "required": [
          "rawCron",
          "timezone"
        ],
        "properties": {
          "rawCron": {
            "type": "string",
            "description": "POSIX 5-field cron expression (`minute hour day-of-month month day-of-week`). No seconds field, no year field, no Quartz extensions, no `@daily`-style macros. Fields support `*` (any), `,` (list), `-` (range), and `/` (step). The server rejects expressions outside this dialect with `invalid_schedule`. Examples: `0 2 * * *` (daily at 02:00), `0 9-17 * * 1-5` (every hour 09:00–17:00 Mon–Fri), `0-59/15 * * * *` (every 15 min).\n"
          },
          "timezone": {
            "type": "string",
            "description": "IANA timezone name. Example: \"America/Los_Angeles\"."
          }
        }
      },
      "MonitorMute-Recurring": {
        "title": "MonitorMuteRecurring",
        "description": "A recurring mute window driven by a cron schedule.",
        "type": "object",
        "required": [
          "cronSchedule",
          "durationSeconds"
        ],
        "properties": {
          "cronSchedule": {
            "$ref": "#/components/schemas/MonitorMute-CronSchedule"
          },
          "durationSeconds": {
            "type": "integer",
            "format": "int64",
            "minimum": 1,
            "description": "Wall-clock length of each fired window in seconds. Must be at least 1."
          }
        }
      },
      "MonitorMute-Schedule": {
        "title": "MonitorMuteSchedule",
        "description": "Discriminated schedule. Both `oneTime` and `recurring` are always present in responses; the inactive sibling is `null`.\n",
        "type": "object",
        "required": [
          "kind",
          "oneTime",
          "recurring"
        ],
        "properties": {
          "kind": {
            "$ref": "#/components/schemas/MonitorMute-ScheduleKind"
          },
          "oneTime": {
            "description": "Populated when `kind` is `OneTime`; `null` otherwise.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/MonitorMute-OneTime"
              },
              {
                "type": "null"
              }
            ]
          },
          "recurring": {
            "description": "Populated when `kind` is `Recurring`; `null` otherwise.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/MonitorMute-Recurring"
              },
              {
                "type": "null"
              }
            ]
          }
        }
      },
      "MonitorMute-Resource": {
        "title": "MonitorMuteResource",
        "description": "A mute rule suppresses alert notifications during a defined time window. Use `target.kind: Global` to mute all monitors, or `target.kind: Monitors` to target a specific set.\n",
        "type": "object",
        "required": [
          "id",
          "label",
          "description",
          "target",
          "schedule",
          "filter",
          "startTime",
          "endTime",
          "createdBy",
          "createdAt",
          "updatedBy",
          "updatedAt"
        ],
        "properties": {
          "id": {
            "$ref": "#/components/schemas/ObjectId"
          },
          "label": {
            "type": "string",
            "description": "Human-readable name for this mute rule."
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Free-form description. `null` when unset."
          },
          "target": {
            "$ref": "#/components/schemas/MonitorMute-Target"
          },
          "schedule": {
            "$ref": "#/components/schemas/MonitorMute-Schedule"
          },
          "filter": {
            "type": [
              "string",
              "null"
            ],
            "description": "Optional CEL boolean expression evaluated against each fired alarm row at notification time. `null` means every firing is suppressed. Required and non-empty when `target.kind` is `Global` to prevent accidental fleet-wide suppression. Example: `level == \"Critical\" && context[\"service\"] == \"payments\"`.\n"
          },
          "startTime": {
            "$ref": "#/components/schemas/NullableTime",
            "description": "Computed start of the current or next active window. For `OneTime` schedules this mirrors `schedule.oneTime.startTime`. For `Recurring` schedules this is the next computed firing time. `null` between recurring windows.\n"
          },
          "endTime": {
            "$ref": "#/components/schemas/NullableTime",
            "description": "Computed end of the current or next active window. For `OneTime` schedules this mirrors `schedule.oneTime.endTime` (`null` for open-ended mutes). For `Recurring` schedules this is `startTime + durationSeconds`.\n"
          },
          "createdBy": {
            "$ref": "#/components/schemas/User"
          },
          "createdAt": {
            "$ref": "#/components/schemas/Time"
          },
          "updatedBy": {
            "$ref": "#/components/schemas/User"
          },
          "updatedAt": {
            "$ref": "#/components/schemas/Time"
          }
        }
      },
      "MonitorMute-ListResponse": {
        "title": "MonitorMuteListResponse",
        "type": "object",
        "required": [
          "monitorMutes",
          "meta"
        ],
        "properties": {
          "monitorMutes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MonitorMute-Resource"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Meta"
          }
        }
      }
    },
    "responses": {
      "ErrorResponse-400": {
        "description": "Bad request",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorMessage"
            }
          }
        }
      },
      "ErrorResponse-401": {
        "description": "Unauthorized",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorMessage"
            }
          }
        }
      },
      "ErrorResponse-403": {
        "description": "Forbidden",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorMessage"
            }
          }
        }
      },
      "ErrorResponse-429": {
        "description": "Rate limit reached",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorMessage"
            }
          }
        }
      },
      "ErrorResponse-5XX": {
        "description": "Internal server error",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorMessage"
            }
          }
        }
      }
    }
  }
}
````