NetBird Full API Reference + Read-Only MCP Prototype
DELETE/api/peers/{peerId}

Delete a peer

Deletes a specific peer. Use the peerId path parameter to identify the peer to remove; the response provides a deletion status code.

1 parameter
peerIdstringrequired
The unique identifier of the peer to delete.

5 status codes
200Returns a deletion status code confirming the peer deletion.
400Returned when the request is invalid.
401Returned when authentication is required but missing or invalid.
403Returned when the authenticated user is not permitted to delete the peer.
500Returned when an internal server error occurs.

Error handling

The peerId path parameter must identify the peer to delete. A 400 indicates the request is invalid, a 401 indicates missing or invalid authentication, and a 403 indicates the authenticated user is not permitted to delete the peer. A 500 indicates an internal server error.