Overview
Add Daytona to any ModuleX agent or workflow. Run AI-generated code and shell commands in secure, isolated cloud sandboxes via the Daytona REST API (app.daytona.io) and per-sandbox toolbox API (proxy.app.daytona.io/toolbox). Create and manage sandboxes, execute commands, run Python/JavaScript/TypeScript, transfer files, and clone Git repositories.
Categories: Developer Tools & Infrastructure · Cloud · Automation · Auth: API Key · Actions: 12
Authentication
API Key Authentication
Authenticate using your Daytona API keyStep 1
Go to https://app.daytona.io and sign up or log in
Required Credentials
| Field | Description | Required | Format |
|---|---|---|---|
| Daytona API Key | Your Daytona API key from app.daytona.io | Yes | - |
Available Actions
create_sandbox — Create a new Daytona sandbox for running AI-generated code in isolation.
create_sandbox — Create a new Daytona sandbox for running AI-generated code in isolation.
Parameters
ID or name of the snapshot to create the sandbox from (uses default if empty)
Name for the sandbox (defaults to the sandbox ID)
Region where the sandbox will be created (e.g., us, eu)
User associated with the sandbox
Environment variables to set in the sandbox as key-value pairs
Labels to attach to the sandbox as key-value pairs
CPU cores to allocate to the sandbox
Memory to allocate to the sandbox in GB
Disk space to allocate to the sandbox in GB
Auto-stop interval in minutes (0 disables auto-stop)
Auto-archive interval in minutes (0 uses the maximum interval)
Auto-delete interval in minutes (negative disables, 0 deletes immediately on stop)
Whether the sandbox HTTP preview is publicly accessible
Response
{
"$defs": {
"SandboxSummary": {
"additionalProperties": false,
"description": "Normalized summary of a Daytona sandbox.",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "State"
},
"snapshot": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Snapshot"
},
"target": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Target"
},
"cpu": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Cpu"
},
"gpu": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Gpu"
},
"memory": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Memory"
},
"disk": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Disk"
},
"labels": {
"additionalProperties": true,
"title": "Labels",
"type": "object"
},
"public": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Public"
},
"error_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error Reason"
},
"auto_stop_interval": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Auto Stop Interval"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created At"
},
"updated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated At"
}
},
"title": "SandboxSummary",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"sandbox": {
"anyOf": [
{
"$ref": "#/$defs/SandboxSummary"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"success"
],
"title": "CreateSandboxOutput",
"type": "object"
}
run_code — Run Python, JavaScript, or TypeScript code inside a Daytona sandbox.
run_code — Run Python, JavaScript, or TypeScript code inside a Daytona sandbox.
Parameters
ID of the sandbox to run the code in
Code to run
Language of the code: python, javascript, or typescript
Environment variables to set for the run as key-value pairs
Timeout in seconds (defaults to 10 seconds)
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"exit_code": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Exit Code"
},
"result": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Result"
},
"artifacts": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Artifacts"
}
},
"required": [
"success"
],
"title": "RunCodeOutput",
"type": "object"
}
execute_command — Execute a shell command inside a Daytona sandbox.
execute_command — Execute a shell command inside a Daytona sandbox.
Parameters
ID of the sandbox to execute the command in
Shell command to execute
Working directory for the command (defaults to the sandbox working directory)
Environment variables to set for the command as key-value pairs
Timeout in seconds (defaults to 10 seconds)
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"exit_code": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Exit Code"
},
"result": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Result"
}
},
"required": [
"success"
],
"title": "ExecuteCommandOutput",
"type": "object"
}
upload_file — Upload a file to a Daytona sandbox.
upload_file — Upload a file to a Daytona sandbox.
Parameters
ID of the sandbox to upload the file to
Destination path in the sandbox (a trailing slash uploads into that directory using the file name)
Base64-encoded content of the file to upload
Optional file name override
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"uploaded_path": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Uploaded Path"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Size"
}
},
"required": [
"success"
],
"title": "UploadFileOutput",
"type": "object"
}
download_file — Download a file from a Daytona sandbox (returned base64-encoded inline).
download_file — Download a file from a Daytona sandbox (returned base64-encoded inline).
Parameters
ID of the sandbox to download the file from
Path of the file in the sandbox
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"mime_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mime Type"
},
"size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Size"
},
"content_base64": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content Base64"
}
},
"required": [
"success"
],
"title": "DownloadFileOutput",
"type": "object"
}
list_files — List files in a directory of a Daytona sandbox.
list_files — List files in a directory of a Daytona sandbox.
Parameters
ID of the sandbox to list files in
Directory path to list (defaults to the sandbox working directory)
Response
{
"$defs": {
"FileInfo": {
"additionalProperties": false,
"description": "A single entry returned by ``list_files``.",
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"is_dir": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Is Dir"
},
"size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Size"
},
"mode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mode"
},
"permissions": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Permissions"
},
"owner": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Owner"
},
"group": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Group"
},
"modified_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Modified At"
}
},
"title": "FileInfo",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"files": {
"items": {
"$ref": "#/$defs/FileInfo"
},
"title": "Files",
"type": "array"
}
},
"required": [
"success"
],
"title": "ListFilesOutput",
"type": "object"
}
git_clone — Clone a Git repository into a Daytona sandbox.
git_clone — Clone a Git repository into a Daytona sandbox.
Parameters
ID of the sandbox to clone the repository into
URL of the Git repository to clone
Path in the sandbox to clone the repository into
Branch to clone (defaults to the default branch)
Specific commit to check out after cloning
Username for authenticating to private repositories
Password or personal access token for private repositories
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"repo_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Repo Url"
},
"clone_path": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Clone Path"
}
},
"required": [
"success"
],
"title": "GitCloneOutput",
"type": "object"
}
list_sandboxes — List Daytona sandboxes in the organization.
list_sandboxes — List Daytona sandboxes in the organization.
Parameters
Maximum number of sandboxes to return (1-200)
Filter sandboxes by name prefix (case-insensitive)
Filter sandboxes by labels as key-value pairs
Pagination cursor from a previous response
Response
{
"$defs": {
"SandboxSummary": {
"additionalProperties": false,
"description": "Normalized summary of a Daytona sandbox.",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "State"
},
"snapshot": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Snapshot"
},
"target": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Target"
},
"cpu": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Cpu"
},
"gpu": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Gpu"
},
"memory": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Memory"
},
"disk": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Disk"
},
"labels": {
"additionalProperties": true,
"title": "Labels",
"type": "object"
},
"public": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Public"
},
"error_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error Reason"
},
"auto_stop_interval": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Auto Stop Interval"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created At"
},
"updated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated At"
}
},
"title": "SandboxSummary",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"sandboxes": {
"items": {
"$ref": "#/$defs/SandboxSummary"
},
"title": "Sandboxes",
"type": "array"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Cursor"
}
},
"required": [
"success"
],
"title": "ListSandboxesOutput",
"type": "object"
}
get_sandbox — Get details of a Daytona sandbox.
get_sandbox — Get details of a Daytona sandbox.
Parameters
ID or name of the sandbox
Response
{
"$defs": {
"SandboxSummary": {
"additionalProperties": false,
"description": "Normalized summary of a Daytona sandbox.",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "State"
},
"snapshot": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Snapshot"
},
"target": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Target"
},
"cpu": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Cpu"
},
"gpu": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Gpu"
},
"memory": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Memory"
},
"disk": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Disk"
},
"labels": {
"additionalProperties": true,
"title": "Labels",
"type": "object"
},
"public": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Public"
},
"error_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error Reason"
},
"auto_stop_interval": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Auto Stop Interval"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created At"
},
"updated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated At"
}
},
"title": "SandboxSummary",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"sandbox": {
"anyOf": [
{
"$ref": "#/$defs/SandboxSummary"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"success"
],
"title": "GetSandboxOutput",
"type": "object"
}
start_sandbox — Start a stopped Daytona sandbox.
start_sandbox — Start a stopped Daytona sandbox.
Parameters
ID or name of the sandbox
Response
{
"$defs": {
"SandboxSummary": {
"additionalProperties": false,
"description": "Normalized summary of a Daytona sandbox.",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "State"
},
"snapshot": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Snapshot"
},
"target": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Target"
},
"cpu": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Cpu"
},
"gpu": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Gpu"
},
"memory": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Memory"
},
"disk": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Disk"
},
"labels": {
"additionalProperties": true,
"title": "Labels",
"type": "object"
},
"public": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Public"
},
"error_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error Reason"
},
"auto_stop_interval": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Auto Stop Interval"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created At"
},
"updated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated At"
}
},
"title": "SandboxSummary",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"sandbox": {
"anyOf": [
{
"$ref": "#/$defs/SandboxSummary"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"success"
],
"title": "StartSandboxOutput",
"type": "object"
}
stop_sandbox — Stop a running Daytona sandbox.
stop_sandbox — Stop a running Daytona sandbox.
Parameters
ID or name of the sandbox
Response
{
"$defs": {
"SandboxSummary": {
"additionalProperties": false,
"description": "Normalized summary of a Daytona sandbox.",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "State"
},
"snapshot": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Snapshot"
},
"target": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Target"
},
"cpu": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Cpu"
},
"gpu": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Gpu"
},
"memory": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Memory"
},
"disk": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Disk"
},
"labels": {
"additionalProperties": true,
"title": "Labels",
"type": "object"
},
"public": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Public"
},
"error_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error Reason"
},
"auto_stop_interval": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Auto Stop Interval"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created At"
},
"updated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated At"
}
},
"title": "SandboxSummary",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"sandbox": {
"anyOf": [
{
"$ref": "#/$defs/SandboxSummary"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"success"
],
"title": "StopSandboxOutput",
"type": "object"
}
delete_sandbox — Delete a Daytona sandbox.
delete_sandbox — Delete a Daytona sandbox.
Parameters
ID or name of the sandbox
Response
{
"$defs": {
"SandboxSummary": {
"additionalProperties": false,
"description": "Normalized summary of a Daytona sandbox.",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "State"
},
"snapshot": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Snapshot"
},
"target": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Target"
},
"cpu": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Cpu"
},
"gpu": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Gpu"
},
"memory": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Memory"
},
"disk": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Disk"
},
"labels": {
"additionalProperties": true,
"title": "Labels",
"type": "object"
},
"public": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Public"
},
"error_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error Reason"
},
"auto_stop_interval": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Auto Stop Interval"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created At"
},
"updated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated At"
}
},
"title": "SandboxSummary",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"sandbox": {
"anyOf": [
{
"$ref": "#/$defs/SandboxSummary"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"success"
],
"title": "DeleteSandboxOutput",
"type": "object"
}
Limits & Quotas
- Downloads: capped at 100MB; larger files return
success=Falsewith an error. Content is returned base64-encoded inline incontent_base64. - Uploads: provide file bytes via the
file_content_base64parameter. - Sandbox IDs:
get_sandbox,start_sandbox,stop_sandbox, anddelete_sandboxaccept either the sandbox ID or its name; all other sandbox-scoped operations require the ID. - Error model: non-2xx responses and timeouts are caught and
returned as
success=False+errorrather than raising.