---
title: "Update an LKS cluster"
method: PATCH
path: "/lks/clusters/{id}"
tags: ["LKS"]
---

# Update an LKS cluster

`PATCH /lks/clusters/{id}`

Renames a cluster, edits its description, or upgrades the control plane. At least one of `name`, `description` or `kubernetes_version` must be provided.

Setting a newer `kubernetes_version` consents to a control-plane upgrade; the value must be a patch listed by `GET /lks/available_versions` with `available_for_upgrade: true` and must not be lower than the current one. Node pools are upgraded separately and must never run a patch newer than the control plane.

The cluster must be idle: a cluster that is provisioning, updating, scaling, upgrading, paused or deleting rejects the request with 409.

## Path parameters

- `id` string, required

## Request body

- UpdateLksCluster
  - `data` object, required
    - `type` 'lks_clusters', required
    - `attributes` object — At least one of name, description or kubernetes_version must be provided.
      - `name` string
      - `description` string
      - `kubernetes_version` string — Setting a newer patch consents to a control-plane upgrade. Must not be lower than the current patch (422 DOWNGRADE_NOT_ALLOWED)

## Response `200`

OK

## Other responses

- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict — the cluster is not in an admissible state for this operation
- `422` — Unprocessable Entity
- `502` — Bad Gateway — NetBox is temporarily unavailable

## Changes

- **2026-09-16** `2e0ac09a58ac` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/latitude/apis/latitude-sh-api/changes/lks/clusters/:id/patch.md)

---

[API](https://skmtc.dev/latitude/apis/latitude-sh-api.md) · [All operations](https://skmtc.dev/latitude/apis/latitude-sh-api/llms.txt) · [OpenAPI document](https://skmtc.dev/latitude/apis/latitude-sh-api/revisions/3a64859195ed?raw)