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:
PUT /api/monitors/bulk-settings
Generated from the OpenAPI 3.1 specification at https://docs.visualsentinel.com/openapi.json.