---
title: "Set upgrade mode and maintenance window"
method: PATCH
path: "/api/v1/k8s/clusters/{cluster_id}/maintenance"
tags: ["Kubernetes"]
---

# Set upgrade mode and maintenance window

`PATCH /api/v1/k8s/clusters/{cluster_id}/maintenance`

`manual` (default) — you start upgrades yourself. `auto_patch` — patch releases are applied automatically in the maintenance window (notice email ~72h before). `auto_minor` — minors too, after a stability period. The window is 4 hours from `maintenance_start` (UTC) on `maintenance_day`.

## Path parameters

- `cluster_id` string, required

## Headers

- `X-Project-ID` string, uuid, required

## Request body

- object
  - `upgrade_mode` 'manual' | 'auto_patch' | 'auto_minor', required
  - `maintenance_day` integer — 0 (Sunday) to 6 (Saturday)
  - `maintenance_start` integer — Window start hour (UTC)

## Response `200`

Settings updated

- SuccessResponse
  - `success` boolean
  - `message` string

## Other responses

- `400` — Invalid mode or window
- `404` — Resource not found

---

[API](https://skmtc.dev/rafftechnologies/apis/raff-api.md) · [All operations](https://skmtc.dev/rafftechnologies/apis/raff-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rafftechnologies/raff-api/revisions/2f4df56be77c/schema)