norcube monitor maintenance update
Change a maintenance window, as far as where it stands allows
Changes only what you pass.
Before the window starts, everything can change; moving a time by 5 minutes or more tells subscribers who were already told. Once it has started, its targets and start are frozen: you can still change the text and the mail switches, and extend or shorten it, which sends no mail. Once it is over, only the text can change. A cancelled window can't change. The API refuses anything else with exit 8.
--monitor, --component and --status-page replace the targets as a whole, so name everything the window should keep. --duration counts from the new --start, or else from the window's current start.
A CI token needs the monitor.maintenance scope, and monitor.statuspages too when the window shows on a published page before or after the change. To end a window now, use "finish"; to call off one that hasn't started, use "cancel".
Usage
norcube monitor maintenance update <window> [flags]Examples
# The deploy needs longer
norcube monitor maintenance update 4d3c2b1a-0f9e-4d8c-b7a6-5f4e3d2c1b0a --end +1h
norcube monitor maintenance update 4d3c2b1a-0f9e-4d8c-b7a6-5f4e3d2c1b0a --start 2026-11-08T14:00:00Z --duration 2h
norcube monitor maintenance update 4d3c2b1a-0f9e-4d8c-b7a6-5f4e3d2c1b0a --title "Database upgrade" --no-notifyFlags
| Flag | Default | Description |
|---|---|---|
--component | A manual status page component to mark, by id or exact name (repeatable) | |
--description | What is happening; public on a published status page and in mail | |
--duration | How long it lasts, counted from its start: 15m, 2h, 7d (at most 30 days) | |
--end | When it ends: an RFC 3339 timestamp, now, or a span from now (+2h, +7d) | |
--monitor | A monitor to hold, by id or exact name (repeatable); domain monitors can't be held | |
--no-notify | Turn off all three mails; a cancellation still tells whoever was told | |
--notify-finished | Email subscribers when it finishes | |
--notify-scheduled | Email subscribers when it is scheduled | |
--notify-started | Email subscribers when it starts | |
--start | Move its start, before it has started: an RFC 3339 timestamp or a span from now (+2h, +7d) | |
--status-page | Everything a status page shows right now, by id or exact slug (repeatable); something added to the page later isn't included | |
--title | The window's title; public on a published status page |
Every command also takes the global flags: --profile, --org, -o, --query, --debug and more.
See also
norcube monitor maintenance: Schedule maintenance windows that pause alerts and stay out of uptime