Schedule maintenance
create_maintenance_windowSchedules maintenance for one monitor or all: no incidents or alerts while it lasts (suppress_alerts), and with announce the status pages that show it list it and tell their subscribers. With recurrence it repeats daily, weekly on chosen days or monthly, in the workspace's time zone (get_account), starting with starts_at to ends_at. Every plan. 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": {
"name": "<name>",
"starts_at": "<starts_at>",
"ends_at": "<ends_at>"
},
"name": "create_maintenance_window"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | What the maintenance is, such as Database upgrade. | |
| ends_at | Yes | 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 | Yes | When it starts, ISO 8601; the first occurrence of a repeating window. | |
| 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. |