---
title: "Add a new peer"
method: POST
path: "/api/v1/admin/peers"
tags: ["Admin", "Peer"]
---

# Add a new peer

`POST /api/v1/admin/peers`

Add a new peer identified by the provided endpoint.
The peer is added to the list of known peers. It will eventually be connected
to by the standard connection loop of the peer manager. This means that a peer
which can't be connected to will stay in the system, as it might be reachable
later on.

## Response `204`

Peer added

## Other responses

- `400` — Malformed endpoint
- `409` — Peer already exists

---

[API](https://skmtc.net/threefoldtech/apis/mycelium-management.md) · [All operations](https://skmtc.net/threefoldtech/apis/mycelium-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/threefoldtech/mycelium-management/versions/65042c1a7b84/schema)