Sign in
Kubernetes

List available version upgrades

The Kubernetes versions this cluster can upgrade to right now — patch releases of its current minor and the next minor (Kubernetes upgrades one minor at a time) — plus the cluster's upgrade state, mode and maintenance window.

get/api/v1/k8s/clusters/{cluster_id}/upgrades

Path parameters

cluster_idstring required

Cluster ID (short id, e.g. q7z7zg)

Headers

X-Project-IDstring uuid required

Project ID. Required for all mutating operations (create, delete, power actions, resize).

Response

Upgrade state and available targets

successboolean
current_versionstring
upgrade_status'idle' | 'scheduled' | 'upgrading' | 'failed'
target_versionstring

Set while an upgrade is in flight or failed

upgrade_mode'manual' | 'auto_patch' | 'auto_minor'
maintenance_dayinteger

0 (Sunday) to 6 (Saturday)

maintenance_startinteger

Window start hour (UTC); the window is 4 hours

Example response

{
  "current_version": "v1.33.4+rke2r1",
  "available": [
    {
      "version": "v1.34+rke2r1",
      "rke2_version": "v1.34.6+rke2r1"
    }
  ]
}

Changes