Cluster Operations

List cluster upgrades

Returns the upgrade history for the cluster, including any in-progress upgrade.

Required scope: clusters:read

get/clusters/{cluster_id}/upgrades

Request

  • Base URL: http://localhost:8000
  • URL: http://localhost:8000/clusters/{cluster_id}/upgrades
  • Auth: API key in header API-Key

Path parameters

cluster_idstring uuid required

Headers

API-Version'2026-06-01.beta' required

Response

The request has succeeded.

idstring required

Unique upgrade identifier.

from_versionstring required

Cluster version in semver format. Check the documentation for the latest supported versions.

to_versionstring required

Cluster version in semver format. Check the documentation for the latest supported versions.

phasestring required

Current upgrade phase. One of: initiated, completed, cancelled, failed, timed_out.

started_atstring date-time required

When the upgrade was initiated.

completed_atstring date-time nullable required

When the upgrade completed or was cancelled. Absent if the upgrade is still in progress.

Example response

[
  {
    "from_version": "26.5.5",
    "to_version": "26.5.5"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.