Create a volume

Create a new persistent block storage volume

POST

/auth/v1/seed/{namespace}/volumes

curl --request POST \
  --url /auth/v1/seed/{namespace}/volumes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"name":"training-data","cloud":"aws","region":"us-east-1","volume_type":"gp3","size_gb":500,"is_ephemeral":false}'

Path parameters

namespace

string

required

The namespace (user or organization) to create the volume in.

Body parameters

name

string

required

A unique name for the volume within the namespace. Allowed characters: alphanumeric, hyphens, underscores.

cloud

string

required

Cloud provider. One of `aws`, `azure`, `gcp`.

region

string

required

Cloud region to create the volume in (e.g., `us-east-1`, `westus2`, `europe-west1`).

volume_type

string

required

Storage type. One of `gp3`, `io2`, `standard`.

size_gb

integer

Volume size in gigabytes. Maximum `16384` (16 TB).

default: 50

is_ephemeral

boolean

If `true`, the volume is automatically deleted when the attached workload terminates.

default: false

Previous → Delete a storage mount

Next List volumes →