system_removeReservedPeer - Bittensor RPC Method
Remove a reserved peer from a Bittensor node. Administrative method.
Bittensor RPC endpoint: endpoint URLs, plans and pricing.
Removes a peer from the reserved peer list on the running Bittensor node. After removal, the node will no longer actively maintain a connection to that peer, and the peer becomes subject to normal eviction rules. This is an administrative method that requires --rpc-methods unsafe.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
peerId | string | Yes | The peer ID to remove from the reserved list (e.g. "12D3KooW..."). |
Response
| Field | Type | Description |
|---|---|---|
result | null | Confirms the peer has been removed from the reserved list. |
Code Examples
curl -X POST https://api-bittensor-mainnet.n.dwellir.com/YOUR_API_KEY \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "system_removeReservedPeer",
"params": [],
"id": 1
}'Use Cases
- Peer rotation -- Remove decommissioned or misbehaving peers from the reserved list.
- Network reconfiguration -- Update the reserved peer set when changing your node infrastructure.
- Troubleshooting -- Remove a peer that is causing connectivity issues.
Notes
- This is an unsafe/administrative method. Disabled on public RPC endpoints including Dwellir's shared Bittensor nodes.
- Removing a reserved peer does not immediately disconnect it; it just removes the reservation, making the connection subject to normal peer management.
- The peer ID is the libp2p peer identifier, not a multiaddr.
Related Methods
system_addReservedPeer-- Add a reserved peersystem_reservedPeers-- List current reserved peerssystem_peers-- List all connected peers