---
title: "Remove an existing peer"
method: DELETE
path: "/api/v1/admin/peers/{endpoint}"
tags: ["Admin", "Peer"]
---

# Remove an existing peer

`DELETE /api/v1/admin/peers/{endpoint}`

Remove an existing peer identified by the provided endpoint.
The peer is removed from the list of known peers. If a connection to it
is currently active, it will be closed.

## Response `204`

Peer removed

## Other responses

- `400` — Malformed endpoint
- `404` — Peer doesn't exist

## Changes

- **2024-02-27** `99d6b90ff47a` — 1 info
  - endpoint added
- **2023-10-26** `1c37c167d50d` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/threefoldtech/apis/mycelium-management/changes/api/v1/admin/peers/:endpoint/delete.md)

---

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