---
title: "Pause or resume several monitors (admin/superadmin)"
method: POST
path: "/monitors/bulk/pause"
tags: ["monitors"]
---

# Pause or resume several monitors (admin/superadmin)

`POST /monitors/bulk/pause`

## Request

- Base URL: `/api/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/monitors/bulk/pause`
- Auth: HTTP bearer

## Request body

- object
  - `monitorIds` string[], required
  - `pause` boolean, required

## Response `200`

OK

- object
  - `success` true, required
  - `msg` string, required
  - `data` object, required
    - `monitors` Monitor[], required
      - `id` string, required
      - `userId` string, required
      - `teamId` string, required
      - `name` string, required
      - `description` string
      - `method` 'GET' | 'HEAD', required
      - `status` 'up' | 'down' | 'paused' | 'initializing' | 'maintenance' | 'breached', required
      - `statusWindow` boolean[], required
      - `statusWindowSize` number, required
      - `statusWindowThreshold` number, required
      - `type` 'http' | 'ping' | 'pagespeed' | 'hardware' | 'docker' | 'port' | 'game' | 'grpc' | 'websocket' | 'dns' | 'unknown', required
      - `ignoreTlsErrors` boolean, required
      - `proxyMode` 'inherit' | 'none' | 'custom', required
      - `proxyId` string
      - `useAdvancedMatching` boolean, required
      - `jsonPath` string
      - `expectedValue` string
      - `matchMethod` union
        - 'equal' | 'include' | 'regex'
        - ''
      - `url` string, required
      - `port` number
      - `isActive` boolean, required
      - `interval` number, required
      - `uptimePercentage` number
      - `notifications` string[], required
      - `tags` string[], required
      - `customUpCodes` number[], required
      - `secret` string
      - `cpuAlertThreshold` number, required
      - `cpuAlertCounter` number, required
      - `memoryAlertThreshold` number, required
      - `memoryAlertCounter` number, required
      - `diskAlertThreshold` number, required
      - `diskAlertCounter` number, required
      - `tempAlertThreshold` number, required
      - `tempAlertCounter` number, required
      - `selectedDisks` string[], required
      - `gameId` string
      - `grpcServiceName` string
      - `strategy` 'desktop' | 'mobile'
      - `group` string, nullable, required
      - `geoCheckEnabled` boolean
      - `geoCheckLocations` string[]
      - `geoCheckInterval` number
      - `dockerLogsEnabled` boolean
      - `dockerAlertOnStopped` boolean
      - `dockerAlertOnUnhealthy` boolean
      - `dockerTlsCa` string
      - `dockerTlsCert` string
      - `dockerTlsKeySet` boolean
      - `dnsServer` string
      - `dnsRecordType` 'A' | 'AAAA' | 'CNAME' | 'MX' | 'TXT' | 'NS'
      - `recentChecks` object[], required
        - `id` string, required
        - `status` boolean, required
        - `responseTime` number, required
        - `statusCode` number, required
        - `message` string, required
        - `createdAt` string, required
        - `accessibility` number
        - `bestPractices` number
        - `seo` number
        - `performance` number
        - `audits` object
          - `cls` object
            - `id` string
            - `title` string
            - `score` number, nullable
            - `displayValue` string
            - `numericValue` number
            - `numericUnit` string
          - `si` object
            - `id` string
            - `title` string
            - `score` number, nullable
            - `displayValue` string
            - `numericValue` number
            - `numericUnit` string
          - `fcp` object
            - `id` string
            - `title` string
            - `score` number, nullable
            - `displayValue` string
            - `numericValue` number
            - `numericUnit` string
          - `lcp` object
            - `id` string
            - `title` string
            - `score` number, nullable
            - `displayValue` string
            - `numericValue` number
            - `numericUnit` string
          - `tbt` object
            - `id` string
            - `title` string
            - `score` number, nullable
            - `displayValue` string
            - `numericValue` number
            - `numericUnit` string
        - `cpu` object
          - `physical_core` number
          - `logical_core` number
          - `frequency` number
          - `current_frequency` number
          - `temperature` number[]
          - `usage_percent` number
        - `memory` object
          - `total_bytes` number
          - `used_bytes` number
          - `usage_percent` number
        - `disk` object[]
          - `device` string
          - `total_bytes` number
          - `used_bytes` number
          - `usage_percent` number
        - `host` object
          - `os` string
          - `platform` string
          - `pretty_name` string
        - `containerSummary` object
          - `total` number, required
          - `running` number, required
          - `stopped` number, required
          - `unhealthy` number, required
      - `createdAt` string, required
      - `updatedAt` string, required
      - `lastEvaluatedAt` number, required
    - `failedCount` number, required

## Other responses

- `400`: Invalid request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too many requests
- `500`: Internal server error

## Changes

- **2026-10-01** `e1e4b18d0319`: 3 breaking, 3 warning, 5 info
  - removed the required property `success` from the response with the `401` status
  - removed the required property `success` from the response with the `403` status
  - removed the required property `success` from the response with the `500` status
  - removed the optional property `data` from the response with the `401` status
  - …7 more
- **2026-10-01** `5247c2a7e648`: 1 warning
  - removed the optional property `data/monitors/items/dockerTlsKey` from the response with the `200` status
- **2026-10-01** `9b162bd63ecf`: 1 breaking, 3 info
  - the `data` response's property type changed from no type to `object` for status `200`
  - the response property `data` became required for the status `200`
  - added the required property `data/failedCount` to the response with the `200` status
  - added the required property `data/monitors` to the response with the `200` status
- **2026-09-29** `67b6c1ec70e4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bluewave-labs/apis/checkmate-api/changes/monitors/bulk/pause/post.md)

---

[API](https://skmtc.dev/bluewave-labs/apis/checkmate-api.md) - [All operations](https://skmtc.dev/bluewave-labs/apis/checkmate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluewave-labs/apis/checkmate-api/revisions/4f4b0d97c1f9?raw)