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

# Sandbox pricing

> What a sandbox costs per hour, how usage is measured, and what each plan includes.

A sandbox is billed for the CPU and memory of its size, for the time it runs.

## Rates

| Resource | Rate |
| - | - |
| **CPU** | **\$0.015** per vCPU per hour |
| **Memory** | **\$0.008** per GB per hour |
| **Snapshot storage** | **\$0.25** per GB per month |

## Price per size

| Size | vCPU | Memory | Disk | Per hour |
| - | - | - | - | - |
| Micro (`sbx.micro`) | 1 | 1 GB | 2 GB | \$0.023 |
| Small (`sbx.small`) | 2 | 2 GB | 4 GB | \$0.046 |
| Medium (`sbx.medium`) | 2 | 4 GB | 8 GB | \$0.062 |

Which sizes you can create depends on your plan.

## How usage is measured

* **By the second.** There is no minimum charge and no rounding up to a minute or an hour.
* **From ready to stopped.** Billing starts when the sandbox is ready, not when you request it, and stops when it is paused or destroyed.
* **Paused sandboxes are not billed for CPU or memory.** Pausing releases the compute and keeps the sandbox's volume.
* **By size, not by load.** A sandbox is billed for the size it was created with, whether it is busy or idle. Destroy or pause sandboxes you are not using.

## Included with your plan

Each month your plan covers an amount of sandbox usage. The rates above apply beyond it.

| Plan | CPU included | Memory included |
| - | - | - |
| Hacker | 5 vCPU-hours | 10 GB-hours |
| Developer | 20 vCPU-hours | 40 GB-hours |
| Team | 20 vCPU-hours | 40 GB-hours |

Sandboxes are not available on the Free plan.

## Labels

You can label a sandbox when you create it, for example with the agent, run or customer it belongs to. Send `metadata` with up to 20 keys:

```bash theme={null}
curl -X POST https://core.brimble.io/v1/sandboxes \
  -H "x-brimble-key: $BRIMBLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"template": "node-22", "metadata": {"agent": "researcher", "run": "run-42"}}'
```

Labels are returned with the sandbox and attached to its costs in the [cost export](https://paper.brimble.io/billing/cost-export.md), so you can see what each agent, run or customer cost.

## Prices as data

The current rates and per-size prices are available without authentication:

```bash theme={null}
curl https://core.brimble.io/v1/sandbox-pricing
```

```json theme={null}
{
  "message": "Sandbox pricing fetched successfully",
  "data": {
    "currency": "USD",
    "billing_increment_seconds": 1,
    "minimum_billed_seconds": 0,
    "billed_while_paused": false,
    "rates": { "cpu_per_vcpu_hour": 0.015, "memory_per_gb_hour": 0.008 },
    "sizes": [
      { "name": "sbx.micro", "display_name": "Micro", "vcpu": 1, "memory_gb": 1, "disk_gb": 2, "price_per_hour": 0.023 }
    ]
  }
}
```


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