divergent/docs
Compute · Commands

div limits

Show the org's sandboxes, seats, GPUs, containers and storage against its limits, and its spend against its usage limit.

Synopsis

div limits [flags]

Prints what the org is using now against the most its plan allows, and its spend this period against its usage limit.

Flags

Flag Description Default
--json Print the billing summary as JSON.
--token <key> API key to use. see Configuration
--api-url <url> API URL to use. see Configuration

Output

Pay as you go
sandbox cores      4  of 16      running
sandboxes          9  of 25      running and stopped
seats              1  of 2
GPUs               1  of 1
containers         3  of 10
storage        12 GB  of 50 GB   as last measured
usage         $41.20  of $500.00 this period, resets 2026-10-01

A line at its limit is highlighted. Below the biggest plan, a final line on stderr describes the next plan up.

Compute limits

Limit Pay as you go Personal Team
GPUs 1 4 8
Containers 10 10 10
Storage 50 GB 50 GB 50 GB
Limit What counts When reached
GPUs GPUs held by runs and endpoint replicas New runs are rejected with quota_exceeded.
Containers Runs, including CPU runs, and endpoint replicas New runs are rejected with container_quota_exceeded.
Storage Size of all volumes, measured every 15 minutes and after each upload Uploads are rejected with storage_full.

Every plan pays for GPU time per hour from the org’s credit, after the usage the plan includes. Pay as you go has no monthly fee and holds one GPU at a time. Contact us to raise a limit. Orgs on Compute Pro, which is no longer sold, keep its limits: 25 GPUs, 250 containers and 1 TB of storage.

Sandbox and seat limits depend on the plan. See Sandbox pricing and plans.

Reaching a limit does not stop anything already running. An idle endpoint still counts toward GPUs and containers.

Usage limit

The usage limit is an optional cap on the org’s spend per period. Set it at app.divergentlabs.xyz/billing. The period is the billing period on a paid plan and the calendar month (UTC) on pay as you go.

When the org reaches its usage limit, or runs out of credit without auto top-up:

  • Running runs stop within a minute with the status limit_reached. Running sandboxes stop, and endpoints scale to zero.
  • New runs are rejected with usage_limit_reached or insufficient_credit.
  • Nothing restarts automatically.

Exit codes

Code Meaning
0 Success.
1 The API rejected the request.
2 Invalid flags, or no API key.

Examples

div limits
div limits --json
esc