---
title: "Optimal Maintenance Windows"
method: GET
path: "/api/maintenance/windows"
tags: ["Maintenance"]
---

# Optimal Maintenance Windows

`GET /api/maintenance/windows`

## Request

- Base URL: `https://api.fiber.ac` (the document declares no server; this is the origin it was published from)
- URL: `https://api.fiber.ac/api/maintenance/windows`
- Auth: none declared

Finds optimal maintenance windows within the next N hours by analyzing GPU job schedules. Identifies time slots with zero GPU utilization where port replacements can be performed without impacting workloads. Returns top 3 windows (longest first) with replaceable port count estimates (15 min per port). Includes a 30-minute slot timeline for visualization.

## Query parameters

- `hours_ahead` integer

## Response `200`

Top 3 maintenance windows with start/end times, duration, replaceable ports, and GPU usage timeline

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fiber-ac/apis/fiber-api.md) · [All operations](https://skmtc.dev/fiber-ac/apis/fiber-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fiber-ac/apis/fiber-api/revisions/58267250d793?raw)