Create a named volume
Authorizations
Organization API key (msb_…) - org-scoped programmatic access.
Body
POST /v1/orgs/{slug}/volumes
Volume name, unique within the org. Lowercase alphanumeric with single
internal hyphens (e.g. team-ml). Creates a managed volume; the host
disk is system-provisioned and has no name.
Optional per-volume storage cap in GiB (#496). Omitted/null = no
per-volume limit (the org's plan cap still governs). Must be >= 1 and
<= the org's storage cap.
x >= 0User-defined labels (free-form string map). Omitted = none. Keys using a platform-reserved prefix are rejected.
Physical backing for the volume. Omitted = block (the default and only
value today).
block Response
Volume created
Volume metadata returned in list/create responses. The GCS storage path is derived (not stored) and never exposed.
host - the org's shared host disk (not deletable); managed - a
user-created named volume.
host, managed User-defined labels (empty object when none set).
Lifecycle status of a volume.
active, deleting How the volume is physically backed (block today).
block The volume's configured per-volume storage cap in bytes, or null when
no cap is set (#496). Derived from the stored capacity_gib (the user's
configured intent) - the effective ceiling is min(this, org cap).
x >= 0User-facing name. null for the host volume (it has no name; it's
identified by kind).
Bytes currently used under this volume's subtree. null when usage is
unavailable - the usage service is disabled or unreachable (list degrades
gracefully rather than failing) - or on create/delete, which don't sample
it.
x >= 0