Skip to main content
GET
List available version upgrades
Updated August 24, 2026

Authorizations

X-API-Key
string
header
required

API key for authentication. Each key is bound to a specific account.

Headers

X-Project-ID
string<uuid>
required

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

Path Parameters

cluster_id
string
required

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

Response

Upgrade state and available targets

success
boolean
current_version
string
Example:

"v1.33.4+rke2r1"

upgrade_status
enum<string>
Available options:
idle,
scheduled,
upgrading,
failed
target_version
string

Set while an upgrade is in flight or failed

upgrade_mode
enum<string>
Available options:
manual,
auto_patch,
auto_minor
maintenance_day
integer

0 (Sunday) to 6 (Saturday)

maintenance_start
integer

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

available
object[]
Last modified on August 24, 2026