Introduction

Welcome to the Nasuni Portal API.

The Portal API allows you to monitor and configure Nasuni resources managed by Portal in a simple programmatic way using conventional HTTP requests.

All endpoints should be prefixed with the appropriate regional base domain for your account:

• eu1.portal.api.nasuni.com
• as1.portal.api.nasuni.com
• am1.portal.api.nasuni.com

You can determine your regional base domain by logging into Portal and observing the URL in the address bar.

Requests & Responses

The Portal API is based on REST principles and is only reachable via HTTPS. In general, the API uses standard HTTP methods as described below:

In the case of all PATCH and some POST requests, a JSON-formatted body is used to add the necessary arguments to the request.

When a request is successful, a response body will typically be sent back as JSON. A typical successful request will return with a status code in the 200 range.

Return codes in the 400 range typically indicate that there was an issue with the request that was sent. A status code in the 500 range generally indicates a server-side problem. If you receive a 500 error, please contact support@nasuni.com.

Authentication

You will need either a user or service key to authenticate. Keys can be administered from the API Keys Management page in Portal. Once you have a key, you can request an access token via the /auth/token endpoint. See the Auth endpoint docmentation for more details.