Regions
List available regions and select one when you create a sandbox.
A region is the location where a sandbox runs. Each region pools one or more datacenters. Select a region to place a sandbox near your users or your data.
List regions
The response includes regions enabled for your organization with ready capacity. EU remains enabled by default. US requires an organization grant.
const regions = await client.regions.list();regions = client.regions.list()# no dedicated CLI command — use pt api
pt api /v1/regionscurl -s "$PT_API_URL/v1/regions" \
-H "Authorization: Bearer $PT_TOKEN"| Field | Type | Meaning |
|---|---|---|
region | string | Key to pass as region at create |
label | string | Display name |
gpuAvailable | boolean | Region has GPU capacity |
Select a region at create
The region is fixed at create. You cannot move a sandbox to another region.
If the region has no capacity for the requested shape, create fails. Retry with another region or a smaller shape.
Pass region on sandbox create.
const sbx = await client.sandboxes.create({ template: "pt-base", region: "eu-west" });sbx = client.sandboxes.create(template="pt-base", region="eu-west")pt sandbox create -t pt-base --region eu-westcurl -s -X POST "$PT_API_URL/v1/sandboxes?wait_for_state=running" \
-H "Authorization: Bearer $PT_TOKEN" \
-H "Content-Type: application/json" \
-d '{"template":"pt-base","region":"eu-west"}'| You pass | Placement |
|---|---|
| A known region | Any datacenter in that region with capacity |
| Nothing | The template's region if set, else the serving region |
The sandbox object carries the assigned region. Read it with sandbox get.
One client across regions
Use the same dashboard, API entry point, and credentials for both regions. Select US when you create a sandbox or build a template.
Organizations enabled for multiple regions receive a combined sandbox list. The dashboard names regions that fail to respond. EU-only lists stay local.
SDK sandbox handles use the returned api_url automatically. Raw WebSocket clients must connect to that origin. Templates must be available in the selected region.
For build-context uploads, pass the same region to /v1/templates/from-build/presign and /v1/templates/from-build.
Full endpoint schemas: API reference.