Update Maintenance
updateMaintenanceUpdates an existing maintenance window. Only the fields you provide are changed (the server merges them with the stored window). monitorIDs replaces the full monitor list.
Instructions
Updates an existing maintenance window. Only the fields you provide are changed (the server merges them with the stored window). monitorIDs replaces the full monitor list. To switch a window on or off use pauseMaintenance / resumeMaintenance.
Input Schema
TableJSON 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 createMaintenance) | |
| 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 wall-clock times in the window's timezone, e.g. ["2026-10-08T10:00", "2026-10-08T12:00"] — the format Uptime Kuma's own UI stores. 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 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| msg | No | ||
| monitorIDs | No | ||
| maintenanceID | Yes |