Get sandbox resource usage and quota limits

Return current resource consumption and organisation quota limits.

Sandbox counts include both direct claims and warmpool replicas. For self-hosted deployments limit fields are 0 (quotas not enforced).

GET /v2/sandboxes/usage

Get sandbox resource usage and quota limits

cURL

curl --request GET \
  --url https://api.example.com/v2/sandboxes/usage

200

{
  "sandboxes_used": 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)

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)