---
title: "Request host drain"
method: POST
path: "/v1/pools/{id}/hosts/{host}/drain"
tags: ["Pools"]
---

# Request host drain

`POST /v1/pools/{id}/hosts/{host}/drain`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/pools/{id}/hosts/{host}/drain`
- Auth: HTTP bearer

Marks the host draining. The observe agent receives desired drain state. Customer processes continue running.

## Path parameters

- `id` string, required
- `host` string, required

## Response `200`

Request host drain

- PoolHost
  - `id` string, required
  - `pool_id` string, required
  - `name` string, required
  - `agent_version` string, required
  - `agent_mode` string, required
  - `state` 'enrolling' | 'ready' | 'draining' | 'lost' | 'removed', required
  - `inventory` PoolHostInventory, required
    - `hostname` string, required
    - `kernel` string, required
    - `container_runtime` string
    - `memory_mb` integer, required
    - `disk_mb` integer, required
    - `devices` PoolInventoryDevice[], required
      - `device_index` integer, required
      - `model` string, required
      - `memory_mb` integer, required
      - `device_uuid` string, required
  - `devices` PoolHostDevice[], required
    - `id` string, required
    - `host_id` string, required
    - `pool_id` string, required
    - `device_index` integer, required
    - `model` string, required
    - `memory_mb` integer, required
    - `device_uuid` string, required
    - `state` string, required
  - `last_heartbeat_at` string, date-time, nullable, required
  - `drain_requested_at` string, date-time, nullable, required
  - `enrolled_at` string, date-time, required

## Other responses

- `default`: Authentication, disabled feature, invalid input, missing pool or host, rate limits, and transient failures apply.

---

[API](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api.md) - [All operations](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/revisions/a59210899d95?raw)