---
title: "Drain Node"
method: POST
path: "/cluster/nodes/{node_id}/drain"
---

# Drain Node

`POST /cluster/nodes/{node_id}/drain`

Start draining a node -- cordon + signal agents to finish.

## Path parameters

- `node_id` string, required

## Response `200`

Successful Response

- object

## Other responses

- `401` — Cluster authentication failed
- `404` — Node not found
- `422` — Validation Error

## Changes

- **2026-07-26** `2a1299ef19fa` — 2 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `404`

[Change history](https://skmtc.dev/sipyourdrink-ltd/apis/bernstein-task-server/changes/cluster/nodes/:node_id/drain/post.md)

---

[API](https://skmtc.dev/sipyourdrink-ltd/apis/bernstein-task-server.md) · [All operations](https://skmtc.dev/sipyourdrink-ltd/apis/bernstein-task-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sipyourdrink-ltd/bernstein-task-server/revisions/7f4871ff054a/schema)
