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

# POST /nodes/{nodeID}

`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
- `500` — Server error

## Changes

- **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`
- **2025-01-17** `7043712f7bb5` — 1 info
  - endpoint added
- **2023-11-15** `897ba2f1c7b6` — 1 breaking
  - api path removed without deprecation

[Change 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/edf2d2943a24/schema)