Sign in
quotas

GET /v1/quotas — quota usage for the key's org.

Return current resource usage, plan limits, and organization-specific quota overrides.

get/v1/quotas

Response

Quota usage

hard_capboolean required

Whether the plan hard-stops at its included pools (no overflow). DERIVED (not a stored column): true iff the resolved plan is unpriced — an unpriced plan has no overage path, so its pools become walls.

included_memory_gib_hoursinteger nullable

Included memory GiB-hours/month; None = unlimited.

included_vcpu_hoursinteger nullable

Included vCPU-hours/month; None = unlimited. On hard_cap plans this is the compute wall; on priced plans, usage beyond it is metered overage.

memory_gib_hours_usednumber double required

Memory GiB-hours consumed this billing month (compute-on-read from sandbox_runs).

vcpu_hours_usednumber double required

vCPU-hours consumed this billing month (compute-on-read from sandbox_runs).

concurrent_ephemeral_runninginteger required

Currently running/starting ephemeral sandboxes.

concurrent_persistent_runninginteger required

Currently running/starting persistent sandboxes.

included_disk_gib_hoursinteger nullable

Included writable-disk GiB-hours/month (display/billing only — never a wall).

included_storage_gibinteger nullable

Included durable-storage GiB/month.

is_suspendedboolean required

Whether sandbox usage has been manually suspended for the organization.

max_concurrent_ephemeral_runninginteger nullable

Maximum simultaneously-running ephemeral sandboxes.

max_concurrent_persistent_runninginteger nullable

Maximum simultaneously-running persistent sandboxes.

max_disk_size_mib_per_sandboxinteger nullable

Maximum writable disk size (MiB) per sandbox.

max_memory_mib_per_sandboxinteger nullable

Maximum memory (MiB) per sandbox.

max_sandboxesinteger nullable

Maximum total sandboxes the org can have.

max_total_storage_gibinteger nullable

Per-org durable-storage hard cap (GiB).

max_uptime_minutes_per_sandboxinteger nullable

Maximum uptime per sandbox (minutes), if set.

max_vcpus_per_sandboxinteger nullable

Maximum CPU cores per sandbox.

pool_exhaustedboolean required

Snapshot of [PoolUsage::pool_exhausted] at read time, for API consumers — true when this org's sandboxes are being stopped and starts refused.

total_sandboxesinteger required

Total sandboxes (all states) for the org.

Changes