v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB
DigitalOcean-public.v2-new_Kubernetes

Retrieve Available Upgrades for an Existing Kubernetes Cluster

To determine whether a cluster can be upgraded, and the versions to which it can be upgraded, send a GET request to /v2/kubernetes/clusters/$K8S_CLUSTER_ID/upgrades.

get/v2/kubernetes/clusters/{cluster_id}/upgrades

Path parameters

cluster_idstring uuid required

A unique ID that can be used to reference a Kubernetes cluster.

Response

The response will be a JSON object with a key called available_upgrade_versions. The value of this will be an array of objects, representing the upgrade versions currently available for this cluster.

If the cluster is up-to-date (i.e. there are no upgrades currently available) available_upgrade_versions will be null.

Example response

{
  "available_upgrade_versions": [
    {
      "slug": "1.16.13-do.0",
      "kubernetes_version": "1.16.13",
      "supported_features": [
        "cluster-autoscaler",
        "docr-integration",
        "token-authentication"
      ]
    }
  ]
}