---
title: "Register Node"
method: POST
path: "/cluster/nodes"
---

# Register Node

`POST /cluster/nodes`

Register a new node in the cluster.

## Request body

- NodeRegisterRequest — Body for POST /cluster/nodes.
  - `name` string
  - `url` string
  - `capacity` NodeCapacitySchema — Advertised capacity of a cluster node.
    - `max_agents` integer
    - `available_slots` integer
    - `active_agents` integer
    - `gpu_available` boolean
    - `supported_models` string[]
  - `labels` object
  - `cell_ids` string[]

## Response `201`

Successful Response

- NodeResponse — Serialised node in API responses.
  - `id` string, required
  - `name` string, required
  - `url` string, required
  - `status` string, required
  - `capacity` NodeCapacitySchema, required — Advertised capacity of a cluster node.
    - `max_agents` integer
    - `available_slots` integer
    - `active_agents` integer
    - `gpu_available` boolean
    - `supported_models` string[]
  - `last_heartbeat` number, required
  - `registered_at` number, required
  - `labels` object, required
  - `cell_ids` string[], required

## Other responses

- `401` — Cluster authentication failed
- `422` — Validation Error

## Changes

> 15 revisions in range; 7 could not be searched.

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

[Change history](https://skmtc.dev/sipyourdrink-ltd/apis/bernstein-task-server/changes/cluster/nodes/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)