---
title: "Update Kubernetes Cluster"
method: PATCH
path: "/kubernetes_clusters/{kubernetes_cluster_id}"
tags: ["Kubernetes Clusters"]
---

# Update Kubernetes Cluster

`PATCH /kubernetes_clusters/{kubernetes_cluster_id}`

Updates a Kubernetes cluster by scaling nodes or upgrading the Kubernetes version. The cluster must be in `Provisioned` phase to accept updates.

## Scaling Operations

Exactly one of `worker_count` or `control_plane_count` must be provided per request. You cannot scale workers and control plane nodes in the same request.

When scaling up, the API validates that sufficient server stock is available for the requested delta (e.g., scaling from 2 to 5 workers checks for 3 available servers).

When scaling from 0 workers, you must provide a `worker_plan` since there is no existing configuration to inherit the plan from.

Control plane scaling has a minimum of 1 node. You cannot scale control plane nodes to zero.

## Version Upgrades

Provide a `kubernetes_version` parameter to upgrade the cluster to a new Kubernetes version. Version upgrades follow these rules:

- **No downgrades**: You cannot downgrade to a lower version than currently installed
- **One minor version at a time**: You can only upgrade one minor version at a time (e.g., from 1.34 to 1.35, not from 1.34 to 1.36)
- **Mutually exclusive**: Version upgrades cannot be combined with scaling operations in the same request
- **Available versions only**: The target version must be in the list returned by `GET /kubernetes_clusters/available_versions`

Returns 202 Accepted when an update operation is triggered. Poll the GET endpoint to monitor progress. Returns 200 OK if no change is needed (no-op).

## Path parameters

- `kubernetes_cluster_id` string, required

## Response `200`

OK - No change needed

## Other responses

- `202` — Accepted - Update operation started
- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `503` — Service Unavailable

---

[API](https://skmtc.net/latitude/apis/latitude-sh-api.md) · [All operations](https://skmtc.net/latitude/apis/latitude-sh-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/latitude/latitude-sh-api/versions/7302d79e39bb/schema)