# 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 via 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 via the API</strong></mark></td><td>Learn how to set user privileges for Network File Storage via 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 via 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 via 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 via 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 via the API.</td><td><a href="api-how-tos/delete-share">delete-share</a></td></tr></tbody></table>

## 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 %}

## Authentication

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