---
title: "Update an SKS cluster"
method: PUT
path: "/sks-cluster/{id}"
tags: ["cluster"]
---

# Update an SKS cluster

`PUT /sks-cluster/{id}`

## Request

- Base URL: `https://api-ch-gva-2.exoscale.com/v2`
- URL: `https://api-ch-gva-2.exoscale.com/v2/sks-cluster/{id}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/exoscale/apis/exoscale-api/docs/sks-cluster/:id/put.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `description` string, nullable: Cluster description
  - `labels` SksClusterLabels
  - `auto-upgrade` boolean: Enable auto upgrade of the control plane to the latest patch version available
  - `oidc` SksOidc: SKS Cluster OpenID config map
    - `client-id` string, required: OpenID client ID
    - `issuer-url` string, required: OpenID provider URL
    - `username-claim` string: JWT claim to use as the user name
    - `username-prefix` string: Prefix prepended to username claims
    - `groups-claim` string: JWT claim to use as the user's group
    - `groups-prefix` string: Prefix prepended to group claims
    - `required-claim` object: A key value map that describes a required claim in the ID Token
  - `name` string: Cluster name
  - `enable-operators-ca` boolean: Add or remove the operators certificate authority (CA) from the list of trusted CAs of the api server. The default value is true
  - `feature-gates` string[], nullable: A list of Kubernetes-only Alpha features to enable for API server component
  - `addons` string[]: Cluster addons
  - `audit` SksAuditUpdate: Kubernetes Audit parameters
    - `endpoint` string
    - `bearer-token` string
    - `initial-backoff` string
    - `enabled` boolean: Enable or Disable Kubernetes Audit

## Response `200`

200

- Operation: Operation
  - `id` string, uuid: Operation ID
  - `reason` 'incorrect' | 'unknown' | 'unavailable' | 'forbidden' | 'busy' | 'fault' | 'partial' | 'not-found' | 'interrupted' | 'unsupported' | 'conflict': Operation failure reason
  - `reference` object: Related resource reference
    - `id` string, uuid: Reference ID
    - `link` string: Link to the referenced resource
    - `command` string: Command name
  - `message` string: Operation message
  - `state` 'failure' | 'pending' | 'success' | 'timeout': Operation status

## Changes

- **2026-03-16** `e05707a7b346`: 2 info
  - api tag `cluster` added
  - api tag `sks` removed
- **2025-11-14** `352cae63dff6`: 2 info
  - added the new optional request property `audit`
  - added the new `karpenter` enum value to the request property `addons/items/`
- **2025-05-22** `37a05010e8b4`: 2 info
  - added the new optional request property `enable-operators-ca`
  - added the new optional request property `feature-gates`
- **2024-05-22** `d1903c399d90`: 2 info
  - the request property `description` became nullable
  - added the new `exoscale-container-storage-interface` enum value to the request property `addons/items/`
- **2023-06-06** `cf7b08181585`: 1 breaking, 2 info
  - the request property `description` became not nullable
  - added the new optional request property `oidc`
  - the `description` request property's minLength was decreased from `1` to `0`

[Operation history](https://skmtc.dev/exoscale/apis/exoscale-api/changes/sks-cluster/:id/put.md)

---

[API](https://skmtc.dev/exoscale/apis/exoscale-api.md) - [All operations](https://skmtc.dev/exoscale/apis/exoscale-api/llms.txt) - [OpenAPI document](https://skmtc.dev/exoscale/apis/exoscale-api/revisions/63da6f74c845?raw)