---
title: "Batch Action on Monitors"
method: POST
path: "/monitors/batch"
tags: ["Monitors"]
---

# Batch Action on Monitors

`POST /monitors/batch`

Perform a batch action on monitors matching the provided filters.

Supported actions:
- **delete**: Permanently remove matching monitors
- **pause**: Pause matching monitors
- **unpause**: Unpause matching monitors

Use `dry_run: true` (the default) to preview which monitors would be affected before performing the action. Results are paginated via the `limit` parameter; loop until `has_more` is `false` to process all matching monitors.

## Request body

- BatchMonitorsRequest
  - `action` 'delete' | 'pause' | 'unpause', required — The action to perform on matching monitors. `delete` permanently removes them, `pause` sets their status to paused, and `unpause` sets their status to active.
  - `filter` object, required — At least one filter field must be provided to prevent accidental bulk operations.
    - `name` string — Filter by name (case-insensitive substring match)
    - `status` 'active' | 'paused' | 'disabled' — Filter by monitor status
    - `metadata` object — Filter by metadata key-value pairs (exact match, AND semantics)
  - `dry_run` boolean — When `true`, returns the monitors that would be affected without performing the action. Defaults to `true`.
  - `limit` integer — Maximum number of monitors to process in a single request. Defaults to 50, maximum 500.

## Response `200`

Batch action result

- BatchMonitorsResponse
  - `action` 'delete' | 'pause' | 'unpause', required — The action that was performed
  - `affected` integer, required — The number of monitors affected by the action
  - `ids` string[], required — The IDs of the monitors that were affected
  - `dry_run` boolean, required — Whether this was a dry run
  - `has_more` boolean, required — Whether there are more monitors matching the filter. If `true`, repeat the request to process the next batch.

---

[API](https://skmtc.net/exa/apis/exa-public-api.md) · [All operations](https://skmtc.net/exa/apis/exa-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/exa/exa-public-api/versions/5c7114e0ef43/schema)