---
title: "Delete worker nodes"
method: DELETE
path: "/v1/kubernetes/{kubernetesId}/nodes"
tags: ["Kubernetes clusters"]
---

# Delete worker nodes

`DELETE /v1/kubernetes/{kubernetesId}/nodes`

## Request

- Base URL: `https://api.emma.ms/external`
- URL: `https://api.emma.ms/external/v1/kubernetes/{kubernetesId}/nodes`
- Auth: HTTP bearer

Removes one or more worker nodes from a Managed Kubernetes cluster without a full cluster-update request. The operation is asynchronous: the method returns 204 and the nodes are drained and deleted in the background. Progress is observable via the cluster GET (the nodes stay visible in a deleting status until the underlying compute instances are removed — that is when billing is released).

Nodes that belong to an autoscaling group cannot be removed through this endpoint — change the group configuration instead.

## Path parameters

- `kubernetesId` integer, required

## Query parameters

- `nodeId` integer[], required

## Response `204`

Request accepted; the nodes are being deleted

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict
- `422`: Unprocessable entity
- `500`: Internal server error

---

[API](https://skmtc.dev/emma/apis/public-emma-api.md) - [All operations](https://skmtc.dev/emma/apis/public-emma-api/llms.txt) - [OpenAPI document](https://skmtc.dev/emma/apis/public-emma-api/revisions/9e55f0920078?raw)