> ## Documentation Index
> Fetch the complete documentation index at: https://docs.modulex.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Daytona Integration for AI Agents & Workflows

> Run AI-generated code in secure, isolated cloud sandboxes. Create and manage sandboxes, execute shell commands, run Python, JavaScript, or TypeScript code, transfer files, and clone Git repositories.

{/* Self-hosted logo — build-time vendored from modulex.json / Iconify (see scripts/lib/logo.js). */}

<img src="https://mintcdn.com/modulexaillc/df8MOr-hXotYLTh5/logos/placeholder.svg?fit=max&auto=format&n=df8MOr-hXotYLTh5&q=85&s=a4046f9cd6d738c81259050e9833913c" alt="Daytona logo" width="72" height="72" data-path="logos/placeholder.svg" />

## 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.

<Info>
  **Categories**: Developer Tools & Infrastructure · Cloud · Automation · **Auth**: API Key · **Actions**: 12
</Info>

## Authentication

### API Key Authentication

Authenticate using your Daytona API key

<Steps>
  <Step title="Step 1">
    Go to [https://app.daytona.io](https://app.daytona.io) and sign up or log in
  </Step>

  <Step title="Step 2">
    Open the dashboard and navigate to the 'Keys' (API Keys) section
  </Step>

  <Step title="Step 3">
    Create a new API key and copy it
  </Step>

  <Step title="Step 4">
    Paste the API key below
  </Step>
</Steps>

#### Required Credentials

| Field           | Description                              | Required | Format |
| --------------- | ---------------------------------------- | -------- | ------ |
| Daytona API Key | Your Daytona API key from app.daytona.io | Yes      | `-`    |

## Available Actions

<AccordionGroup>
  <Accordion title="create_sandbox — Create a new Daytona sandbox for running AI-generated code in isolation.">
    ### Parameters

    <ResponseField name="snapshot" type="string">
      ID or name of the snapshot to create the sandbox from (uses default if empty)
    </ResponseField>

    <ResponseField name="name" type="string">
      Name for the sandbox (defaults to the sandbox ID)
    </ResponseField>

    <ResponseField name="target" type="string">
      Region where the sandbox will be created (e.g., us, eu)
    </ResponseField>

    <ResponseField name="user" type="string">
      User associated with the sandbox
    </ResponseField>

    <ResponseField name="env" type="object">
      Environment variables to set in the sandbox as key-value pairs
    </ResponseField>

    <ResponseField name="labels" type="object">
      Labels to attach to the sandbox as key-value pairs
    </ResponseField>

    <ResponseField name="cpu" type="integer">
      CPU cores to allocate to the sandbox
    </ResponseField>

    <ResponseField name="memory" type="integer">
      Memory to allocate to the sandbox in GB
    </ResponseField>

    <ResponseField name="disk" type="integer">
      Disk space to allocate to the sandbox in GB
    </ResponseField>

    <ResponseField name="auto_stop_interval" type="integer">
      Auto-stop interval in minutes (0 disables auto-stop)
    </ResponseField>

    <ResponseField name="auto_archive_interval" type="integer">
      Auto-archive interval in minutes (0 uses the maximum interval)
    </ResponseField>

    <ResponseField name="auto_delete_interval" type="integer">
      Auto-delete interval in minutes (negative disables, 0 deletes immediately on stop)
    </ResponseField>

    <ResponseField name="public" type="boolean">
      Whether the sandbox HTTP preview is publicly accessible
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$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"
    }
    ```
  </Accordion>

  <Accordion title="run_code — Run Python, JavaScript, or TypeScript code inside a Daytona sandbox.">
    ### Parameters

    <ResponseField name="sandbox_id" type="string" required>
      ID of the sandbox to run the code in
    </ResponseField>

    <ResponseField name="code" type="string" required>
      Code to run
    </ResponseField>

    <ResponseField name="language" type="string" required>
      Language of the code: python, javascript, or typescript
    </ResponseField>

    <ResponseField name="env" type="object">
      Environment variables to set for the run as key-value pairs
    </ResponseField>

    <ResponseField name="timeout" type="integer">
      Timeout in seconds (defaults to 10 seconds)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "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"
    }
    ```
  </Accordion>

  <Accordion title="execute_command — Execute a shell command inside a Daytona sandbox.">
    ### Parameters

    <ResponseField name="sandbox_id" type="string" required>
      ID of the sandbox to execute the command in
    </ResponseField>

    <ResponseField name="command" type="string" required>
      Shell command to execute
    </ResponseField>

    <ResponseField name="cwd" type="string">
      Working directory for the command (defaults to the sandbox working directory)
    </ResponseField>

    <ResponseField name="env" type="object">
      Environment variables to set for the command as key-value pairs
    </ResponseField>

    <ResponseField name="timeout" type="integer">
      Timeout in seconds (defaults to 10 seconds)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "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"
    }
    ```
  </Accordion>

  <Accordion title="upload_file — Upload a file to a Daytona sandbox.">
    ### Parameters

    <ResponseField name="sandbox_id" type="string" required>
      ID of the sandbox to upload the file to
    </ResponseField>

    <ResponseField name="destination_path" type="string" required>
      Destination path in the sandbox (a trailing slash uploads into that directory using the file name)
    </ResponseField>

    <ResponseField name="file_content_base64" type="string" required>
      Base64-encoded content of the file to upload
    </ResponseField>

    <ResponseField name="file_name" type="string">
      Optional file name override
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "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"
    }
    ```
  </Accordion>

  <Accordion title="download_file — Download a file from a Daytona sandbox (returned base64-encoded inline).">
    ### Parameters

    <ResponseField name="sandbox_id" type="string" required>
      ID of the sandbox to download the file from
    </ResponseField>

    <ResponseField name="file_path" type="string" required>
      Path of the file in the sandbox
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "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"
    }
    ```
  </Accordion>

  <Accordion title="list_files — List files in a directory of a Daytona sandbox.">
    ### Parameters

    <ResponseField name="sandbox_id" type="string" required>
      ID of the sandbox to list files in
    </ResponseField>

    <ResponseField name="path" type="string">
      Directory path to list (defaults to the sandbox working directory)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$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"
    }
    ```
  </Accordion>

  <Accordion title="git_clone — Clone a Git repository into a Daytona sandbox.">
    ### Parameters

    <ResponseField name="sandbox_id" type="string" required>
      ID of the sandbox to clone the repository into
    </ResponseField>

    <ResponseField name="url" type="string" required>
      URL of the Git repository to clone
    </ResponseField>

    <ResponseField name="path" type="string" required>
      Path in the sandbox to clone the repository into
    </ResponseField>

    <ResponseField name="branch" type="string">
      Branch to clone (defaults to the default branch)
    </ResponseField>

    <ResponseField name="commit_id" type="string">
      Specific commit to check out after cloning
    </ResponseField>

    <ResponseField name="username" type="string">
      Username for authenticating to private repositories
    </ResponseField>

    <ResponseField name="password" type="string">
      Password or personal access token for private repositories
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "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"
    }
    ```
  </Accordion>

  <Accordion title="list_sandboxes — List Daytona sandboxes in the organization.">
    ### Parameters

    <ResponseField name="limit" type="integer">
      Maximum number of sandboxes to return (1-200)
    </ResponseField>

    <ResponseField name="name" type="string">
      Filter sandboxes by name prefix (case-insensitive)
    </ResponseField>

    <ResponseField name="labels" type="object">
      Filter sandboxes by labels as key-value pairs
    </ResponseField>

    <ResponseField name="cursor" type="string">
      Pagination cursor from a previous response
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$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"
    }
    ```
  </Accordion>

  <Accordion title="get_sandbox — Get details of a Daytona sandbox.">
    ### Parameters

    <ResponseField name="sandbox_id" type="string" required>
      ID or name of the sandbox
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$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"
    }
    ```
  </Accordion>

  <Accordion title="start_sandbox — Start a stopped Daytona sandbox.">
    ### Parameters

    <ResponseField name="sandbox_id" type="string" required>
      ID or name of the sandbox
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$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"
    }
    ```
  </Accordion>

  <Accordion title="stop_sandbox — Stop a running Daytona sandbox.">
    ### Parameters

    <ResponseField name="sandbox_id" type="string" required>
      ID or name of the sandbox
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$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"
    }
    ```
  </Accordion>

  <Accordion title="delete_sandbox — Delete a Daytona sandbox.">
    ### Parameters

    <ResponseField name="sandbox_id" type="string" required>
      ID or name of the sandbox
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$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"
    }
    ```
  </Accordion>
</AccordionGroup>

## Limits & Quotas

* **Downloads**: capped at 100MB; larger files return
  `success=False` with an error. Content is returned base64-encoded
  inline in `content_base64`.
* **Uploads**: provide file bytes via the `file_content_base64`
  parameter.
* **Sandbox IDs**: `get_sandbox`, `start_sandbox`, `stop_sandbox`, and
  `delete_sandbox` accept 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` + `error` rather than raising.

## Related integrations

<CardGroup cols={3}>
  <Card title="Apify" href="/integrations/tools/apify" />

  <Card title="Browserbase" href="/integrations/tools/browserbase" />

  <Card title="Railway" href="/integrations/tools/railway" />
</CardGroup>

## Links

* [Daytona](https://www.daytona.io)