# Delete Wireguard Peer

Deletes the specified WireGuard Peer.

To delete a WireGuard Peer, perform a `DELETE` request with the `gatewayId` of the WireGuard Gateway and `peerId` of the WireGuard Peer.

## Endpoint

Use a [<mark style="color:blue;">region-specific</mark>](https://docs.ionos.com/sections-test/guides/network-services/vpn-gateway/api-how-tos/..#endpoints) endpoint to delete the WireGuard Peer: `https://vpn.{region}.ionos.com/wireguardgateways/{gatewayid}/peers/{peerId}`.

## Request

**Note:** The following request contains a sample `gatewayId` and `peerId`. Replace them with the `gatewayId` and `peerId` value, whose information you want to delete.

```bash
curl --location \
--request DELETE 'https://vpn.de-fra.ionos.com/wireguardgateways/85c79b4b-5b40-570a-b788-58dd46ea71e2/peers/b62b3a40-adee-5b6c-b98d-be20bfcbdd91' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJraWQiO'
```

{% tabs %}
{% tab title="Path Parameters" %}
You can update the `gatewayId` and `peerId` values to delete a specific WireGuard Peer for a given gateway:

| Path Parameter | Type   | Description                             | Example                                |
| -------------- | ------ | --------------------------------------- | -------------------------------------- |
| **gatewayId**  | string | The ID (UUID) of the WireGuard Gateway. | `85c79b4b-5b40-570a-b788-58dd46ea71e2` |
| **peerId**     | string | The ID (UUID) of the WireGuard Peer.    | `b62b3a40-adee-5b6c-b98d-be20bfcbdd91` |
| {% endtab %}   |        |                                         |                                        |

{% tab title="Request Header Parameters" %}
To make authenticated requests to the API, the following fields are mandatory in the request header:

| Header Parameter | Required | Type   | Description                                                                       |
| ---------------- | -------- | ------ | --------------------------------------------------------------------------------- |
| `Authorization`  | yes      | string | The Bearer token to enable requests to authenticate using a JSON Web Token (JWT). |
| {% endtab %}     |          |        |                                                                                   |
| {% endtabs %}    |          |        |                                                                                   |

## Response

**202 Successful operation**

{% hint style="success" %}
**Result:** The WireGuard Peer with the specified `gatewayId` and `peerId` is successfully deleted.
{% endhint %}
