---
title: "Add Node"
method: POST
path: "/api/node"
tags: ["Node"]
---

# Add Node

`POST /api/node`

Add a new node to the database and optionally add it as a host.

## Request body

- NodeCreate
  - `name` string, required
  - `address` string, required
  - `port` integer
  - `api_port` integer
  - `usage_coefficient` number
  - `add_as_new_host` boolean

## Response `200`

Successful Response

- NodeResponse
  - `name` string, required
  - `address` string, required
  - `port` integer
  - `api_port` integer
  - `usage_coefficient` number
  - `id` integer, required
  - `xray_version` string, nullable
  - `status` 'connected' | 'connecting' | 'error' | 'disabled', required
  - `message` string, nullable

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `409` — Conflict
- `422` — Validation Error

---

[API](https://skmtc.dev/atrvatam/apis/marzbanapi.md) · [All operations](https://skmtc.dev/atrvatam/apis/marzbanapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/atrvatam/marzbanapi/revisions/0aa31d6bd001/schema)