---
title: "Change node status"
method: POST
path: "/nodes/{nodeID}"
tags: ["admin"]
---

# Change node status

`POST /nodes/{nodeID}`

Change status of a node

## Path parameters

- `nodeID` string, required

## Request body

- NodeStatusChange
  - `clusterID` string, uuid — Identifier of the cluster
  - `status` 'ready' | 'draining' | 'connecting' | 'unhealthy' | 'standby', required — Status of the node. - draining: the node is bound to be shut down. It will not accept new sandboxes and will stop once all existing sandboxes are done. - standby: the node is not actively used, but it can return to ready and continue serving traffic.

## Response `204`

The node status was changed successfully

## Other responses

- `401` — Authentication error
- `404` — Not found
- `409` — Conflict
- `500` — Server error

## Changes

- **2026-08-20** `e01b3f5506fe` — 4 info
  - added the optional property `error_code` to the response with the `401` status
  - added the optional property `error_code` to the response with the `404` status
  - added the optional property `error_code` to the response with the `409` status
  - added the optional property `error_code` to the response with the `500` status
- **2026-07-24** `93ed246a4c10` — 3 info
  - the endpoint scheme security `AdminApiKeyAuth` was added to the API
  - the endpoint scheme security `AdminTokenAuth` was removed from the API
  - added the non-success response with the status `409`
- **2026-05-27** `e13ef89d456c` — 1 info
  - added the new `standby` enum value to the request property `status`
- **2025-10-31** `8ee0d0d1e95e` — 1 info
  - added the new optional request property `clusterID`
- **2025-03-21** `ca973917d2e1` — 2 info
  - added the new `connecting` enum value to the request property `status`
  - added the new `unhealthy` enum value to the request property `status`

[Full history](https://skmtc.dev/e2b-dev/apis/e2b-api/changes/nodes/:nodeID/post.md)

---

[API](https://skmtc.dev/e2b-dev/apis/e2b-api.md) · [All operations](https://skmtc.dev/e2b-dev/apis/e2b-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/e2b-dev/e2b-api/revisions/e01b3f5506fe/schema)