# Delete Share

You can delete a specific share from within a cluster using its `clusterId` and `shareId`.

{% hint style="info" %}
**Prerequisite:** Only contract administrators, owners, and users with **accessAndManageNFS** privilege can delete shares via the API.
{% endhint %}

## Endpoint

Use the regional endpoints to delete a specific share:

* `https://nfs.de-txl.ionos.com/clusters/{clusterId}/shares/{shareId}`.
* `https://nfs.de-fra.ionos.com/clusters/{clusterId}/shares/{shareId}`

## Request

{% hint style="info" %}
**Note:** The following request contains sample values. Remember to replace them with the relevant information.
{% endhint %}

```json
curl -X 'DELETE' \
  'https://nfs.de-fra.ionos.com/clusters/e69b22a5-8fee-56b1-b6fb-4a07e4205ead/shares/7b1ef56d-dfc6-51fe-aff0-7af2d6747868' \
  -H 'accept: application/json'
```

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

| Header Parameters | Required |  Type  | Description                                                                                                                                                                                                                              |
| ----------------- | :------: | :----: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Authorization`   |    yes   | string | You can use `Basic Authentication` or a `Bearer token`. For more information, see [Authentication](https://docs.ionos.com/cloud/~/revisions/NfgM5VQuRjXRMfbR25yK/storage-and-backup/network-file-storage/api-how-tos/..#authentication). |
| `Content-Type`    |    yes   | string | Set this to `application/json`.                                                                                                                                                                                                          |
| {% endtab %}      |          |        |                                                                                                                                                                                                                                          |

{% tab title="Path Parameters" %}
Below is the list of mandatory path parameters:

| Body Parameters | Type   | Description                   | Example                                |
| --------------- | ------ | ----------------------------- | -------------------------------------- |
| `clusterId`     | string | The ID (UUID) of the cluster. | `e69b22a5-8fee-56b1-b6fb-4a07e4205ead` |
| `shareId`       | string | The ID (UUID) of the share.   | `7b1ef56d-dfc6-51fe-aff0-7af2d6747868` |
| {% endtab %}    |        |                               |                                        |
| {% endtabs %}   |        |                               |                                        |

## Response

A **202** message confirms that the specified share has been successfully deleted.