---
title: "Update monitors by group and/or tag"
method: POST
path: "/monitors/bulk/update"
tags: ["Monitors - Bulk Operations"]
---

# Update monitors by group and/or tag

`POST /monitors/bulk/update`

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.

## Request body

- PublicBulkUpdateDto
  - `groupId` number — ID of the monitor group to filter by (0 = default group / ungrouped monitors). At least one of groupId or tagId must be provided.
  - `tagId` number — 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.
  - `interval` number — Monitoring interval in seconds
  - `timeout` number — Timeout in seconds
  - `gracePeriod` number — Grace period in seconds
  - `checkSSLErrors` boolean — Whether to check for SSL errors
  - `domainExpirationReminder` boolean — Whether to enable domain expiration reminder
  - `sslExpirationReminder` boolean — Whether to enable SSL expiration reminder
  - `responseTimeThreshold` number — Response time threshold in milliseconds
  - `regionalData` RegionalDataDto
    - `REGION` string[], required
    - `THRESHOLD` object — Regional threshold values in milliseconds mapped by region code
      - `na` number
      - `eu` number
      - `as` number
      - `oc` number
    - `MANUAL_SELECTED` boolean
  - `customFields` object — 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.

## Response `201`

- BulkOperationResponseDto
  - `results` object[], required
    - `monitorId` number, required
    - `monitorName` string
    - `status` 'success' | 'error', required
    - `error` string
    - `code` string
  - `totalSuccess` number, required
  - `totalError` number, required

---

[API](https://skmtc.net/uptimerobot/apis/uptimerobot-api.md) · [All operations](https://skmtc.net/uptimerobot/apis/uptimerobot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uptimerobot/uptimerobot-api/revisions/2b6fa8c427ba/schema)