Create Node

Creates a new node in the system.

Request

POST /v2/admin/node

Parameters

Name	Type	In	Description
parent_id	string	body	Required. The ID of the parent node
node_type	integer	body	Required. The type of node to create
name	string	body	Required. The name of the node

Headers

Name	Description
Authorization	Required. Bearer token for authentication
Content-Type	Required. Must be application/json

Example

curl --request POST \
  --url '\{\{baseUrl\}\}/v2/admin/node' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
  --header 'Content-Type: application/json' \
  --data '{
	"parent_id": "67a68d4462dd1d00073d0af3",
	"node_type": 2,
	"name": "Tostik 5"
}'

Response

{
	"id": "67d6c447f47ff3adafda700d",
	"parent_id": "67a68d4462dd1d00073d0af3",
	"parent_name": null,
	"name": "Tostik 5",
	"type": 2,
	"status": 3,
	"contract": {
		"wallet": {
			"public_key": "0xAF4bf547c4d354266449dB91fe0c4d8861cFfc0E"
		},
		"fee_contract_address": null,
		"listing_contract_address": null,
		"rent_contract_address": null,
		"burn_contract_address": null,
		"secondary_contract_address": null
	},
	"meta": null,
	"int_id": 38,
	"path": "1.38",
	"listed_token_count": 0,
	"supervisor_count": 0,
	"created_at": "2025-03-16T15:29:59.460414+03:00"
}

Response Fields

Field	Type	Description
id	string	Unique identifier for the new node
parent_id	string	ID of the parent node
parent_name	string	Name of the parent node (may be null)
name	string	Name of the node
type	integer	Type of the node
status	integer	Status code of the node
contract	object	Contract details for the node
contract.wallet.public_key	string	Public key of the node's wallet
meta	object	Additional metadata (may be null)
int_id	integer	Internal ID of the node
path	string	Path representation of the node hierarchy
listed_token_count	integer	Number of tokens listed under the node
supervisor_count	integer	Number of supervisors associated with the node
created_at	string	ISO 8601 timestamp of when the node was created

Status Codes

Status Code	Description
200	Success
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid or missing authentication token
404	Not Found - Parent node ID does not exist
500	Internal Server Error

Node Types

Type	Value	Description
Apex	1	Top-level node type in the hierarchy
Account	2	Corporate node type positioned under Apex nodes
SubAccount	3	Branch nodes positioned under Account nodes representing company branches

Node Status

Status	Value	Description
ActiveStatus	1	Node is active and can perform operations
PassiveStatus	2	Node is passive and cannot perform operations
CreatingStatus	3	Node is in setup phase with installations being completed