List sandboxes

GET

sandboxes

instances

List sandboxes

curl --request GET \
  --url https://api.baseten.co/v1/sandboxes/instances \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.baseten.co/v1/sandboxes/instances', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.baseten.co/v1/sandboxes/instances",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.baseten.co/v1/sandboxes/instances"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.baseten.co/v1/sandboxes/instances")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "lifecycle": {
        "expiration_policies": [
          {
            "action": "DELETE",
            "type": "TTL_IDLE",
            "value": "24h"
          },
          {
            "action": "DELETE",
            "type": "TTL_MAX_AGE",
            "value": "7d"
          },
          {
            "action": "DELETE",
            "type": "DATE",
            "value": "2026-09-23T21:26:58Z"
          }
        ],
        "terminated_retention": "24h"
      },
      "network": {
        "proxy": {
          "allowed_domains": [
            "api.openai.com",
            "pypi.org",
            "files.pythonhosted.org",
            "registry.npmjs.org"
          ],
          "bypass": [
            "registry.npmjs.org"
          ],
          "forbidden_domains": [
            "facebook.com",
            "*.facebook.com"
          ],
          "routing": [
            {
              "destinations": [
                "api.openai.com"
              ],
              "headers": {
                "Authorization": "Bearer {{SECRET:openai-key}}"
              },
              "body": {
                "user": "baseten-api-review-0916"
              }
            }
          ]
        },
        "subnet": "default"
      },
      "region": "us-pdx-1",
      "envs": [
        {
          "name": "NODE_ENV",
          "secret": false,
          "value": "production"
        },
        {
          "name": "PORT",
          "secret": false,
          "value": "3000"
        }
      ],
      "image": "baseten/base-image:latest",
      "memory": 4096,
      "ports": [
        {
          "name": "http",
          "protocol": "HTTP",
          "target": 3000
        }
      ],
      "external_id": "api-review-20260916-001",
      "labels": {
        "env": "development",
        "project": "api-review",
        "team": "engineering"
      },
      "name": "baseten-api-review-0916",
      "url": "https://sbx-baseten-api-review-0916-esb1qo.us-pdx-1.b10.run",
      "status": "DEPLOYED",
      "created_at": "2026-09-16T21:26:58.545765901Z",
      "updated_at": "2026-09-16T21:31:13Z",
      "created_by": "sandbox-automation",
      "updated_by": "sandbox-automation",
      "last_used_at": "2026-09-16T21:31:13Z",
      "expires_in": 86400
    }
  ],
  "pagination": {
    "has_more": true,
    "cursor": "eyJ2IjoxLCJsYXN0X2tleSI6ImJhc2V0ZW4tYXBpLXJldmlldy0wOTE2Iiwic29ydCI6ImRlc2MifQ"
  }
}

Related guide: Manage sandboxes.

Authorizations

Authorization

string

header

required

Send Authorization: Bearer <api_key>. The legacy Authorization: Api-Key <api_key> scheme is also accepted.

Headers

X-Team-Id

string

Optional team ID. Must match the team_id query parameter when both are supplied. If neither selector is supplied, defaults to the caller's only accessible team. Callers with multiple accessible teams must select a team. Requests without access to any team are forbidden.

Minimum string length: 1

Query Parameters

team_id

string

Optional team ID. Must match X-Team-Id when both are supplied. If neither selector is supplied, defaults to the caller's only accessible team. Callers with multiple accessible teams must select a team. Requests without access to any team are forbidden.

Minimum string length: 1

cursor

string

Opaque cursor from the previous page; omit for the first page.

Example:

"eyJ2IjoxLCJsYXN0X2tleSI6ImJhc2V0ZW4tYXBpLXJldmlldy0wOTE2Iiwic29ydCI6ImRlc2MifQ"

limit

integer

default:20

Maximum number of items to return.

Required range: 1 <= x <= 100

Example:

20

string

Search indexed sandbox names and labels. Search is applied before pagination.

Example:

"api-review"

status

string[]

Deployment statuses. Repeat the query parameter for each status, for example status=DEPLOYED&status=FAILED. Unknown values are rejected. Cannot be combined with external_id.

Minimum array length: 1

Minimum string length: 1

Example:

["DEPLOYED", "FAILED"]

external_id

string

Filter by a caller-owned external identifier. Cannot be combined with status.

Example:

"api-review-20260916-001"

Response

Successful operation.

One page of sandboxes.

items

object[]

required

Resources on this page.

Show child attributes

Example:

[
  {
    "lifecycle": {
      "expiration_policies": [
        {
          "action": "DELETE",
          "type": "TTL_IDLE",
          "value": "24h"
        },
        {
          "action": "DELETE",
          "type": "TTL_MAX_AGE",
          "value": "7d"
        },
        {
          "action": "DELETE",
          "type": "DATE",
          "value": "2026-09-23T21:26:58Z"
        }
      ],
      "terminated_retention": "24h"
    },
    "network": {
      "proxy": {
        "allowed_domains": [
          "api.openai.com",
          "pypi.org",
          "files.pythonhosted.org",
          "registry.npmjs.org"
        ],
        "bypass": ["registry.npmjs.org"],
        "forbidden_domains": ["facebook.com", "*.facebook.com"],
        "routing": [
          {
            "destinations": ["api.openai.com"],
            "headers": {
              "Authorization": "Bearer {{SECRET:openai-key}}"
            },
            "body": { "user": "baseten-api-review-0916" }
          }
        ]
      },
      "subnet": "default"
    },
    "region": "us-pdx-1",
    "envs": [
      {
        "name": "NODE_ENV",
        "secret": false,
        "value": "production"
      },
      {
        "name": "PORT",
        "secret": false,
        "value": "3000"
      }
    ],
    "image": "baseten/base-image:latest",
    "memory": 4096,
    "ports": [
      {
        "name": "http",
        "protocol": "HTTP",
        "target": 3000
      }
    ],
    "external_id": "api-review-20260916-001",
    "labels": {
      "env": "development",
      "project": "api-review",
      "team": "engineering"
    },
    "name": "baseten-api-review-0916",
    "url": "https://sbx-baseten-api-review-0916-esb1qo.us-pdx-1.b10.run",
    "status": "DEPLOYED",
    "created_at": "2026-09-16T21:26:58.545765901Z",
    "updated_at": "2026-09-16T21:31:13Z",
    "created_by": "sandbox-automation",
    "updated_by": "sandbox-automation",
    "last_used_at": "2026-09-16T21:31:13Z",
    "expires_in": 86400
  }
]

pagination

object

required

Cursor pagination information. The cursor is present only when another page is available.

Show child attributes

Example:

{
  "has_more": true,
  "cursor": "eyJ2IjoxLCJsYXN0X2tleSI6ImJhc2V0ZW4tYXBpLXJldmlldy0wOTE2Iiwic29ydCI6ImRlc2MifQ"
}

⌘I

List sandboxes

curl --request GET \
  --url https://api.baseten.co/v1/sandboxes/instances \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.baseten.co/v1/sandboxes/instances', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.baseten.co/v1/sandboxes/instances",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.baseten.co/v1/sandboxes/instances"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.baseten.co/v1/sandboxes/instances")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "lifecycle": {
        "expiration_policies": [
          {
            "action": "DELETE",
            "type": "TTL_IDLE",
            "value": "24h"
          },
          {
            "action": "DELETE",
            "type": "TTL_MAX_AGE",
            "value": "7d"
          },
          {
            "action": "DELETE",
            "type": "DATE",
            "value": "2026-09-23T21:26:58Z"
          }
        ],
        "terminated_retention": "24h"
      },
      "network": {
        "proxy": {
          "allowed_domains": [
            "api.openai.com",
            "pypi.org",
            "files.pythonhosted.org",
            "registry.npmjs.org"
          ],
          "bypass": [
            "registry.npmjs.org"
          ],
          "forbidden_domains": [
            "facebook.com",
            "*.facebook.com"
          ],
          "routing": [
            {
              "destinations": [
                "api.openai.com"
              ],
              "headers": {
                "Authorization": "Bearer {{SECRET:openai-key}}"
              },
              "body": {
                "user": "baseten-api-review-0916"
              }
            }
          ]
        },
        "subnet": "default"
      },
      "region": "us-pdx-1",
      "envs": [
        {
          "name": "NODE_ENV",
          "secret": false,
          "value": "production"
        },
        {
          "name": "PORT",
          "secret": false,
          "value": "3000"
        }
      ],
      "image": "baseten/base-image:latest",
      "memory": 4096,
      "ports": [
        {
          "name": "http",
          "protocol": "HTTP",
          "target": 3000
        }
      ],
      "external_id": "api-review-20260916-001",
      "labels": {
        "env": "development",
        "project": "api-review",
        "team": "engineering"
      },
      "name": "baseten-api-review-0916",
      "url": "https://sbx-baseten-api-review-0916-esb1qo.us-pdx-1.b10.run",
      "status": "DEPLOYED",
      "created_at": "2026-09-16T21:26:58.545765901Z",
      "updated_at": "2026-09-16T21:31:13Z",
      "created_by": "sandbox-automation",
      "updated_by": "sandbox-automation",
      "last_used_at": "2026-09-16T21:31:13Z",
      "expires_in": 86400
    }
  ],
  "pagination": {
    "has_more": true,
    "cursor": "eyJ2IjoxLCJsYXN0X2tleSI6ImJhc2V0ZW4tYXBpLXJldmlldy0wOTE2Iiwic29ydCI6ImRlc2MifQ"
  }
}

Reference

Inference API

Management API

Loops API

Training API

Frontier Gateway API

CLI reference

SDKs and clients

Configuration

Metrics

Integrations

Authorizations

Headers

Query Parameters

Response