v1

latestOpenAPI 3.1.02026-07-2676123203.9 KB

Network Volumes

Create a network volume

Provisions a new network volume — persistent, network-attached storage that can be mounted into pods and serverless workers. Required inputs are name, size (in GB), and dataCenter; an optional type selects the storage tier and is immutable after creation. See CreateNetworkVolumeRequest for the size bounds and tier options.

This creates a billable persistent resource that keeps incurring storage charges until it is deleted. Returns 201 with the created network volume, including its assigned id.

post/v2/network-volumes

Request body

namestring required

Human-readable name

sizeinteger required

Storage to allocate in GB

dataCenterstring required

Data center in which to create the volume

type'STANDARD' | 'HIGH_PERFORMANCE'

Data center network volume storage type.

Example request

{
  "name": "my-dataset",
  "size": 50,
  "dataCenter": "EU-RO-1"
}

Response

Created

dataCenterIdstring

The Runpod data center ID where a network volume is located.

idstring

A unique string identifying a network volume.

namestring

A user-defined name for a network volume. The name does not need to be unique.

sizeinteger

The amount of disk space, in gigabytes (GB), allocated to a network volume.

Example response

{
  "dataCenterId": "EU-RO-1",
  "id": "agv6w2qcg7",
  "name": "my network volume",
  "size": 50
}