---
title: "POST /nodes/{id}/update"
method: POST
path: "/nodes/{id}/update"
---

# POST /nodes/{id}/update

`POST /nodes/{id}/update`

Update a node

## Path parameters

- `id` string, required

## Query parameters

- `version` integer, required

## Request body

- NodeSpec
  - `Name` string — Name for the node.
  - `Labels` object — User-defined key/value metadata.
  - `Role` 'worker' | 'manager' — Role of the node.
  - `Availability` 'active' | 'pause' | 'drain' — Availability of the node.

## Response `204`

There is no content to send for this request, but the headers may be useful.

## Changes

- **2026-02-14** `31f80d10d31a` — 3 breaking, 6 info
  - request body became required
  - removed the media type `text/plain` from the request body
  - removed the success response with the status `200`
  - api tag `Node` removed
  - …5 more

[Change history](https://skmtc.dev/hexlet/apis/docker-engine-api/changes/nodes/:id/update/post.md)

---

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