---
title: "Get the cluster maintenance window"
method: GET
path: "/clusters/{cluster_id}/maintenance-window"
tags: ["Cluster Operations"]
---

# Get the cluster maintenance window

`GET /clusters/{cluster_id}/maintenance-window`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/clusters/{cluster_id}/maintenance-window`
- Auth: API key in header `API-Key`

Returns the cluster's own maintenance window, or `404` if it has none set (it then follows the workspace default).

Required scope: `clusters:read`

## Path parameters

- `cluster_id` string, uuid, required

## Headers

- `API-Version` '2026-06-01.beta', required

## Response `200`

The request has succeeded.

- MaintenanceWindow: A cluster maintenance window: when Skycloak applies upgrades and other disruptive changes.
  - `enabled` boolean, required: Whether the window is active.
  - `days_of_week` integer[], required: Days of week the window applies to (0 = Sunday ... 6 = Saturday).
  - `start_local` string, required: Local start time, `HH:MM`.
  - `end_local` string, required: Local end time, `HH:MM`.
  - `timezone` string, required: IANA timezone, e.g. `Europe/Berlin`.

## Other responses

- `401`: Access is unauthorized.
- `404`: The server cannot find the requested resource.
- `429`: Client error
- `500`: Server error
- `501`: Server error

---

[API](https://skmtc.dev/skycloak/apis/skycloak-public-api.md) · [All operations](https://skmtc.dev/skycloak/apis/skycloak-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skycloak/apis/skycloak-public-api/revisions/33a69e2ce35f?raw)