UPuptimerobot
Monitors - Bulk Operations

Update monitors by group and/or tag

Changed on

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

  • Base URL
    https://api.uptimerobot.com/v3
  • URL
    https://api.uptimerobot.com/v3/monitors/bulk/update
  • Auth
    HTTP bearer

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

Changes

  • 191b37343aa3Revision changes
    • warning

      added the new 027-016 enum value to the response property for the response status

  • 8c686e2fe60aRevision changes
    • warning

      added the new 004-048 enum value to the response property for the response status

    • warning

      added the new 011-034 enum value to the response property for the response status

    • warning

      added the new 031-001 enum value to the response property for the response status

    • warning

      added the new 031-002 enum value to the response property for the response status

    • warning

      added the new 031-003 enum value to the response property for the response status

    • warning

      added the new 031-004 enum value to the response property for the response status

    • warning

      added the new 031-005 enum value to the response property for the response status