Skip to main content
POST
Create a new persistent volume

Authorizations

Authorization
string
header
required

API key passed as Bearer token

Body

application/json
name
string
required

Response

Volume created

id
string
required
name
string
required
created_at
string<date-time>
required
used_bytes
integer<int64>
required

Last reconciled observed bytes stored in the volume.

inode_count
integer<int64>
required

Last reconciled observed inode count for the volume.

mount_count
integer<int32>
required

Current number of active or paused volume mounts tracked by the control plane.

max_size_bytes
integer<int64> | null
required

Current enforced storage quota in bytes. In elastic deployments this value can increase automatically up to operator policy limits; it is not a public resize request field.

max_file_count
integer<int64> | null
required

Current enforced file-count quota, when configured.

max_mounts
integer<int32> | null
required

Current enforced concurrent-mount limit, when configured.

last_reconciled_at
string<date-time> | null
required
status
enum<string>
required
Available options:
available,
attached,
degraded,
error
host_id
string
deprecated

Optional operational diagnostic for legacy clients. Normal public volume responses omit this field; it is not durable volume identity.