> For the complete documentation index, see [llms.txt](https://docs.ai.neevcloud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ai.neevcloud.com/api-reference/storage/network-volumes.md).

# Network Volumes

## List Network Volumes

> Retrieves a list of network storage volumes for a specific project.

```json
{"openapi":"3.0.3","info":{"title":"Storage Service API","version":"0.1.0"},"servers":[{"url":"https://api.ai.neevcloud.com/storage","description":"Consolidated public API gateway"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ListNetworkVolumesResponse":{"type":"object","properties":{"volumes":{"type":"array","items":{"$ref":"#/components/schemas/NetworkVolumeResponse"},"description":"Array of network volumes"},"pagination":{"$ref":"#/components/schemas/ListNetworkVolumesPagination"}}},"NetworkVolumeResponse":{"type":"object","required":["id","name","orgID","projectID","regionID","sizeGB","volumeMode","planID","status"],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the network volume"},"name":{"type":"string","description":"Name of the network volume"},"orgID":{"type":"string","description":"Organization identifier"},"projectID":{"type":"string","description":"Project identifier"},"regionID":{"type":"string","description":"Region ID where the network volume is located"},"sizeGB":{"type":"integer","description":"Size of the volume in gigabytes"},"volumeMode":{"type":"string","description":"Volume mode of the volume (filesystem or block)"},"planID":{"type":"string","description":"The pricing plan ID associated with this volume"},"status":{"type":"string","enum":["pending","bound","failed","terminated"],"description":"Current status of the volume (PVC state: Pending=creating, Bound=ready, Failed=error)"},"extension_status":{"type":"string","enum":["resizing","succeeded","failed"],"description":"Status of the latest volume extension operation, if any."},"actual_sizeGB":{"type":"integer","description":"Last observed provisioned capacity in gigabytes for the latest volume extension operation."},"airuntime_instances":{"type":"array","description":"List of AIRuntime instances attached to this volume","items":{"$ref":"#/components/schemas/AttachedTo"}},"volumeAttachments":{"type":"array","description":"Currently-mounted resource attachments for this volume.","items":{"$ref":"#/components/schemas/VolumeAttachmentResponse"}},"createdAt":{"type":"string","format":"date-time","description":"Timestamp when the volume was created"},"updatedAt":{"type":"string","format":"date-time","description":"Timestamp when the volume was last updated"}}},"AttachedTo":{"type":"object","required":["instance_id","instance_name","instance_type"],"properties":{"instance_id":{"type":"string","format":"uuid","description":"AIRuntime instance ID"},"instance_name":{"type":"string","description":"AIRuntime instance name"},"instance_type":{"type":"string","description":"AIRuntime instance type"}}},"VolumeAttachmentResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the attachment"},"volume_id":{"type":"string","format":"uuid","description":"The volume this attachment belongs to"},"resource_type":{"type":"string","description":"Resource type (e.g. airuntime, vm)"},"resource_id":{"type":"string","format":"uuid","description":"Unique identifier of the resource instance"},"resource_name":{"type":"string","description":"Name of the resource instance"},"mount_path":{"type":"string","description":"Path where the volume is mounted on the resource"},"status":{"type":"string","enum":["mounted","unmounted"],"description":"Current mount status of the attachment"},"createdAt":{"type":"string","format":"date-time","description":"Timestamp when the attachment record was created"}}},"ListNetworkVolumesPagination":{"type":"object","properties":{"current_page":{"type":"integer","description":"Current network volume page number"},"items_per_page":{"type":"integer","description":"Number of items per page"},"total_items":{"type":"integer","description":"Total number of items"},"total_pages":{"type":"integer","description":"Total number of pages"}}},"ErrorResponse":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"},"details":{"type":"object","description":"Additional error details"}}}}},"paths":{"/api/v1beta1/orgs/{org_id}/projects/{project_id}/volumes":{"get":{"tags":["Network Volumes"],"summary":"List Network Volumes","description":"Retrieves a list of network storage volumes for a specific project.","operationId":"listNetworkVolumes","parameters":[{"in":"path","name":"org_id","required":true,"schema":{"type":"string"},"description":"The organization identifier."},{"in":"path","name":"project_id","required":true,"schema":{"type":"string"},"description":"The project identifier."},{"in":"query","name":"page","schema":{"type":"integer","minimum":1,"default":1},"description":"Page number for pagination (starts from 1)"},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Number of items per page (max 100)"},{"in":"query","name":"available","schema":{"type":"boolean"},"description":"Filter for available volumes. When true, returns only volumes with status='Bound'. This is a convenience filter equivalent to status=bound."}],"responses":{"200":{"description":"A paginated list of volumes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListNetworkVolumesResponse"}}}},"400":{"description":"The request is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"An unexpected internal server error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Create a Network Volume

> Creates a new network storage volume.

```json
{"openapi":"3.0.3","info":{"title":"Storage Service API","version":"0.1.0"},"servers":[{"url":"https://api.ai.neevcloud.com/storage","description":"Consolidated public API gateway"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"NetworkVolumeRequest":{"type":"object","required":["sizeGB","regionID","volumeMode"],"properties":{"name":{"type":"string","description":"Name for the volume (optional, will be auto-generated if not provided)"},"sizeGB":{"type":"integer","minimum":1,"maximum":1000,"description":"Size of the network volume in gigabytes"},"regionID":{"type":"string","description":"Region ID where the network volume should be created"},"volumeMode":{"type":"string","enum":["filesystem","block"],"default":"filesystem","description":"Use `filesystem` for shared mount workloads and `block` for disk-like workloads."},"mountPath":{"type":"string","description":"Mount path for the network volume"},"attachedTo":{"type":"array","description":"Optional list of AIRuntime instances to attach to this volume during creation","items":{"$ref":"#/components/schemas/AttachedTo"}}}},"AttachedTo":{"type":"object","required":["instance_id","instance_name","instance_type"],"properties":{"instance_id":{"type":"string","format":"uuid","description":"AIRuntime instance ID"},"instance_name":{"type":"string","description":"AIRuntime instance name"},"instance_type":{"type":"string","description":"AIRuntime instance type"}}},"NetworkVolumeResponse":{"type":"object","required":["id","name","orgID","projectID","regionID","sizeGB","volumeMode","planID","status"],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the network volume"},"name":{"type":"string","description":"Name of the network volume"},"orgID":{"type":"string","description":"Organization identifier"},"projectID":{"type":"string","description":"Project identifier"},"regionID":{"type":"string","description":"Region ID where the network volume is located"},"sizeGB":{"type":"integer","description":"Size of the volume in gigabytes"},"volumeMode":{"type":"string","description":"Volume mode of the volume (filesystem or block)"},"planID":{"type":"string","description":"The pricing plan ID associated with this volume"},"status":{"type":"string","enum":["pending","bound","failed","terminated"],"description":"Current status of the volume (PVC state: Pending=creating, Bound=ready, Failed=error)"},"extension_status":{"type":"string","enum":["resizing","succeeded","failed"],"description":"Status of the latest volume extension operation, if any."},"actual_sizeGB":{"type":"integer","description":"Last observed provisioned capacity in gigabytes for the latest volume extension operation."},"airuntime_instances":{"type":"array","description":"List of AIRuntime instances attached to this volume","items":{"$ref":"#/components/schemas/AttachedTo"}},"volumeAttachments":{"type":"array","description":"Currently-mounted resource attachments for this volume.","items":{"$ref":"#/components/schemas/VolumeAttachmentResponse"}},"createdAt":{"type":"string","format":"date-time","description":"Timestamp when the volume was created"},"updatedAt":{"type":"string","format":"date-time","description":"Timestamp when the volume was last updated"}}},"VolumeAttachmentResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the attachment"},"volume_id":{"type":"string","format":"uuid","description":"The volume this attachment belongs to"},"resource_type":{"type":"string","description":"Resource type (e.g. airuntime, vm)"},"resource_id":{"type":"string","format":"uuid","description":"Unique identifier of the resource instance"},"resource_name":{"type":"string","description":"Name of the resource instance"},"mount_path":{"type":"string","description":"Path where the volume is mounted on the resource"},"status":{"type":"string","enum":["mounted","unmounted"],"description":"Current mount status of the attachment"},"createdAt":{"type":"string","format":"date-time","description":"Timestamp when the attachment record was created"}}},"ErrorResponse":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"},"details":{"type":"object","description":"Additional error details"}}}}},"paths":{"/api/v1beta1/orgs/{org_id}/projects/{project_id}/volumes":{"post":{"tags":["Network Volumes"],"summary":"Create a Network Volume","description":"Creates a new network storage volume.","operationId":"createNetworkVolume","parameters":[{"in":"path","name":"org_id","required":true,"schema":{"type":"string"},"description":"The organization identifier."},{"in":"path","name":"project_id","required":true,"schema":{"type":"string"},"description":"The project identifier."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkVolumeRequest"}}}},"responses":{"201":{"description":"Network Volume created successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkVolumeResponse"}}}},"400":{"description":"The request is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"An unexpected internal server error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Get Network Volume

> Retrieves details of a specific network volume.

```json
{"openapi":"3.0.3","info":{"title":"Storage Service API","version":"0.1.0"},"servers":[{"url":"https://api.ai.neevcloud.com/storage","description":"Consolidated public API gateway"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"NetworkVolumeResponse":{"type":"object","required":["id","name","orgID","projectID","regionID","sizeGB","volumeMode","planID","status"],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the network volume"},"name":{"type":"string","description":"Name of the network volume"},"orgID":{"type":"string","description":"Organization identifier"},"projectID":{"type":"string","description":"Project identifier"},"regionID":{"type":"string","description":"Region ID where the network volume is located"},"sizeGB":{"type":"integer","description":"Size of the volume in gigabytes"},"volumeMode":{"type":"string","description":"Volume mode of the volume (filesystem or block)"},"planID":{"type":"string","description":"The pricing plan ID associated with this volume"},"status":{"type":"string","enum":["pending","bound","failed","terminated"],"description":"Current status of the volume (PVC state: Pending=creating, Bound=ready, Failed=error)"},"extension_status":{"type":"string","enum":["resizing","succeeded","failed"],"description":"Status of the latest volume extension operation, if any."},"actual_sizeGB":{"type":"integer","description":"Last observed provisioned capacity in gigabytes for the latest volume extension operation."},"airuntime_instances":{"type":"array","description":"List of AIRuntime instances attached to this volume","items":{"$ref":"#/components/schemas/AttachedTo"}},"volumeAttachments":{"type":"array","description":"Currently-mounted resource attachments for this volume.","items":{"$ref":"#/components/schemas/VolumeAttachmentResponse"}},"createdAt":{"type":"string","format":"date-time","description":"Timestamp when the volume was created"},"updatedAt":{"type":"string","format":"date-time","description":"Timestamp when the volume was last updated"}}},"AttachedTo":{"type":"object","required":["instance_id","instance_name","instance_type"],"properties":{"instance_id":{"type":"string","format":"uuid","description":"AIRuntime instance ID"},"instance_name":{"type":"string","description":"AIRuntime instance name"},"instance_type":{"type":"string","description":"AIRuntime instance type"}}},"VolumeAttachmentResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the attachment"},"volume_id":{"type":"string","format":"uuid","description":"The volume this attachment belongs to"},"resource_type":{"type":"string","description":"Resource type (e.g. airuntime, vm)"},"resource_id":{"type":"string","format":"uuid","description":"Unique identifier of the resource instance"},"resource_name":{"type":"string","description":"Name of the resource instance"},"mount_path":{"type":"string","description":"Path where the volume is mounted on the resource"},"status":{"type":"string","enum":["mounted","unmounted"],"description":"Current mount status of the attachment"},"createdAt":{"type":"string","format":"date-time","description":"Timestamp when the attachment record was created"}}},"ErrorResponse":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"},"details":{"type":"object","description":"Additional error details"}}}}},"paths":{"/api/v1beta1/orgs/{org_id}/projects/{project_id}/volumes/{volume_id}":{"get":{"tags":["Network Volumes"],"summary":"Get Network Volume","description":"Retrieves details of a specific network volume.","operationId":"getNetworkVolume","parameters":[{"in":"path","name":"org_id","required":true,"schema":{"type":"string"},"description":"The organization identifier."},{"in":"path","name":"project_id","required":true,"schema":{"type":"string"},"description":"The project identifier."},{"in":"path","name":"volume_id","required":true,"schema":{"type":"string","format":"uuid"},"description":"The volume identifier."}],"responses":{"200":{"description":"Network Volume details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkVolumeResponse"}}}},"401":{"description":"Unauthorized access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"The network volume was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"An unexpected internal server error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Delete Network Volume

> Deletes a network storage volume.

```json
{"openapi":"3.0.3","info":{"title":"Storage Service API","version":"0.1.0"},"servers":[{"url":"https://api.ai.neevcloud.com/storage","description":"Consolidated public API gateway"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ErrorResponse":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"},"details":{"type":"object","description":"Additional error details"}}}}},"paths":{"/api/v1beta1/orgs/{org_id}/projects/{project_id}/volumes/{volume_id}":{"delete":{"tags":["Network Volumes"],"summary":"Delete Network Volume","description":"Deletes a network storage volume.","operationId":"deleteNetworkVolume","parameters":[{"in":"path","name":"org_id","required":true,"schema":{"type":"string"},"description":"The organization identifier."},{"in":"path","name":"project_id","required":true,"schema":{"type":"string"},"description":"The project identifier."},{"in":"path","name":"volume_id","required":true,"schema":{"type":"string","format":"uuid"},"description":"The volume identifier."}],"responses":{"204":{"description":"Network Volume deleted successfully."},"400":{"description":"Bad request. The volume cannot be deleted because it is in use.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"The network volume was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"An unexpected internal server error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Extend Network Volume Capacity

> Queues an asynchronous increase of the network volume size in gigabytes. The new size must be greater than the current size.

```json
{"openapi":"3.0.3","info":{"title":"Storage Service API","version":"0.1.0"},"servers":[{"url":"https://api.ai.neevcloud.com/storage","description":"Consolidated public API gateway"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ExtendNetworkVolumeRequest":{"type":"object","required":["sizeGB"],"properties":{"sizeGB":{"type":"integer","minimum":1,"description":"New total size of the volume in gigabytes. Must be strictly greater than the current size."}}},"NetworkVolumeResponse":{"type":"object","required":["id","name","orgID","projectID","regionID","sizeGB","volumeMode","planID","status"],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the network volume"},"name":{"type":"string","description":"Name of the network volume"},"orgID":{"type":"string","description":"Organization identifier"},"projectID":{"type":"string","description":"Project identifier"},"regionID":{"type":"string","description":"Region ID where the network volume is located"},"sizeGB":{"type":"integer","description":"Size of the volume in gigabytes"},"volumeMode":{"type":"string","description":"Volume mode of the volume (filesystem or block)"},"planID":{"type":"string","description":"The pricing plan ID associated with this volume"},"status":{"type":"string","enum":["pending","bound","failed","terminated"],"description":"Current status of the volume (PVC state: Pending=creating, Bound=ready, Failed=error)"},"extension_status":{"type":"string","enum":["resizing","succeeded","failed"],"description":"Status of the latest volume extension operation, if any."},"actual_sizeGB":{"type":"integer","description":"Last observed provisioned capacity in gigabytes for the latest volume extension operation."},"airuntime_instances":{"type":"array","description":"List of AIRuntime instances attached to this volume","items":{"$ref":"#/components/schemas/AttachedTo"}},"volumeAttachments":{"type":"array","description":"Currently-mounted resource attachments for this volume.","items":{"$ref":"#/components/schemas/VolumeAttachmentResponse"}},"createdAt":{"type":"string","format":"date-time","description":"Timestamp when the volume was created"},"updatedAt":{"type":"string","format":"date-time","description":"Timestamp when the volume was last updated"}}},"AttachedTo":{"type":"object","required":["instance_id","instance_name","instance_type"],"properties":{"instance_id":{"type":"string","format":"uuid","description":"AIRuntime instance ID"},"instance_name":{"type":"string","description":"AIRuntime instance name"},"instance_type":{"type":"string","description":"AIRuntime instance type"}}},"VolumeAttachmentResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the attachment"},"volume_id":{"type":"string","format":"uuid","description":"The volume this attachment belongs to"},"resource_type":{"type":"string","description":"Resource type (e.g. airuntime, vm)"},"resource_id":{"type":"string","format":"uuid","description":"Unique identifier of the resource instance"},"resource_name":{"type":"string","description":"Name of the resource instance"},"mount_path":{"type":"string","description":"Path where the volume is mounted on the resource"},"status":{"type":"string","enum":["mounted","unmounted"],"description":"Current mount status of the attachment"},"createdAt":{"type":"string","format":"date-time","description":"Timestamp when the attachment record was created"}}},"ErrorResponse":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"},"details":{"type":"object","description":"Additional error details"}}}}},"paths":{"/api/v1beta1/orgs/{org_id}/projects/{project_id}/volumes/{volume_id}/extend":{"post":{"tags":["Network Volumes"],"summary":"Extend Network Volume Capacity","description":"Queues an asynchronous increase of the network volume size in gigabytes. The new size must be greater than the current size.","operationId":"extendNetworkVolume","parameters":[{"in":"path","name":"org_id","required":true,"schema":{"type":"string"},"description":"The organization identifier."},{"in":"path","name":"project_id","required":true,"schema":{"type":"string"},"description":"The project identifier."},{"in":"path","name":"volume_id","required":true,"schema":{"type":"string","format":"uuid"},"description":"The volume identifier."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExtendNetworkVolumeRequest"}}}},"responses":{"202":{"description":"Network volume extension request accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkVolumeResponse"}}}},"400":{"description":"The request is invalid (e.g. new size is not greater than current size, or volume cannot be extended in its current state).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"The network volume was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"An unexpected internal server error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```


---

# 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.ai.neevcloud.com/api-reference/storage/network-volumes.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.