Skip to main content
DELETE
/
sandbox
/
{sandboxIdOrName}
curl -X DELETE https://api.daytona.io/sandbox/sandbox123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Daytona-Organization-ID: your-org-id"
{
  "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": "destroying",
  "desiredState": "destroyed",
  "createdAt": "2024-10-01T12:00:00Z",
  "updatedAt": "2024-10-01T18:00:00Z",
  "runnerId": "runner789"
}
Permanently deletes a sandbox and all associated resources. This action cannot be undone.

Headers

X-Daytona-Organization-ID
string
Use with JWT to specify the organization ID

Path Parameters

sandboxIdOrName
string
required
ID or name of the sandbox to delete

Response

Returns the deleted sandbox object with the updated state.
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
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 (will be destroying or destroyed)Options: destroying, destroyed
desiredState
string
The desired state of the sandbox
createdAt
string
The creation timestamp of the sandbox
updatedAt
string
The last update timestamp of the sandbox
runnerId
string
The runner ID of the sandbox
curl -X DELETE https://api.daytona.io/sandbox/sandbox123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Daytona-Organization-ID: your-org-id"
{
  "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": "destroying",
  "desiredState": "destroyed",
  "createdAt": "2024-10-01T12:00:00Z",
  "updatedAt": "2024-10-01T18:00:00Z",
  "runnerId": "runner789"
}

Notes

  • This operation is irreversible and will permanently delete the sandbox
  • All data stored in the sandbox will be lost unless backed up
  • Attached volumes are not automatically deleted and must be managed separately
  • The sandbox state will transition to destroying and eventually to destroyed

Build docs developers (and LLMs) love