Create Maintenance Window
createMaintenanceWindowSchedules maintenance windows so selected Uptime Kuma monitors report MAINTENANCE instead of DOWN and suppress alerts during planned downtime.
Instructions
Schedules a new maintenance window: while it is in effect the monitors in monitorIDs show MAINTENANCE instead of DOWN and do not alert. A window without monitorIDs suppresses nothing. strategy sets the schedule; "manual" makes a window you switch on and off with setMaintenanceWindowActive. To stop one monitor's checks outright use setMonitorActive.
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": {
"title": "<title>",
"strategy": "<strategy>"
},
"name": "createMaintenanceWindow"
}
}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 | Yes | Title of the maintenance window | |
| active | No | Whether the window is active (default: true). For a manual window, active means in maintenance right now. | |
| strategy | Yes | Scheduling strategy: single=one-time, recurring-interval=every N days, recurring-weekday=specific weekdays, recurring-day-of-month=specific dates, cron=starts on a cron expression and lasts durationMinutes, manual=on whenever active | |
| 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 | |
| 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 | No | ||
| statusPageSlugs | No |