Mandala
Tools

Daytona

Run code and commands in secure cloud sandboxes

Usage Instructions

Integrate Daytona into your workflow to run AI-generated code in secure, isolated sandboxes. Create and manage sandboxes, execute shell commands, run Python, JavaScript, or TypeScript code, transfer files, and clone Git repositories.

Tools

daytona_create_sandbox

Create a new Daytona sandbox for running AI-generated code in isolation

Input

ParameterTypeRequiredDescription
apiKeystringYesDaytona API key
snapshotstringNoID or name of the snapshot to create the sandbox from (uses default if empty)
namestringNoName for the sandbox (defaults to the sandbox ID)
targetstringNoRegion where the sandbox will be created (e.g., us, eu)
userstringNoUser associated with the sandbox
envjsonNoEnvironment variables to set in the sandbox as key-value pairs
labelsjsonNoLabels to attach to the sandbox as key-value pairs
cpunumberNoCPU cores to allocate to the sandbox
memorynumberNoMemory to allocate to the sandbox in GB
disknumberNoDisk space to allocate to the sandbox in GB
autoStopIntervalnumberNoAuto-stop interval in minutes (0 disables auto-stop)
autoArchiveIntervalnumberNoAuto-archive interval in minutes (0 uses the maximum interval)
autoDeleteIntervalnumberNoAuto-delete interval in minutes (negative disables, 0 deletes immediately on stop)
publicbooleanNoWhether the sandbox HTTP preview is publicly accessible

Output

ParameterTypeDescription
sandboxjsonThe created sandbox

daytona_list_sandboxes

List Daytona sandboxes in the organization

Input

ParameterTypeRequiredDescription
apiKeystringYesDaytona API key
limitnumberNoMaximum number of sandboxes to return (1-200)
namestringNoFilter sandboxes by name prefix (case-insensitive)
labelsjsonNoFilter sandboxes by labels as key-value pairs
cursorstringNoPagination cursor from a previous response

Output

ParameterTypeDescription
sandboxesarraySandboxes in the organization
nextCursorstringCursor for the next page of results

daytona_get_sandbox

Get details of a Daytona sandbox

Input

ParameterTypeRequiredDescription
apiKeystringYesDaytona API key
sandboxIdstringYesID or name of the sandbox

Output

ParameterTypeDescription
sandboxjsonThe sandbox details

daytona_start_sandbox

Start a stopped Daytona sandbox

Input

ParameterTypeRequiredDescription
apiKeystringYesDaytona API key
sandboxIdstringYesID or name of the sandbox

Output

ParameterTypeDescription
sandboxjsonThe started sandbox

daytona_stop_sandbox

Stop a running Daytona sandbox

Input

ParameterTypeRequiredDescription
apiKeystringYesDaytona API key
sandboxIdstringYesID or name of the sandbox

Output

ParameterTypeDescription
sandboxjsonThe stopped sandbox

daytona_delete_sandbox

Delete a Daytona sandbox

Input

ParameterTypeRequiredDescription
apiKeystringYesDaytona API key
sandboxIdstringYesID or name of the sandbox

Output

ParameterTypeDescription
sandboxjsonThe deleted sandbox

daytona_execute_command

Execute a shell command inside a Daytona sandbox

Input

ParameterTypeRequiredDescription
apiKeystringYesDaytona API key
sandboxIdstringYesID of the sandbox to execute the command in
commandstringYesShell command to execute
cwdstringNoWorking directory for the command (defaults to the sandbox working directory)
envjsonNoEnvironment variables to set for the command as key-value pairs
timeoutnumberNoTimeout in seconds (defaults to 10 seconds)

Output

ParameterTypeDescription
exitCodenumberExit code of the command (-1 if missing from the response)
resultstringCombined stdout/stderr output of the command

daytona_run_code

Run Python, JavaScript, or TypeScript code inside a Daytona sandbox

Input

ParameterTypeRequiredDescription
apiKeystringYesDaytona API key
sandboxIdstringYesID of the sandbox to run the code in
codestringYesCode to run
languagestringYesLanguage of the code: python, javascript, or typescript
envjsonNoEnvironment variables to set for the run as key-value pairs
timeoutnumberNoTimeout in seconds (defaults to 10 seconds)

Output

ParameterTypeDescription
exitCodenumberExit code of the code run (-1 if missing from the response)
resultstringCombined stdout/stderr output of the code run
artifactsjsonArtifacts produced by the run (e.g., matplotlib charts)

daytona_upload_file

Upload a file to a Daytona sandbox

Input

ParameterTypeRequiredDescription
apiKeystringYesDaytona API key
sandboxIdstringYesID of the sandbox to upload the file to
destinationPathstringYesDestination path in the sandbox (a trailing slash uploads into that directory using the file name)
filefileNoThe file to upload
fileNamestringNoOptional file name override

Output

ParameterTypeDescription
uploadedPathstringPath of the uploaded file in the sandbox
namestringName of the uploaded file
sizenumberSize of the uploaded file in bytes

daytona_download_file

Download a file from a Daytona sandbox

Input

ParameterTypeRequiredDescription
apiKeystringYesDaytona API key
sandboxIdstringYesID of the sandbox to download the file from
filePathstringYesPath of the file in the sandbox

Output

ParameterTypeDescription
filefileDownloaded file stored in execution files
namestringName of the downloaded file
mimeTypestringMIME type of the downloaded file
sizenumberSize of the downloaded file in bytes

daytona_list_files

List files in a directory of a Daytona sandbox

Input

ParameterTypeRequiredDescription
apiKeystringYesDaytona API key
sandboxIdstringYesID of the sandbox to list files in
pathstringNoDirectory path to list (defaults to the sandbox working directory)

Output

ParameterTypeDescription
filesarrayFiles and directories at the given path

daytona_git_clone

Clone a Git repository into a Daytona sandbox

Input

ParameterTypeRequiredDescription
apiKeystringYesDaytona API key
sandboxIdstringYesID of the sandbox to clone the repository into
urlstringYesURL of the Git repository to clone
pathstringYesPath in the sandbox to clone the repository into
branchstringNoBranch to clone (defaults to the default branch)
commitIdstringNoSpecific commit to check out after cloning
usernamestringNoUsername for authenticating to private repositories
passwordstringNoPassword or personal access token for private repositories

Output

ParameterTypeDescription
repoUrlstringURL of the cloned repository
clonePathstringPath the repository was cloned into

Notes

  • Category: tools
  • Type: daytona
Daytona