Update a cluster (admin)

put/clusters/{clusterId}

Request

Base URL: /api/v1 (relative, and the document was published on a file host, not at the API’s origin)
URL: /api/v1/clusters/{clusterId}
Auth: HTTP bearer

clusterIdstring required

namestring

Immutable. Sending a different value is a conflict.

descriptionstring

environmentstring

Immutable. Sending a different value is a conflict.

api_endpointstring

ca_bundlestring

sa_tokenstring

regionstring

Updated cluster

idstring required

org_idstring required

account_idstring required

namestring required

descriptionstring required

environment'development' | 'staging' | 'production' required

api_endpointstring required

regionstring required

auth_modestring

sa_token (stored bearer token) or eks_iam (minted from the account role).

eks_cluster_namestring

connection_status'pending' | 'connecting' | 'connected' | 'failed' required

last_connected_atstring date-time nullable required

connection_errorstring required

node_countinteger required

k8s_versionstring required

argocd_sync_statusstring required

Synced | OutOfSync | Unknown | "" (not yet observed).

argocd_health_statusstring required

control_plane_statusstring required

platform_versionstring required

EKS platform version, e.g. eks.7.

last_health_observed_atstring date-time nullable required

credentials_setboolean required

Whether CA bundle + SA token are stored; the ciphertext never leaves the server.

created_bystring required

created_atstring date-time required

updated_atstring date-time required

No recorded changes to this operation across all 14 revisions of this API.