Skip to main content
POST
Batch Schedule Maintenances

Authorizations

Authorization
string
header
required

API key must be provided in the Authorization header

Body

application/json
machine_ids
array

List of machine IDs (1–100 entries) to schedule maintenance for; non-owned IDs are reported as failures.

Example:
sdate
number

Unix timestamp for the maintenance start time; must be in the future and within 1 year.

Example:

1718100000

duration
number

Duration of the maintenance window in hours; minimum effective value is 1. Defaults to 1 if omitted.

Example:

4

maintenance_category
enum<string>

Category describing the reason for maintenance. Defaults to "other" if omitted.

Available options:
power,
internet,
disk,
gpu,
software,
other
Example:

"power"

Response

{success: true, results: [{success, machine_id, notifications_sent}, ...]} when at least one machine was successfully scheduled.

success
boolean

true if at least one machine was successfully scheduled

results
object[]

Per-machine outcome list, including successes, not-found, and invalid entries