Sign in

v1

latestOpenAPI 3.1.02026-07-13897404.3 KB
Machines

schedule maint

Schedules a maintenance window for a specified machine and notifies clients.

CLI Usage: vastai schedule maint <machine_id> --sdate <sdate> --duration <duration>

put/api/v0/machines/{machine_id}/dnotify

Path parameters

machine_idinteger required
Example:12345

ID of the machine to schedule maintenance for.

Request body

sdatestring date-time required

Start date and time of the maintenance window.

durationinteger required

Duration of the maintenance window in hours.

maintenance_reasonstring

Reason for the maintenance.

maintenance_category'power' | 'internet' | 'disk' | 'gpu' | 'software' | 'other'

Category of the maintenance.

Example request

{
  "sdate": "2023-10-30T14:00:00Z",
  "duration": 2,
  "maintenance_reason": "Routine hardware check",
  "maintenance_category": "software"
}

Response

Success response

successboolean
you_sentstring

Example response

{
  "success": true,
  "you_sent": "2 notifications sent"
}