Regions

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/regions

curl -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-west

curl -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.

List regions

Select a region at create

One client across regions

On this page