# API How-Tos

Network File Storage APIs allow contract owners, administrators, and authenticated users with the required permissions to create clusters and shares within the storage system through the API.

## Quick Links

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>Set User Privileges through the API</strong></mark></td><td>Learn how to set user privileges for Network File Storage through the API.</td><td><a href="api-how-tos/set-user-privileges-api">set-user-privileges-api</a></td></tr><tr><td><mark style="color:blue;"><strong>Create Cluster</strong></mark></td><td>Learn how to create a cluster for Network File Storage.</td><td><a href="api-how-tos/create-cluster">create-cluster</a></td></tr><tr><td><mark style="color:blue;"><strong>Retrieve Cluster</strong></mark></td><td>Learn how to retrieve a specific cluster.</td><td><a href="api-how-tos/retrieve-cluster">retrieve-cluster</a></td></tr><tr><td><mark style="color:blue;"><strong>Retrieve Clusters</strong></mark></td><td>Learn how to retrieve all clusters of a Network File Storage.</td><td><a href="api-how-tos/retrieve-clusters">retrieve-clusters</a></td></tr><tr><td><mark style="color:blue;"><strong>Update Cluster</strong></mark></td><td>Learn how to update a cluster through the API.</td><td><a href="api-how-tos/update-cluster">update-cluster</a></td></tr><tr><td><mark style="color:blue;"><strong>Delete Cluster</strong></mark></td><td>Learn how to delete a cluster through the API.</td><td><a href="api-how-tos/delete-cluster">delete-cluster</a></td></tr><tr><td><mark style="color:blue;"><strong>Create Share</strong></mark></td><td>Learn how to create a share within a cluster.</td><td><a href="api-how-tos/create-share">create-share</a></td></tr><tr><td><mark style="color:blue;"><strong>Retrieve Share</strong></mark></td><td>Learn how to retrieve a specific share.</td><td><a href="api-how-tos/retrieve-share">retrieve-share</a></td></tr><tr><td><mark style="color:blue;"><strong>Retrieve Shares</strong></mark></td><td>Learn how to retrieve all shares of a cluster.</td><td><a href="api-how-tos/retrieve-shares">retrieve-shares</a></td></tr><tr><td><mark style="color:blue;"><strong>Update Share</strong></mark></td><td>Learn how to update a specific share through the API.</td><td><a href="api-how-tos/update-share">update-share</a></td></tr><tr><td><mark style="color:blue;"><strong>Delete Share</strong></mark></td><td>Learn how to delete a share from within the cluster through the API.</td><td><a href="api-how-tos/delete-share">delete-share</a></td></tr></tbody></table>

## Regional endpoints

Use the regional endpoints to interact with Network File Storage:

* Berlin, Germany: `https://nfs.de-txl.ionos.com`
* Frankfurt, Germany: `https://nfs.de-fra.ionos.com`
* Paris, France: `https://nfs.fr-par.ionos.com`
* London, Great Britain: `https://nfs.gb-lhr.ionos.com`
* Logroño, Spain: `https://nfs.es-vit.ionos.com`
* Las Vegas, United States: `https://nfs.us-las.ionos.com`
* Newark, United States: `https://nfs.us-ewr.ionos.com`
* Lenexa, United States: `https://nfs.us-mci.ionos.com`

{% hint style="info" %}
**Note:** Network File Storage will soon be available in the Worcester, United Kingdom, region.
{% endhint %}

## API authentication

The API uses the **Token Authentication** method. Ensure that you specify the header value as `Bearer` followed by your `token`.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ionos.com/cloud/backup-and-storage/network-file-storage/api-how-tos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.