Change a maintenance window
update_maintenance_windowChanges a maintenance window or every occurrence of a repeating one. Fields left out keep their value; recurrence null makes it a single window. Changing the times or recurrence undoes skipped and moved occurrences. Free.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"window_id": "<window_id>"
},
"name": "update_maintenance_window"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | What the maintenance is, such as Database upgrade. | |
| ends_at | No | When it ends, after starts_at. | |
| message | No | What visitors are told about the maintenance. | |
| announce | No | Show the window on the status pages that show its monitor (every page of the workspace without a monitor), and tell their subscribers, one occurrence at a time. | |
| starts_at | No | When it starts, ISO 8601; the first occurrence of a repeating window. | |
| window_id | Yes | Maintenance window ID from list_maintenance_windows. | |
| monitor_id | No | The monitor under maintenance; leave out or null for every monitor. | |
| recurrence | No | How the window repeats; `null` or left out for a single window. starts_at and ends_at are then the first occurrence, and every other one starts at the same time of day in time_zone, daylight saving time or not, and lasts as long. | |
| suppress_alerts | No | false keeps the window on record without holding alerts back. |