Skip to main content
GET
/
v2
/
sandboxes
/
usage
Get sandbox resource usage and quota limits
curl --request GET \
  --url https://api.example.com/v2/sandboxes/usage
{
  "sandboxes_used": 123,
  "sandbox_direct_count": 123,
  "sandbox_pool_replicas_count": 123,
  "sandboxes_limit": 123,
  "volumes_used": 123,
  "volumes_limit": 123,
  "templates_count": 123,
  "pools_count": 123,
  "registries_count": 123,
  "cpu_used_millicores": 123,
  "cpu_limit_millicores": 123,
  "memory_used_bytes": 123,
  "memory_limit_bytes": 123,
  "storage_used_bytes": 123,
  "storage_limit_bytes": 123
}

Response

200 - application/json

Successful Response

Response model for sandbox resource usage and quota limits.

Usage fields reflect current consumption across all sandboxes (claims + warmpool replicas) and volumes in the workspace. Limit fields come from the organization-level quota configuration (Metronome).

For self-hosted deployments where quotas are not enforced, limit fields are 0.

​
sandboxes_used
integer
required

Total sandbox instances (claims + warmpool replicas)

​
sandbox_direct_count
integer
required

Number of directly created sandbox instances

​
sandbox_pool_replicas_count
integer
required

Number of sandbox instances from warm pool replicas

​
sandboxes_limit
integer
required

Organization quota for max sandbox instances (0 = unlimited)

​
volumes_used
integer
required

Number of volumes

​
volumes_limit
integer
required

Organization quota for max volumes (0 = unlimited)

​
templates_count
integer
required

Number of templates

​
pools_count
integer
required

Number of warm pools

​
registries_count
integer
required

Number of registries

​
cpu_used_millicores
integer
required

Total CPU in millicores across all sandboxes

​
cpu_limit_millicores
integer
required

Organization CPU quota in millicores (0 = unlimited)

​
memory_used_bytes
integer
required

Total memory in bytes across all sandboxes

​
memory_limit_bytes
integer
required

Organization memory quota in bytes (0 = unlimited)

​
storage_used_bytes
integer
required

Total volume storage in bytes

​
storage_limit_bytes
integer
required

Organization storage quota in bytes (0 = unlimited)