> For the complete documentation index, see [llms.txt](https://docs.visualsentinel.com/llms.txt)

# MonitorBulkSettings data model

Every field is optional; only the fields sent are changed. At least one is required, and unknown fields are rejected.

## Fields

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `checkInterval` | integer | No | Seconds between checks. Your plan minimum still applies per monitor. Minimum 30, maximum 86400. |
| `timeout` | integer | No | Request timeout in milliseconds. Minimum 1000, maximum 120000. |
| `alertThreshold` | integer | No | Confirmed failed checks in a row before the down alert. Minimum 1, maximum 10. |
| `locations` | array of string | No | Check regions, for example `EU` or `US`. Regions your plan does not include, or that are unavailable, cause that monitor to be skipped. Min items 1, max items 5. |
| `followRedirects` | boolean | No |   |
| `sslCheck` | boolean | No |   |
| `visualEnabled` | boolean | No | Turn visual monitoring on or off. Plan and monitor-type rules apply per monitor. |
| `domainExpiryEnabled` | boolean | No |   |
| `reminders` | string | No | `standard` sets certificate reminders to 13, 3 and 1 days before expiry and domain reminders to 50, 13, 3 and 1 days; `none` clears both lists. One of: `standard`, `none`. |
| `visualSummary` | object | No | Small visual changes in a summary email instead of an alert. Merged into each monitor's visual settings. |
| `visualSummary.threshold` | number or null | Yes | Include changes from this percent of the page. `null` turns the summary off. Minimum 0.1, maximum 100. |
| `visualSummary.cadence` | string | No | One of: `weekly`, `daily`. |
| `visualAlertLevel` | number | No | Alert when this percent of the page changes (each monitor's visual alert level). Sent only to monitors with visual checks on, or turned on in the same request; it never turns visual checks on. A monitor where it was left alone is listed in `skipped` with that reason, even when its other settings changed. Like the monitor's own settings, a level at or below the monitor's small-changes summary level is saved and the summary is paused; such a monitor is also listed in `skipped` with that reason. Minimum 0.1, maximum 30. |
| `maxResponseTime` | integer | No | Slow-response limit in milliseconds: a check that takes longer counts as slow. Minimum 2000, maximum 30000. |

## Used by

- [Change settings on a batch of monitors](https://docs.visualsentinel.com/reference/monitors.md#bulk-update-monitor-settings): `PUT /api/monitors/bulk-settings`

Generated from the OpenAPI 3.1 specification at [https://docs.visualsentinel.com/openapi.json](https://docs.visualsentinel.com/openapi.json).