Sign in

v4

latestOpenAPI 3.0.02026-08-0559120263.4 KB
Monitors - Bulk Operations

Update monitors by group and/or tag

Updates settings for monitors matching the specified filters. Provide groupId, tagId, or both. When both are given, only monitors matching both filters are affected. Returns per-monitor results.

post/monitors/bulk/update

Request body

groupIdnumber

ID of the monitor group to filter by (0 = default group / ungrouped monitors). At least one of groupId or tagId must be provided.

tagIdnumber

ID of the tag to filter by. At least one of groupId or tagId must be provided. When both groupId and tagId are specified, only monitors matching both filters are affected.

intervalnumber

Monitoring interval in seconds

timeoutnumber

Timeout in seconds

gracePeriodnumber

Grace period in seconds

checkSSLErrorsboolean

Whether to check for SSL errors

domainExpirationReminderboolean

Whether to enable domain expiration reminder

sslExpirationReminderboolean

Whether to enable SSL expiration reminder

responseTimeThresholdnumber

Response time threshold in milliseconds

customFieldsobject

Custom key-value metadata to set on all monitors in the group. Max 20 keys. Keys: alphanumeric + underscore + hyphen, max 64 chars. Values: max 255 chars. Paid plans only.

Example request

{
  "groupId": 1,
  "tagId": 42,
  "interval": 60,
  "timeout": 30,
  "gracePeriod": 300,
  "regionalData": {
    "THRESHOLD": {
      "na": 5000,
      "eu": 6000,
      "as": 7000,
      "oc": 8000
    }
  },
  "customFields": {
    "environment": "production",
    "team": "platform"
  }
}

Response

totalSuccessnumber required
totalErrornumber required