Change a monitor's settings
update_monitorDestructiveIdempotent
Use this when the user wants to change how a site or one of its checks is watched: a site's name, interval, timeout or group; a content check's text, selector, page, kind, attribute, limits, description, severity or interval; a dependency's name, description, severity or interval, and a plain HTTP dependency's URL and expected text; a cron job's schedule, grace period, longest run, description or severity. Returns the settings now in force. Only the fields given change. Not for pausing (use set_monitor_paused), deleting (the dashboard does that), or a dependency's components (plan it again with plan_dependency). Each setting is documented at https://flarewarden.com/docs/monitors.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| max | No | A content check's highest value allowed, for numeric_range or element_count. | |
| min | No | A content check's lowest value allowed, for numeric_range or element_count. | |
| url | No | A plain HTTP dependency's URL; a status page dependency is changed with plan_dependency. | |
| name | No | The site's new name, or with check, the check's. | |
| page | No | A content check's page path. | |
| site | Yes | The site, by id, name or part of its URL. | |
| text | No | A content check's text or pattern. | |
| check | No | One of the site's content checks, dependencies or cron jobs, by id or name; leave out to change the site itself. | |
| grace | No | A cron job's grace period in seconds. | |
| group | No | A site's group; an empty string removes it. | |
| match | No | How expected_text is matched. Default contains. | |
| max_run | No | A cron job's longest normal run in seconds; 0 turns it off. | |
| timeout | No | Seconds a site's checks wait for an answer before they count as failed (5, 10, 15 or 30; 10 unless changed). A longer one lets a slow page pass. | |
| interval | No | Seconds between checks (30, 60, 300, 600, 1800 or 3600, as the plan allows). | |
| schedule | No | A cron job's schedule: a cron expression (UTC), every N minutes, hours or days, or heartbeat. | |
| selector | No | A content check's CSS selector. | |
| severity | No | How serious a failure is. | |
| attribute | No | A content check's attribute to read, for attribute_check. | |
| check_type | No | A content check's kind. | |
| description | No | A check's description. | |
| expected_text | No | A plain HTTP dependency's text its answer must hold (or, with match, must not hold or match); an empty string stops checking it. | |
| case_sensitive | No | Whether a content check matches case exactly. |