---
title: "Add a node to the registry"
method: POST
path: "/registry/nodes"
tags: ["Splinter Registry"]
---

# Add a node to the registry

`POST /registry/nodes`

This endpoint can be used to add a new node to the Splinter registry.
The node must be valid (see the Splinter registry documentation for
details on node validity).

This endpoint requires the permission "registry.write".

## Headers

- `Authorization` string, required
- `SplinterProtocolVersion` integer

## Request body

- RegisteredNode
  - `identity` string
  - `endpoints` string[]
  - `display_name` string
  - `keys` string[]
  - `metadata` object

## Response `200`

The node was successfully added to the registry

## Other responses

- `400` — The request was malformed or the node was invalid
- `401` — The client is unauthorized
- `500` — An internal server error occurred

---

[API](https://skmtc.dev/cargill/apis/splinterd-api.md) · [All operations](https://skmtc.dev/cargill/apis/splinterd-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cargill/splinterd-api/revisions/38a272c24bd9/schema)