---
title: "Create Nodes"
method: POST
path: "/nodes/"
tags: ["Nodes"]
---

# Create Nodes

`POST /nodes/`

## Request

- Base URL: `https://api.chutes.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.chutes.ai/nodes/`
- Auth: API key in header `Authorization`

Add nodes/GPUs to inventory.

## Headers

- `X-Chutes-Hotkey` string, nullable
- `X-Chutes-Signature` string, nullable
- `X-Chutes-Nonce` string, nullable
- `Authorization` string, nullable

## Request body

- MultiNodeArgs
  - `server_id` string, required
  - `server_name` string, nullable
  - `nodes` NodeArgs[], required
    - `uuid` string, required
    - `name` string, required
    - `memory` integer, required
    - `major` integer, nullable
    - `minor` integer, nullable
    - `processors` integer, nullable
    - `sxm` boolean, nullable
    - `clock_rate` number, required
    - `max_threads_per_processor` integer, nullable
    - `concurrent_kernels` boolean, nullable
    - `ecc` boolean, nullable
    - `device_index` integer, required
    - `gpu_identifier` string, required
    - `verification_host` string, required
    - `verification_port` integer, required

## Response `202`

Successful Response

- string

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `23e8895b217d`: 1 breaking, 1 warning, 2 info
  - the response's body type changed from no type to `string` for status `202`
  - the `nodes/items/device_index` request property's min was set to `0.00`
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-08-26** `8d909638091e`: 1 info
  - endpoint added
- **2026-08-22** `05d9af05d87e`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/chutes/apis/chutes-api/changes/nodes/post.md)

---

[API](https://skmtc.dev/chutes/apis/chutes-api.md) - [All operations](https://skmtc.dev/chutes/apis/chutes-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chutes/apis/chutes-api/revisions/8add5b0e22da?raw)