Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
| 1 | --- |
| 2 | title: 'SDKs add sandbox compute tier for Tool Router workbench' |
| 3 | description: 'TypeScript and Python SDKs gain `workbench.sandboxSize` / `workbench.sandbox_size` to pick the workbench sandbox tier (standard, medium, large, xlarge). Patch releases.' |
| 4 | date: '2026-04-28' |
| 5 | --- |
| 6 | |
| 7 | The Composio SDKs now let you pick the compute tier of the [sandbox](/docs/sandbox/remote) when creating a Tool Router session. Heavier code execution and larger in-memory data benefit from a bigger sandbox. |
| 8 | |
| 9 | | Tier | vCPU | RAM | |
| 10 | | ---------- | ---- | ----- | |
| 11 | | `standard` | 1 | 1 GB | |
| 12 | | `medium` | 2 | 2 GB | |
| 13 | | `large` | 4 | 4 GB | |
| 14 | | `xlarge` | 8 | 8 GB | |
| 15 | |
| 16 | The field is optional and defaults to `standard` server-side when omitted, so existing code keeps working unchanged. |
| 17 | |
| 18 | <Callout type="info"> |
| 19 | **Pricing:** Sandboxes are not billed today. Composio plans to begin billing for sandbox usage soon (metered by tier and runtime). Pick a tier that matches your workload — but expect future pricing to track actual usage. |
| 20 | </Callout> |
| 21 | |
| 22 | ### SDK versions (patch releases) |
| 23 | |
| 24 | | Package | Previous | This release | |
| 25 | | ------- | -------- | ------------ | |
| 26 | | TypeScript `@composio/core` | v0.8.0 | **v0.8.1** | |
| 27 | | Python `composio` | v0.12.0 | **v0.12.1** | |
| 28 | |
| 29 | ### Usage |
| 30 | |
| 31 | **TypeScript** (camelCase on the SDK surface): |
| 32 | |
| 33 | ```typescript |
| 34 | import { Composio } from '@composio/core'; |
| 35 | const composio = new Composio({ apiKey: process.env.COMPOSIO_API_KEY! }); |
| 36 | |
| 37 | const session = await composio.create('user_123', { |
| 38 | workbench: { |
| 39 | enable: true, |
| 40 | sandboxSize: 'large', |
| 41 | }, |
| 42 | }); |
| 43 | ``` |
| 44 | |
| 45 | The `SandboxSize` literal type and `SandboxSizeSchema` zod enum are exported from `@composio/core`. |
| 46 | |
| 47 | **Python** (snake_case throughout): |
| 48 | |
| 49 | ```python |
| 50 | session = composio.create( |
| 51 | user_id="user_123", |
| 52 | workbench={ |
| 53 | "sandbox_size": "large", |
| 54 | }, |
| 55 | ) |
| 56 | ``` |
| 57 | |
| 58 | The `SandboxSize` literal alias is available at `composio.core.models.tool_router.SandboxSize`. |
| 59 | |
| 60 | ### Updating an existing session |
| 61 | |
| 62 | Calling `session.update()` (or the equivalent `PATCH /api/v3/tool_router/sessions/{id}`) with a different `sandbox_size` recreates the sandbox on next access. The sandbox's in-memory filesystem state is lost, but the persistent `/mnt/files/` mount survives the restart. |
| 63 | |
| 64 | See [Configuring Sessions → Sandbox compute tier](/docs/configuring-sessions#sandbox-compute-tier) for the full reference. |