> ## Documentation Index
> Fetch the complete documentation index at: https://docs.costgraph.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Upstash Box sandboxes

> Run CostGraph workflows and CI jobs in Upstash Box sandboxes: the key to create, its permissions, and its limits

Upstash Box gives AI agents their own isolated cloud computer with a built-in agent, filesystem, shell, git and runtime.

The following table shows what CostGraph runs on this provider.

| Workflows | CI runners | Connect with |
| - | - | - |
| Yes | Yes | Integrations or your own dispatcher |

## Connect

Connect Upstash Box on Integrations, and CostGraph starts sandboxes in your Upstash Box account. You don't run anything yourself.

1. In CostGraph, go to **Integrations > Sandbox > Upstash Box**.

2. Enter these fields:

   * **Box API key** (`UPSTASH_BOX_API_KEY`, required): An Upstash Box API key from the Upstash console.

3. Click **Connect**.

For CI runners, CostGraph picks the smallest box size that fits: small, medium or large.

### Your own dispatcher

To keep the key out of CostGraph or reach a private network, run your own dispatcher instead.
Set `provider` to `upstash` and the preceding fields as environment variables, as described in [Run your own dispatcher](https://docs.costgraph.ai/costgraph/workflows/managed-sandboxes.md#run-your-own-dispatcher).

## Key and permissions

UPSTASH\_BOX\_API\_KEY is an Upstash Box API key (box\_...) created in the Upstash Console (console.upstash.com); it is also the SSH password for a box.

The provider doesn't document key scopes or roles, so a key has full access to the account.

Sources: [upstash.com: quickstart](https://upstash.com/docs/box/overall/quickstart.md), [upstash.com: pricing](https://upstash.com/docs/box/overall/pricing.md), [upstash.com: keep alive](https://upstash.com/docs/box/overall/keep-alive.md).

## Limits

* Sizes: small 2 vCPU/4 GB, medium 4 vCPU/8 GB, large 8 vCPU/16 GB. ([source](https://upstash.com/docs/box/overall/pricing.md))
* Standard boxes pause when idle: after 1 h on Free, 6 h on Pay as You Go, never on Fixed (keep-alive, paid only). ([source](https://upstash.com/docs/box/overall/pricing.md))
* Concurrency: Free 10 boxes; paid 1,000 (soft limit). ([source](https://upstash.com/docs/box/overall/pricing.md))
* Region: AWS us-east-1 only. Max lifetime and architecture not documented. ([source](https://upstash.com/docs/box/overall/pricing.md))

## Related

* [Supported sandbox providers](https://docs.costgraph.ai/costgraph/workflows/sandbox-providers.md)
* [Run workflows on a managed sandbox provider](https://docs.costgraph.ai/costgraph/workflows/managed-sandboxes.md)
* [Run CI jobs in sandboxes](https://docs.costgraph.ai/costgraph/autopilot/ci-sandboxes.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.