# system_addReservedPeer - Bittensor RPC Method

Adds a reserved peer to the running Bittensor node. Reserved peers are always maintained as connections -- the node will actively try to connect and reconnect to them, and they are not subject to normal peer eviction. This is an administrative method that requires `--rpc-methods unsafe`.

## Code Examples

## Request Parameters

This method accepts no parameters.

## Request Example

```bash
curl -X POST https://api-bittensor-mainnet.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "system_addReservedPeer",
    "params": [],
    "id": 1
  }'
```

## Response Fields

- `result` (`BOOLEAN, required`): Whether the peer was added successfully.

## Successful Response

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": true
}
```

## Use Cases

- **Guaranteed connectivity** -- Ensure your Bittensor node always maintains a connection to critical peers (e.g. your own boot nodes or trusted validators).
- **Private network setup** -- Build a private or semi-private node cluster by reserving connections between known nodes.
- **Connectivity recovery** -- Add a known-good peer when a node is struggling to find peers.

## Notes

- This is an unsafe/administrative method. Disabled on public RPC endpoints including Dwellir's shared Bittensor nodes.
- Reserved peers are persistent -- the node will continue trying to connect to them even after disconnections.
- The peer multiaddr must include the peer ID (the `/p2p/12D3KooW...` component).
- Use `system_removeReservedPeer` to remove a peer from the reserved list.

## Related Methods

- [`system_removeReservedPeer`](https://www.dwellir.com/docs/bittensor/system_removeReservedPeer) -- Remove a reserved peer
- [`system_reservedPeers`](https://www.dwellir.com/docs/bittensor/system_reservedPeers) -- List current reserved peers
- [`system_peers`](https://www.dwellir.com/docs/bittensor/system_peers) -- List all currently connected peers
- [`system_localListenAddresses`](https://www.dwellir.com/docs/bittensor/system_localListenAddresses) -- Get the node's own listen addresses