archal usage are the source of truth for a
workspace’s current balance, reserved usage, and limits.
Lifetime
ttlSeconds can be reduced by plan or server policy. Read expiresAt and the
optional lease object from the response. Current API and web facade TTL
enforcement are not yet uniform, so do not publish or assume one plan-wide
maximum.
Sandboxes can also have an idle boundary. Activity and renewal do not permit a
sandbox to cross hardExpiresAt.
Concurrency and request safeguards
- workspace policy limits concurrent sandboxes
- sandbox, key, and workspace request limits apply before provider proxying
- state and create bodies have bounded sizes
429can includeRetry-After- capacity can reject new work even when a balance is positive
Enforced request limits
The web create facade enforces the 64 KiB body limit. The direct control plane
has a wider general request limit, but portable clients should stay within the
smaller boundary. A diff can report a larger total while returning at most
1,000 individual changes.
Usage
Each environment begins billing when it is ready. Cold-start time and failed provisioning are free. Runtime is $0.10 per active environment-minute and is prorated by the billed second. Billing stops after durable teardown intent, expiry, or a policy stop. Physical runtime deletion can complete afterward.Cost control
- create only the environments one test needs
- use one sandbox per independent test group or shard
- keep TTL close to the expected job length
- cap parallel jobs below the workspace limit
- destroy in always-run cleanup
- monitor initial CI runs before increasing parallelism
