Nasuni

Nasuni Volumes API

The Volumes API from Nasuni — 52 operation(s) for volumes.

Documentation GitHub OpenAPI

Operations 76

GET /volumes/ List all volumes

POST /volumes/ Create volume

GET /volumes/{volume_guid}/ Get a volume

PATCH /volumes/{volume_guid}/ Update volume

GET /volumes/{volume_guid}/filers/ List filer specific settings of a volume.

GET /volumes/{volume_guid}/filers/{filer_serial}/ Get volume settings for a specific filer.

PATCH /volumes/{volume_guid}/filers/{filer_serial}/ Update the settings for a volume on a specific Filer

GET /volumes/filers/shares/ List all shares across all volumes and filers.

GET /volumes/{volume_guid}/filers/shares/ List all shares of a volume.

GET /volumes/{volume_guid}/filers/{filer_serial}/shares/ List all shares of a volume on a specific filer.

POST /volumes/{volume_guid}/filers/{filer_serial}/shares/ Create share

GET /volumes/{volume_guid}/filers/{filer_serial}/shares/{share_id}/ Get a share

DELETE /volumes/{volume_guid}/filers/{filer_serial}/shares/{share_id}/ Delete a share

PATCH /volumes/{volume_guid}/filers/{filer_serial}/shares/{share_id}/ Update share

GET /volumes/filers/exports/ List all exports.

GET /volumes/{volume_guid}/filers/exports/ List all exports of a volume.

GET /volumes/{volume_guid}/filers/{filer_serial}/exports/ List exports of a volume for a specific filer.

POST /volumes/{volume_guid}/filers/{filer_serial}/exports/ Create export

GET /volumes/{volume_guid}/filers/{filer_serial}/exports/{export_id}/ Get an export

DELETE /volumes/{volume_guid}/filers/{filer_serial}/exports/{export_id}/ Delete export

PATCH /volumes/{volume_guid}/filers/{filer_serial}/exports/{export_id}/ Update export

GET /volumes/filers/ftp-directories/ List all FTP directories.

GET /volumes/{volume_guid}/filers/ftp-directories/ List all FTP directories of a volume.

GET /volumes/{volume_guid}/filers/{filer_serial}/ftp-directories/ List FTP directories of a volume for a specific filer.

GET /volumes/{volume_guid}/filers/{filer_serial}/ftp-directories/{ftpdir_id}/ Get a FTP directory.

GET /volumes/filer-connections/ List all volume connections.

GET /volumes/{volume_guid}/filer-connections/ List all volume connections for a specific volume.

GET /volumes/{volume_guid}/filer-connections/{filer_serial}/ Get a volume connection.

GET /volumes/filers/antivirus-violations/ List all antivirus violations.

GET /volumes/{volume_guid}/filers/antivirus-violations/ List all antivirus violations of a volume.

GET /volumes/{volume_guid}/filers/{filer_serial}/antivirus-violations/ List antivirus violations of a volume for a specific filer.

GET /volumes/{volume_guid}/filers/{filer_serial}/antivirus-violations/{antivirus_id}/ Get an antivirus violation.

DELETE /volumes/{volume_guid}/filers/{filer_serial}/antivirus-violations/{antivirus_id}/ Delete antivirus violation

GET /volumes/{volume_guid}/filers/{filer_serial}/exports/{export_id}/nfs_host_options/ List NFS host options for an export

POST /volumes/{volume_guid}/filers/{filer_serial}/exports/{export_id}/nfs_host_options/ Create NFS host option

GET /volumes/{volume_guid}/filers/{filer_serial}/exports/{export_id}/nfs_host_options/{host_option_id}/ Get a host option for an export

DELETE /volumes/{volume_guid}/filers/{filer_serial}/exports/{export_id}/nfs_host_options/{host_option_id}/ Delete host option

PATCH /volumes/{volume_guid}/filers/{filer_serial}/exports/{export_id}/nfs_host_options/{host_option_id}/ Update an existing host option

GET /volumes/folder-quotas/ List folder quotas

GET /volumes/{volume_guid}/folder-quotas/ List folder quotas for a volume

POST /volumes/{volume_guid}/folder-quotas/ Create folder quota

GET /volumes/{volume_guid}/folder-quotas/{folder_quota_id}/ Get folder quota

DELETE /volumes/{volume_guid}/folder-quotas/{folder_quota_id}/ Delete folder quota

PATCH /volumes/{volume_guid}/folder-quotas/{folder_quota_id}/ Update folder quota

GET /volumes/filers/snapshots/ List snapshot statuses

GET /volumes/{volume_guid}/filers/snapshots/ List snapshot statuses for a volume

GET /volumes/{volume_guid}/filers/{filer_serial}/snapshots/ List snapshot status for a volume and Filer

POST /volumes/{volume_guid}/filers/{filer_serial}/snapshots/ Request snapshot for volume

POST /volumes/{volume_guid}/global-lock-folders/ Enable global locking and its various modes on a specified path

GET /volumes/filers/paths/ Get a list of all known paths

GET /volumes/{volume_guid}/filers/paths/ Get a list of all known paths with a specific volume

GET /volumes/{volume_guid}/filers/{filer_serial}/paths/ Get a list of all known paths with a specific volume and filer

GET /volumes/{volume_guid}/filers/{filer_serial}/path/{path} Get info on a specific path

POST /volumes/{volume_guid}/filers/{filer_serial}/path/{path} Refresh info about a given path #

POST /volumes/{volume_guid}/filers/{filer_serial}/cache-path/{path} Bring path into cache

POST /volumes/{volume_guid}/filers/{filer_serial}/make-dir-path/ Try to make the given directory path

GET /volumes/filers/pinned-folders/ Get a list of all pinned folders

GET /volumes/{volume_guid}/filers/pinned-folders/ Get a list of all pinned folders in a volume

GET /volumes/{volume_guid}/filers/{filer_serial}/pinned-folders/ Get a list of pinned folders in a volume for a specific filer

POST /volumes/{volume_guid}/filers/{filer_serial}/pinned-folders/ Set pinning mode

GET /volumes/{volume_guid}/filers/{filer_serial}/pinned-folder/{path} Get pinning status for the path

DELETE /volumes/{volume_guid}/filers/{filer_serial}/pinned-folder/{path} Disable pinning mode on a folder

GET /volumes/filers/auto-cached-folders/ Get a list of all auto cache enabled folders

GET /volumes/{volume_guid}/filers/auto-cached-folders/ Get a list of all auto cache enabled folders in a volume

GET /volumes/{volume_guid}/filers/{filer_serial}/auto-cached-folders/ List auto cache enabled folders for a volume on a filer

POST /volumes/{volume_guid}/filers/{filer_serial}/auto-cached-folders/ Set auto caching mode

GET /volumes/{volume_guid}/filers/{filer_serial}/auto-cached-folder/{path} Get auto cache folder status for a folder

DELETE /volumes/{volume_guid}/filers/{filer_serial}/auto-cached-folder/{path} Disable auto cache mode on a folder

DELETE /volumes/{volume_guid}/global-lock-folders/{path} Disable global locking on a specified path

GET /volumes Get Volumes #

GET /volumes/{volume_id}/edges/{edge_id}/snapshots Get Snapshot Status #

POST /volumes/{volume_id}/edges/{edge_id}/snapshots Start Snapshot #

DELETE /volumes/{volume_id}/edges/{edge_id}/snapshots Cancel Snapshot #

GET /volumes/{volume_id} Get Volume #

GET /volumes/{volume_id}/details Get Volume Details #

GET /volumes/{volume_id}/capacity-history Get Volume Capacity History #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/nasuni-volumes-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Nasuni Volumes API
  version: '1.0'
  description: 'Operations tagged Volumes across 4 of this provider''s published API definitions: nasuni-nmc-v1-0-openapi.yml, nasuni-nmc-v1-1-openapi.yml, nasuni-nmc-v1-2-openapi.yml, nasuni-portal-v0-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://hostname/api/v1
- url: https://hostname/api/v1.1
- url: https://hostname/api/v1.2
- url: https://am1.portal.api.nasuni.com
  description: Base URL for accounts assigned the US region.
- url: https://eu1.portal.api.nasuni.com
  description: Base URL for accounts assigned the EU region.
- url: https://ap1.portal.api.nasuni.com
  description: Base URL for accounts assigned the Asia-Pacific region.
tags:
- name: Volumes
paths:
  /volumes/:
    get:
      tags:
      - Volumes
      summary: List all volumes
      parameters:
      - name: limit
        in: query
        description: The maximum number of objects to return
        schema:
          maximum: 100
          minimum: 1
          type: integer
          default: 50
      - name: offset
        in: query
        description: The index of the first object to return
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/Volume'
                - $ref: '#/components/schemas/Paging'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
    post:
      tags:
      - Volumes
      summary: Create volume
      requestBody:
        content:
          application/json:
            schema:
              allOf:
              - type: object
              - $ref: '#/components/schemas/Volume_2'
        required: true
      responses:
        '202':
          description: Accepted - Filer has been sent a message
          headers:
            Location:
              description: URL to the associated message
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-codegen-request-body-name: body
      security:
      - AuthToken: []
    servers:
    - url: https://hostname/api/v1
  /volumes/{volume_guid}/:
    get:
      tags:
      - Volumes
      summary: Get a volume
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Volume'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
    patch:
      tags:
      - Volumes
      summary: Update volume
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Volume_2'
        required: true
      responses:
        '202':
          description: Accepted - Filer has been sent a message
          headers:
            Location:
              description: URL to the associated message
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-codegen-request-body-name: body
      security:
      - AuthToken: []
    servers:
    - url: https://hostname/api/v1
  /volumes/{volume_guid}/filers/:
    get:
      tags:
      - Volumes
      summary: List filer specific settings of a volume.
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: The maximum number of objects to return
        schema:
          maximum: 100
          minimum: 1
          type: integer
          default: 50
      - name: offset
        in: query
        description: The index of the first object to return
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/VolumeFilerSetting'
                - $ref: '#/components/schemas/Paging'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
    servers:
    - url: https://hostname/api/v1
  /volumes/{volume_guid}/filers/{filer_serial}/:
    get:
      tags:
      - Volumes
      summary: Get volume settings for a specific filer.
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VolumeFilerSetting'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
    patch:
      tags:
      - Volumes
      summary: Update the settings for a volume on a specific Filer
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      requestBody:
        description: Volume settings to update for a Filer
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VolumeFilerSetting_2'
        required: true
      responses:
        '202':
          description: Accepted - Filers volume has been sent a message
          headers:
            Location:
              description: URL to the associated message
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-codegen-request-body-name: body
      security:
      - AuthToken: []
    servers:
    - url: https://hostname/api/v1
  /volumes/filers/shares/:
    get:
      tags:
      - Volumes
      summary: List all shares across all volumes and filers.
      parameters:
      - name: limit
        in: query
        description: The maximum number of objects to return
        schema:
          maximum: 100
          minimum: 1
          type: integer
          default: 50
      - name: offset
        in: query
        description: The index of the first object to return
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/Share'
                - $ref: '#/components/schemas/Paging'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
    servers:
    - url: https://hostname/api/v1
  /volumes/{volume_guid}/filers/shares/:
    get:
      tags:
      - Volumes
      summary: List all shares of a volume.
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: The maximum number of objects to return
        schema:
          maximum: 100
          minimum: 1
          type: integer
          default: 50
      - name: offset
        in: query
        description: The index of the first object to return
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/Share'
                - $ref: '#/components/schemas/Paging'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
    servers:
    - url: https://hostname/api/v1
  /volumes/{volume_guid}/filers/{filer_serial}/shares/:
    get:
      tags:
      - Volumes
      summary: List all shares of a volume on a specific filer.
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: The maximum number of objects to return
        schema:
          maximum: 100
          minimum: 1
          type: integer
          default: 50
      - name: offset
        in: query
        description: The index of the first object to return
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/Share'
                - $ref: '#/components/schemas/Paging'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
    post:
      tags:
      - Volumes
      summary: Create share
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      requestBody:
        description: The share to create.
        content:
          application/json:
            schema:
              allOf:
              - type: object
              - $ref: '#/components/schemas/Share_2'
        required: true
      responses:
        '202':
          description: Accepted - Filer has been sent a message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Permission denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-codegen-request-body-name: body
      security:
      - AuthToken: []
    servers:
    - url: https://hostname/api/v1
  /volumes/{volume_guid}/filers/{filer_serial}/shares/{share_id}/:
    get:
      tags:
      - Volumes
      summary: Get a share
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      - name: share_id
        in: path
        description: Share object identifier
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Share'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
    delete:
      tags:
      - Volumes
      summary: Delete a share
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      - name: share_id
        in: path
        description: Share object identifier
        required: true
        schema:
          type: string
      responses:
        '202':
          description: Accepted - Filer has been sent a message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Permission denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - AuthToken: []
    patch:
      tags:
      - Volumes
      summary: Update share
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      - name: share_id
        in: path
        description: Share object identifier
        required: true
        schema:
          type: string
      requestBody:
        description: Share fields to update
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Share_2'
        required: true
      responses:
        '202':
          description: Accepted - Filer has been sent a message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Permission denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-codegen-request-body-name: body
      security:
      - AuthToken: []
    servers:
    - url: https://hostname/api/v1
  /volumes/filers/exports/:
    get:
      tags:
      - Volumes
      summary: List all exports.
      parameters:
      - name: limit
        in: query
        description: The maximum number of objects to return
        schema:
          maximum: 100
          minimum: 1
          type: integer
          default: 50
      - name: offset
        in: query
        description: The index of the first object to return
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/Export'
                - $ref: '#/components/schemas/Paging'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
    servers:
    - url: https://hostname/api/v1
  /volumes/{volume_guid}/filers/exports/:
    get:
      tags:
      - Volumes
      summary: List all exports of a volume.
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: The maximum number of objects to return
        schema:
          maximum: 100
          minimum: 1
          type: integer
          default: 50
      - name: offset
        in: query
        description: The index of the first object to return
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/Export'
                - $ref: '#/components/schemas/Paging'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
    servers:
    - url: https://hostname/api/v1
  /volumes/{volume_guid}/filers/{filer_serial}/exports/:
    get:
      tags:
      - Volumes
      summary: List exports of a volume for a specific filer.
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: The maximum number of objects to return
        schema:
          maximum: 100
          minimum: 1
          type: integer
          default: 50
      - name: offset
        in: query
        description: The index of the first object to return
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/Export'
                - $ref: '#/components/schemas/Paging'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
    post:
      tags:
      - Volumes
      summary: Create export
      description: Only available on NMC version 21.2 and higher.
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      requestBody:
        description: The export to create.
        content:
          application/json:
            schema:
              allOf:
              - type: object
              - $ref: '#/components/schemas/Export_2'
        required: true
      responses:
        '202':
          description: Accepted - Filer has been sent a message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Permission denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-codegen-request-body-name: body
      security:
      - AuthToken: []
    servers:
    - url: https://hostname/api/v1
  /volumes/{volume_guid}/filers/{filer_serial}/exports/{export_id}/:
    get:
      tags:
      - Volumes
      summary: Get an export
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      - name: export_id
        in: path
        description: Export object identifier
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Export'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
    delete:
      tags:
      - Volumes
      summary: Delete export
      description: Only available on NMC version 21.2 and higher.
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      - name: export_id
        in: path
        description: Export object identifier
        required: true
        schema:
          type: string
      responses:
        '202':
          description: Accepted - Filer has been sent a message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Permission denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - AuthToken: []
    patch:
      tags:
      - Volumes
      summary: Update export
      description: Only available on NMC version 21.2 and higher.
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      - name: export_id
        in: path
        description: Export object identifier
        required: true
        schema:
          type: string
      requestBody:
        description: Export fields to update
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Export_2'
        required: true
      responses:
        '202':
          description: Accepted - Filer has been sent a message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Permission denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-codegen-request-body-name: body
      security:
      - AuthToken: []
    servers:
    - url: https://hostname/api/v1
  /volumes/filers/ftp-directories/:
    get:
      tags:
      - Volumes
      summary: List all FTP directories.
      parameters:
      - name: limit
        in: query
        description: The maximum number of objects to return
        schema:
          maximum: 100
          minimum: 1
          type: integer
          default: 50
      - name: offset
        in: query
        description: The index of the first object to return
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - type: object
 

# --- truncated at 32 KB (292 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/nasuni/refs/heads/main/openapi/nasuni-volumes-api-openapi.yml