List Sandboxes

Retrieve a list of all sandboxes in your organization

GET /sandbox

cURL

curl -X GET "https://api.daytona.io/sandbox?verbose=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Daytona-Organization-ID: your-org-id"

Response

[
  {
    "id": "sandbox123",
    "organizationId": "org456",
    "name": "my-development-sandbox",
    "snapshot": "ubuntu-4vcpu-8ram-100gb",
    "user": "daytona",
    "env": {
      "NODE_ENV": "development"
    },
    "labels": {
      "project": "my-app",
      "environment": "dev"
    },
    "public": false,
    "networkBlockAll": false,
    "target": "us-east-1",
    "cpu": 4,
    "gpu": 0,
    "memory": 8,
    "disk": 100,
    "state": "started",
    "desiredState": "started",
    "autoStopInterval": 60,
    "createdAt": "2024-10-01T12:00:00Z",
    "updatedAt": "2024-10-01T12:00:00Z",
    "daemonVersion": "1.0.0",
    "runnerId": "runner789"
  },
  {
    "id": "sandbox456",
    "organizationId": "org456",
    "name": "production-sandbox",
    "snapshot": "ubuntu-8vcpu-16ram-200gb",
    "user": "daytona",
    "env": {
      "NODE_ENV": "production"
    },
    "labels": {
      "project": "my-app",
      "environment": "prod"
    },
    "public": true,
    "networkBlockAll": false,
    "target": "us-west-2",
    "cpu": 8,
    "gpu": 0,
    "memory": 16,
    "disk": 200,
    "state": "started",
    "desiredState": "started",
    "createdAt": "2024-09-15T08:30:00Z",
    "updatedAt": "2024-10-01T09:45:00Z",
    "daemonVersion": "1.0.0",
    "runnerId": "runner123"
  }
]

Retrieves a list of all sandboxes for the authenticated organization with optional filtering.

Headers

X-Daytona-Organization-ID · string

Use with JWT to specify the organization ID

Query Parameters

verbose · boolean

Include verbose output with additional sandbox details

Default: false

labels · string

JSON encoded labels to filter by

Example: {"label1": "value1", "label2": "value2"}

includeErroredDeleted · boolean

Include errored and deleted sandboxes in the results

Default: false

Response

Returns an array of sandbox objects.

id · string

The unique identifier of the sandbox

organizationId · string

The organization ID of the sandbox

name · string

The name of the sandbox

snapshot · string

The snapshot used for the sandbox

user · string

The user associated with the sandbox

env · object

Environment variables for the sandbox

labels · object

Labels for the sandbox

public · boolean

Whether the sandbox HTTP preview is public

networkBlockAll · boolean

Whether all network access is blocked

networkAllowList · string

Comma-separated list of allowed CIDR network addresses

target · string

The target environment for the sandbox

cpu · number

The CPU quota for the sandbox

gpu · number

The GPU quota for the sandbox

memory · number

The memory quota for the sandbox in GB

disk · number

The disk quota for the sandbox in GB

state · string

The current state of the sandbox

desiredState · string

The desired state of the sandbox

errorReason · string

The error reason if the sandbox is in an error state

recoverable · boolean

Whether the sandbox error is recoverable

backupState · string

The state of the backup

Options: None, Pending, InProgress, Completed, Error

backupCreatedAt · string

The creation timestamp of the last backup

autoStopInterval · number

Auto-stop interval in minutes

autoArchiveInterval · number

Auto-archive interval in minutes

autoDeleteInterval · number

Auto-delete interval in minutes

volumes · array

Array of volumes attached to the sandbox

createdAt · string

The creation timestamp of the sandbox

updatedAt · string

The last update timestamp of the sandbox

daemonVersion · string

The version of the daemon running in the sandbox

runnerId · string

The runner ID of the sandbox

cURL

curl -X GET "https://api.daytona.io/sandbox?verbose=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Daytona-Organization-ID: your-org-id"

Response

[
  {
    "id": "sandbox123",
    "organizationId": "org456",
    "name": "my-development-sandbox",
    "snapshot": "ubuntu-4vcpu-8ram-100gb",
    "user": "daytona",
    "env": {
      "NODE_ENV": "development"
    },
    "labels": {
      "project": "my-app",
      "environment": "dev"
    },
    "public": false,
    "networkBlockAll": false,
    "target": "us-east-1",
    "cpu": 4,
    "gpu": 0,
    "memory": 8,
    "disk": 100,
    "state": "started",
    "desiredState": "started",
    "autoStopInterval": 60,
    "createdAt": "2024-10-01T12:00:00Z",
    "updatedAt": "2024-10-01T12:00:00Z",
    "daemonVersion": "1.0.0",
    "runnerId": "runner789"
  },
  {
    "id": "sandbox456",
    "organizationId": "org456",
    "name": "production-sandbox",
    "snapshot": "ubuntu-8vcpu-16ram-200gb",
    "user": "daytona",
    "env": {
      "NODE_ENV": "production"
    },
    "labels": {
      "project": "my-app",
      "environment": "prod"
    },
    "public": true,
    "networkBlockAll": false,
    "target": "us-west-2",
    "cpu": 8,
    "gpu": 0,
    "memory": 16,
    "disk": 200,
    "state": "started",
    "desiredState": "started",
    "createdAt": "2024-09-15T08:30:00Z",
    "updatedAt": "2024-10-01T09:45:00Z",
    "daemonVersion": "1.0.0",
    "runnerId": "runner123"
  }
]