List available version upgrades
Clusters
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
List available version upgrades
Updated August 24, 2026
Authorizations
API key for authentication. Each key is bound to a specific account.
Headers
Project ID. Required for all mutating operations (create, delete, power actions, resize).
Path Parameters
Cluster ID (short id, e.g. q7z7zg)
Response
Upgrade state and available targets
Example:
"v1.33.4+rke2r1"
Available options:
idle, scheduled, upgrading, failed Set while an upgrade is in flight or failed
Available options:
manual, auto_patch, auto_minor 0 (Sunday) to 6 (Saturday)
Window start hour (UTC); the window is 4 hours
Last modified on August 24, 2026