Schedule Maintenance
schedule_maintenanceSchedules a maintenance window for a hosted machine, previews who will be emailed, and confirms before applying it.
Instructions
Schedule a maintenance window on a hosted machine, like the console's Maintenance tab. machine is the
machine_id from the machines tool, reason is required, and start and end are ISO 8601 times (UTC when
they have no offset).
The workspaces using the machine are emailed when it is scheduled. While the window is open their pods and
volumes on it aren't billed and the machine earns nothing from them; pods keep running unless the work
interrupts them. A regular window must start at least 48 hours ahead (insufficient_notice) and doesn't affect
the uptime rate. emergency can start sooner but counts as downtime for the hours a client workload runs on
the machine: set it only when the user chose emergency maintenance, never just to get past the notice.
With confirm=false (default) it only checks the window and says who would be emailed, and schedules nothing;
call again with confirm=true after the user agreed. The window starts by itself within about a minute of its
start time; edit, extend, end or cancel it with maintenance_window.
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": {
"machine": "<machine>",
"reason": "<reason>",
"start": "<start>",
"end": "<end>"
},
"name": "schedule_maintenance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | Yes | ||
| start | Yes | ||
| reason | Yes | ||
| confirm | No | ||
| machine | Yes | ||
| emergency | No | ||
| description | No | ||
| operation_id | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||