# peer_reservations_del

[[Source]](https://github.com/XRPLF/rippled/blob/master/src/xrpld/rpc/handlers/Reservations.cpp)

The  method removes a specific [peer reservation](/docs/concepts/networks-and-servers/peer-protocol#fixed-peers-and-peer-reservations), if one exists.

*The  method is an [admin method](/docs/references/http-websocket-apis/admin-api-methods) that cannot be run by unprivileged users.*

Removing a peer reservation does not automatically disconnect the corresponding peer, if that peer is connected.

### Request Format

An example of the request format:

WebSocket

```json
{
    "id": "peer_reservations_del_example_1",
    "command": "",
    "public_key": "n9Jt8awsPzWLjBCNKVEEDQnw4bQEPjezfcQ4gttD1UzbLT1FoG99"
}
```

JSON-RPC

```json
{
    "method": "",
    "params": [{
      "public_key": "n9Jt8awsPzWLjBCNKVEEDQnw4bQEPjezfcQ4gttD1UzbLT1FoG99"
    }]
}
```

Commandline

```sh
#Syntax:  <public_key>
rippled  n9Jt8awsPzWLjBCNKVEEDQnw4bQEPjezfcQ4gttD1UzbLT1FoG99
```

The request includes the following parameter:

| `Field` | Type | Description |
|  --- | --- | --- |
| `public_key` | String | The [node public key](/docs/concepts/networks-and-servers/peer-protocol#node-key-pair) of the [peer reservation](/docs/concepts/networks-and-servers/peer-protocol#fixed-peers-and-peer-reservations) to remove, in [base58](/docs/references/protocol/data-types/base58-encodings) format. |


### Response Format

An example of a successful response:

WebSocket

```json
{
  "id": "peer_reservations_del_example_1",
  "result": {
    "previous": {
      "description": "Ripple s1 server 'WOOL'",
      "node": "n9Jt8awsPzWLjBCNKVEEDQnw4bQEPjezfcQ4gttD1UzbLT1FoG99"
    }
  },
  "status": "success",
  "type": "response"
}
```

JSON-RPC

```json
{
  "result" : {
    "previous" : {
        "description" : "Ripple s1 server 'WOOL'",
        "node" : "n9Jt8awsPzWLjBCNKVEEDQnw4bQEPjezfcQ4gttD1UzbLT1FoG99"
    },
    "status" : "success"
  }
}
```

Commandline

```json
Loading: "/etc/rippled.cfg"
Connecting to 127.0.0.1:5005

{
  "result" : {
    "previous" : {
        "description" : "Ripple s1 server 'WOOL'",
        "node" : "n9Jt8awsPzWLjBCNKVEEDQnw4bQEPjezfcQ4gttD1UzbLT1FoG99"
    },
    "status" : "success"
  }
}
```

The response follows the [standard format](/docs/references/http-websocket-apis/api-conventions/response-formatting), with a successful result containing the following fields:

| `Field` | Type | Description |
|  --- | --- | --- |
| `previous` | Object | *(May be omitted)* A **peer reservation object** with the last state of the peer reservation before deleting it. This field is always provided if a peer reservation was successfully deleted. |


If the specified reservation did not exist, this command returns success with an empty result object. In this case, the `previous` field is omitted.

#### Peer Reservation Object

If the `previous` field is provided, it shows the previous status of this peer reservation, with the following fields:

| `Field` | Type | Description |
|  --- | --- | --- |
| `node` | String | The [node public key][] of the peer server this reservation is for, as [base58][]. |
| `description` | String | *(May be omitted)* The description provided with this peer reservation, if any. |


### Possible Errors

- Any of the [universal error types](/docs/references/http-websocket-apis/api-conventions/error-formatting#universal-errors).
- `invalidParams` - One or more fields are specified incorrectly, or one or more required fields are missing.
- `publicMalformed` - The `public_key` field of the request is not valid. It must be a valid node public key in [base58](/docs/references/protocol/data-types/base58-encodings) format.