Skip to main content
POST
Query Maintenance Windows by Machine IDs

Authorizations

Authorization
string
header
required

API key must be provided in the Authorization header

Body

application/json
machine_ids
array

List of machine IDs (integers, comma-separated string, or a single integer) to retrieve active maintenance windows for.

Example:
ctime
number

Unix timestamp used as the reference 'current time' for filtering out already-ended windows; defaults to server's current time.

Example:

1718000000

Response

Array of maintenance window objects with fields: id, machine_id, duration_hours, start_time, maintenance_category.

id
integer

Maintenance record ID

machine_id
integer

ID of the machine

duration_hours
integer

Duration of the maintenance window in hours

start_time
number

Unix timestamp when maintenance begins

maintenance_category
string

Category of maintenance (power, internet, disk, gpu, software, other)