Regions

GET /v1/regions

Use a user session or OAuth access token to list regions. Omit organization_id to get enabled public regions, including during onboarding. Pass an organization UUID to get public regions and the RawTree BYOC regions available to that organization. The caller must be a member. RawTree BYOC regions require an active Unlimited plan.

The response contains a regions array. The organization-scoped list includes disabled entries. Check enabled before choosing a region. Deployments can share a cloud_region. Use the region's id to select a placement.

Use a user session or user OAuth token with full_access. API keys and workload tokens cannot use this method.

Parameters:

Request:

# List regions.
curl -X GET "https://api.rawtree.com/v1/regions" \
  -H "Authorization: Bearer $RAWTREE_USER_TOKEN"

Expected response: HTTP 200.

{
  "regions": [
    {
      "id": "11111111-1111-4111-8111-111111111111",
      "name": "aws-eu-west-1",
      "cloud_region": "eu-west-1",
      "enabled": true,
      "created_at": "2026-11-09T10:00:00Z",
      "updated_at": "2026-11-09T10:00:00Z",
      "organization_id": null
    }
  ]
}

Errors: 400, 401, 403. See API errors.