---
title: dots.v2.kubernetes.clusters.byCluster_id().upgrade.post()
description: Upgrade a Kubernetes Cluster
product: Reference
url: https://docs.digitalocean.com/reference/dots/reference/kubernetes/kubernetes-upgrade-cluster/
last_updated: "2026-11-18"
---

> **For AI agents:** The documentation index is at [https://docs.digitalocean.com/llms.txt](https://docs.digitalocean.com/llms.txt). Markdown versions of pages use the same URL with `index.html.md` in place of the HTML page (for example, append `index.html.md` to the directory path instead of opening the HTML document).

# dots.v2.kubernetes.clusters.byCluster_id().upgrade.post()

Generated on 18 Nov 2026 from DoTs version [`v1.25.0`](https://github.com/digitalocean/dots/releases/tag/v1.25.0)

## Usage

```typescript
client.v2.kubernetes.clusters.byCluster_id(cluster_id).upgrade.post(body: UpgradePostRequestBody, requestConfiguration?: RequestConfiguration<object>): Promise<void>
```

## Description

To immediately upgrade a Kubernetes cluster to a newer patch release of Kubernetes, send a POST request to [`/v2/kubernetes/clusters/{cluster_id}/upgrade`](https://docs.digitalocean.com/reference/api/reference/kubernetes/index.html.md#kubernetes_upgrade_cluster). The body of the request must specify a version attribute.

Available upgrade versions for a cluster can be fetched from [`/v2/kubernetes/clusters/{cluster_id}/upgrades`](https://docs.digitalocean.com/reference/api/reference/kubernetes/index.html.md#kubernetes_get_availableUpgrades).

## Parameters

### Path Parameters

`cluster_id` string required

Example: `bd5f5959-5e1e-4205-a714-a914373942af`

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

Min: `1`

### Request Body

`version` string optional

Example: `1.16.13-do.0`

The slug identifier for the version of Kubernetes that the cluster will be upgraded to.

## Request Sample

## Show Request Sample

```typescript
import { FetchRequestAdapter } from "@microsoft/kiota-http-fetchlibrary";
import {
    createDigitalOceanClient,
    DigitalOceanApiKeyAuthenticationProvider,
} from "@digitalocean/dots";

const authProvider = new DigitalOceanApiKeyAuthenticationProvider(process.env.DIGITALOCEAN_TOKEN!);
const adapter = new FetchRequestAdapter(authProvider);
const client = createDigitalOceanClient(adapter);

await client.v2.kubernetes.clusters
    .byCluster_id("bd5f5959-5e1e-4205-a714-a914373942af").upgrade.post({
    version: "1.16.13-do.0",
});
```

## More Information

See [`/v2/kubernetes/clusters/{cluster_id}/upgrade`](https://docs.digitalocean.com/reference/api/reference/kubernetes/index.html.md#kubernetes_upgrade_cluster) in the API reference for additional detail on responses, headers, parameters, and more.