> For the complete documentation index, see [llms.txt](https://docs.ionos.com/cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ionos.com/cloud/backup-and-storage/network-file-storage/api-how-tos.md).

# 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="/pages/xB1digPqyNkAFolQEiXX">/pages/xB1digPqyNkAFolQEiXX</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="/pages/aTcMe5bEhPDv3xg832XM">/pages/aTcMe5bEhPDv3xg832XM</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="/pages/GT9z2x740k3mk1wSDWyF">/pages/GT9z2x740k3mk1wSDWyF</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="/pages/l42HNLOI3GlhzNpBS3Lu">/pages/l42HNLOI3GlhzNpBS3Lu</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="/pages/LpVbIDkEkWi92J8xBVYE">/pages/LpVbIDkEkWi92J8xBVYE</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="/pages/8p41CBDr2L2uOf0TnjJo">/pages/8p41CBDr2L2uOf0TnjJo</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="/pages/QCdKvwob89hZyQQlQPrZ">/pages/QCdKvwob89hZyQQlQPrZ</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="/pages/2vRiiMoM3vjGSap2gygQ">/pages/2vRiiMoM3vjGSap2gygQ</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="/pages/E6x39Rn2IRbWqvXyq0CS">/pages/E6x39Rn2IRbWqvXyq0CS</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="/pages/tEx3CkdhibvFppwZLC8o">/pages/tEx3CkdhibvFppwZLC8o</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="/pages/8GNJQg4tQJWeL8M6Cg2o">/pages/8GNJQg4tQJWeL8M6Cg2o</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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.