Update Maintenance Window
updateMaintenanceWindowUpdate an existing Uptime Kuma maintenance window by changing only the fields you pass; monitor and status page lists are replaced when included.
Instructions
Updates an existing maintenance window. Only the fields you pass change, except monitorIDs and statusPageSlugs, which each replace the whole list. To switch a window on or off use setMaintenanceWindowActive. Find the ID with listMaintenanceWindows.
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": {
"maintenanceID": "<maintenanceID>"
},
"name": "updateMaintenanceWindow"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cron | No | Cron expression for when the window starts, e.g. "30 3 * * *" (03:30 daily), for the cron strategy | |
| title | No | Title of the maintenance window | |
| strategy | No | Scheduling strategy (see createMaintenanceWindow) | |
| timezone | No | Timezone the dates and times are in (e.g. "America/New_York", "UTC"). Omit to follow the server timezone. | |
| weekdays | No | Days of week (0=Sunday … 6=Saturday) for recurring-weekday strategy | |
| dateRange | No | [start, end] as local times in the window's timezone, e.g. ["2026-10-08T10:00", "2026-10-08T12:00"]. Required for single; optional bounds for recurring strategies; ignored for manual. | |
| timeRange | No | Daily [{hours, minutes}, {hours, minutes}] start and end. Required for the recurring-* strategies, ignored otherwise. | |
| monitorIDs | No | IDs of the monitors this window suppresses. A window with no monitors suppresses nothing. On update this REPLACES the current list; pass [] to detach all. | |
| daysOfMonth | No | Days of month (1-31) for recurring-day-of-month strategy | |
| description | No | Description or reason for the maintenance | |
| intervalDay | No | Interval in days for recurring-interval strategy | |
| maintenanceID | Yes | The ID of the maintenance window to update | |
| durationMinutes | No | How long each window lasts, in minutes, for the cron strategy | |
| statusPageSlugs | No | Slugs of the status pages that announce this window while it is in effect. On update this REPLACES the current list; pass [] to remove it from all. Find slugs with listStatusPages. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| msg | No | ||
| monitorIDs | No | ||
| maintenanceID | Yes | ||
| statusPageSlugs | No |