Change Maintenance Window
maintenance_windowEdit, cancel, extend, or end a hosted machine's maintenance window; preview changes first with confirm=false, then confirm to apply them.
Instructions
Change one maintenance window of a hosted machine, like the buttons in the console's Maintenance tab.
maintenance_id is a window id from the machines tool (a machine's maintenance).
action "edit" changes a window that hasn't started: pass only what changes among reason, description,
start and end (ISO 8601, UTC when there is no offset). New times email the affected workspaces again, and a
regular window still needs 48 hours' notice unless it only moves later.
"cancel" removes a window that hasn't started, for good; the workspaces that were notified get no cancellation
email. "extend" makes a window in progress longer by hours (more than 0) and needs a reason, which the
affected workspaces are emailed. "end" closes a window in progress now: pods and volumes on the machine are
billed again from then on, and the machine comes back online but unlisted until it is listed again
(set_machine_listing).
There is no action to start a window: it starts by itself within about a minute of its start time.
With confirm=false (default) it only shows the window and what the action does, and changes nothing; call again
with confirm=true after the user agreed.
Every write requires operation_id. Reuse the ID returned by the preview, or generate a UUID before the first call. Keep it for confirmation and all retries; a new ID means a new operation. After a timeout, check operation_status and resource state before retrying.
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": {
"maintenance_id": "<maintenance_id>"
},
"name": "maintenance_window"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | ||
| hours | No | ||
| start | No | ||
| action | No | edit | |
| reason | No | ||
| confirm | No | ||
| description | No | ||
| operation_id | No | ||
| maintenance_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||