API reference · Schema
PodVolumeSummary
idstringrequiredUnique ID
namestringrequiredIts name
kindstringrequired`pod`: this pod’s own volume. `network`: a network volume it mounts. (`cluster` volumes are never mounted by pods.)
One of
podnetworkclustersize_gbintegerrequiredSize in GB
pinned_to_hostbooleanrequiredThe volume lives on one host; pods using it run there
used_bytesinteger | nullrequiredSpace the volume uses on its host, as last measured; null until a host has measured it
usage_observed_atstring (date-time) | nullrequiredWhen `used_bytes` was measured
Example
{
"id": "string",
"name": "string",
"kind": "pod",
"size_gb": 1,
"pinned_to_host": true,
"used_bytes": 1,
"usage_observed_at": "2026-01-01T00:00:00.000Z"
}