# Quota Limits - Documentation

> For the complete documentation index, see [llms.txt](/llms.txt). Markdown is available with `Accept: text/markdown` and `.md` URL variants.

Source: /docs/guides/sandbox-quota-limit

# Quota Limits

Agent Sandbox applies quota limits based on your account tier. Quotas define the resources and capabilities available to each tier.
If you need higher limits, please [contact our support team](https://meet.brevo.com/novita-ai/contact-sales).

##

[​](#account-tiers)

Account Tiers

Account TierDescriptionFreeThe default tier for new users.PaidAvailable after adding account balance or enabling a credit line.EnterpriseDesigned for enterprise customers that need custom limits and dedicated support.

##

[​](#default-quotas)

Default Quotas

LimitFreePaidEnterpriseConcurrent sandboxes5100500 by default, adjustableMaximum session duration1 hour3 hours4 hours by default, adjustableMaximum vCPU2 vCPU8 vCPU8 vCPU by default, adjustableMaximum memory4 GiB8 GiB8 GiB by default, adjustableLocal disk space20 GB20 GB20 GB by default, adjustableMemory increment512 MiB512 MiB512 MiBMemory per vCPU0.5-4 GiB0.5-4 GiB0.5-4 GiB

##

[​](#configuration-rules)

Configuration Rules

When configuring CPU and memory, your configuration must meet the following requirements:

- vCPU must not exceed the maximum vCPU limit for your account tier.

- Memory must not exceed the maximum memory limit for your account tier.

- vCPU must be configured as an integer value, such as 1, 2, 4, or 8 vCPU.

- Memory must be configured in 512 MiB increments.

- Memory must be within the allowed range of 0.5-4 GiB per vCPU.

For example:

- 1 vCPU supports 512 MiB to 4 GiB of memory.

- 2 vCPU supports 1 GiB to 8 GiB of memory.

- 4 vCPU can support up to 16 GiB of memory based on the memory-per-vCPU range, but the actual available memory is still limited by the maximum memory quota of your account tier.

The final available configuration is determined by both your account tier limits and the allowed memory-per-vCPU range.

##

[​](#check-current-quota-usage)

Check Current Quota Usage

Use the quota API to check the quota limits available to your account and the resources currently in use. This is useful before launching a large batch of sandboxes or when troubleshooting quota-related launch failures.

###

[​](#check-quota-usage-using-the-sdks)

Check quota usage using the SDKs

JavaScript & TypeScript

Python

```
import { Sandbox } from 'novita-sandbox'

const quota = await Sandbox.getQuota()

console.log('Quota limit:', quota.limit)
console.log('Current usage:', quota.usage)

// Example shape:
// {
// limit: {
// concurrentInstances: 100,
// concurrentVcpu: 200,
// concurrentRamMb: 409600,
// maxLengthHours: 4,
// diskMb: 20480,
// maxVcpu: 8,
// maxRamMb: 8192
// },
// usage: {
// concurrentInstances: 12,
// concurrentVcpu: 24,
// concurrentRamMb: 49152
// }
// }
```

```
from novita_sandbox.core import Sandbox

quota = Sandbox.get_quota()

print('Quota limit:', quota.limit)
print('Current usage:', quota.usage)

# Example shape:
# {
# "limit": {
# "concurrentInstances": 100,
# "concurrentVcpu": 200,
# "concurrentRamMb": 409600,
# "maxLengthHours": 4,
# "diskMb": 20480,
# "maxVcpu": 8,
# "maxRamMb": 8192,
# },
# "usage": {
# "concurrentInstances": 12,
# "concurrentVcpu": 24,
# "concurrentRamMb": 49152,
# },
# }
```

###

[​](#quota-response-fields)

Quota response fields

The quota response includes `limit` and `usage` objects.

FieldDescription`limit.concurrentInstances`Maximum number of sandboxes that can run concurrently.`limit.concurrentVcpu`Maximum total vCPU cores that can be used concurrently.`limit.concurrentRamMb`Maximum total RAM that can be used concurrently, in MB.`limit.maxLengthHours`Maximum lifetime for a single sandbox, in hours.`limit.diskMb`Available runtime storage for a single sandbox, in MB.`limit.maxVcpu`Maximum vCPU cores for a single sandbox. Applies after the template is built.`limit.maxRamMb`Maximum memory for a single sandbox, in MB. Applies after the template is built.`usage.concurrentInstances`Current number of running sandboxes.`usage.concurrentVcpu`Current total vCPU cores in use.`usage.concurrentRamMb`Current total RAM in use, in MB.

Quota usage is intended for capacity planning and troubleshooting. Usage data may have a short delay, depending on the backend resource reporting path.

##

[​](#notes)

Notes

- If your resource configuration exceeds the quota for your account tier, the request will fail.

- If a region has no available capacity, sandbox creation may fail with a quota or rate-limit related error even when your account-level quota has not been fully used.

- Choose CPU and memory based on your workload requirements to avoid out-of-memory errors or unnecessary resource usage.

- Enterprise quotas can be customized based on your requirements. To request a quota increase, please [contact our support team](https://meet.brevo.com/novita-ai/contact-sales).

Last modified on July 1, 2026