Skip to main content
POST
Pause, resume or delete monitors
Pause, resume or delete many monitors at once, chosen by ids, by filter, or both. dry_run defaults to true, so the first call only lists what would change. Send "dry_run": false to apply the action.

Pause monitors by tag

filter takes status, name (part of a name) and metadata, as in List monitors. This request lists the active monitors tagged team=research that a pause would affect:
The response has "dry_run": true, the matching ids and their number in affected. Nothing changes yet. Check the list, then send the same body with "dry_run": false. Deleting can’t be undone, and it removes each monitor’s results. Resuming counts toward your organization’s active monitors. See Limits.

SDK, CLI and MCP

The SDK methods need SDK 0.2.0 or later. Like the API, each SDK makes a dry run unless you turn it off. See SDKs → Monitors.

Authorizations

X-API-Key
string
header
required

Your API key, such as keen_.... Create one in the Keenable console. If you send both this header and Authorization, the API uses this one.

Body

application/json

Send ids, a filter, or both. ids must list at least one monitor, and filter must set at least one of status, name and metadata. Otherwise the API returns 400.

action
enum<string>
required
Available options:
pause,
resume,
delete
ids
string[]
required
Required array length: 1 - 500 elements
filter
object
limit
integer
default:50

The most monitors to act on.

Required range: 1 <= x <= 500
dry_run
boolean
default:true

true (the default) only reports what would change. Send false to apply the action.

Response

What changed, or would change

action
string
required
affected
integer
required

Monitors the action applied to, or would apply to, including those already in that state.

ids
string[]
required
dry_run
boolean
required
has_more
boolean
required

true if more monitors matched than limit.

not_found
string[]
required

The ids that aren't your organization's monitors.