Skip to main content
POST
Bulk action on monitors

Authorizations

Authorization
string
header
required

API key (dh_live_...) or Auth0 JWT token

Headers

Idempotency-Key
string

Replays the stored response for 24h when the same key is sent again (1–255 visible ASCII)

X-DevHelm-Client
string

Calling surface and version, e.g. cli/1.4.0 or sdk-js/2.0.0

Body

application/json

Request body for performing a bulk action on multiple monitors

monitorIds
string<uuid>[]
required

IDs of monitors to act on (max 200)

Maximum array length: 200

IDs of monitors to act on (max 200)

action
enum<string>
required

Action to apply to every monitor in the bulk request

Available options:
PAUSE,
RESUME,
DELETE,
ADD_TAG,
REMOVE_TAG,
UPDATE_SCHEDULE,
RUN,
MUTE,
UNMUTE,
ACKNOWLEDGE
tagIds
string<uuid>[] | null

Tag IDs to attach or detach (required for ADD_TAG and REMOVE_TAG)

Tag IDs to attach or detach (required for ADD_TAG and REMOVE_TAG)

newTags
object[] | null

New tags to create and attach (only for ADD_TAG)

frequencySeconds
integer<int32> | null

Check frequency in seconds for UPDATE_SCHEDULE; minimum depends on plan

Required range: 10 <= x <= 86400
overlay
object | null

Response

OK

data
object
required

Result of a bulk monitor action, including partial-success details