Retune monitor
update_monitorDestructiveIdempotent
Change how loudly a monitor is watched: check interval, alert confirmations, recovery notices, reminder interval, tags, group, the multi-region detection quorum, and which notification channels it alerts (channel_ids replaces the whole set, and needs the channels:read scope). It cannot change what the check watches — name, address, assertions, expected status, headers, body, probe regions and owner are refused. A monitor managed by Terraform is refused outright. Shows the old and new value of every field before it runs, where the client can show a prompt; otherwise runs on the token's scope. Not read-only.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The monitor id (from `list_monitors`). | |
| tags | No | Replaces the whole tag list. Read the monitor first: a tag left out of this list is removed. At most 50 tags, each at most 50 characters. | |
| group_name | No | Operator-side grouping label. Send `null` to clear it; omit to keep it. | |
| channel_ids | No | Replaces the whole set of alerted channels, by id from `list_notification_channels`. Read the monitor first: a channel left out of this list stops being alerted. An empty list silences the monitor. | |
| interval_secs | No | Seconds between checks. Held to the plan's floor and the check kind's own floor, whichever is higher. | |
| region_policy | No | Detection quorum across probe regions. | |
| notify_recovery | No | Whether recovery is announced to the monitor's channels. | |
| alert_confirmations | No | Consecutive failing checks before the monitor alerts. Minimum 1. Raising it quietens a flapping monitor at the cost of alerting later. | |
| recovery_period_secs | No | Seconds a recovered monitor must stay healthy before its incident closes, 0 to 1800. Raising it folds a flapping monitor's short outages into one incident, at the cost of announcing recovery later. | |
| renotify_interval_secs | No | Seconds before the first reminder while an outage stays unacknowledged; each further reminder waits twice as long, up to a day. 0 turns reminders off; otherwise at least 60. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| changes | Yes | What moved. Empty when every value sent already matched the stored one, in which case nothing was written and no confirmation was asked for. |