The Daytona connector lets your AI agent act in each user's Daytona account. Each user connects their own Daytona access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 100 tools.
- Tools
- 100
- What they doRead · write · destructive
- 42 · 49 · 942 read49 write9 destructive
- Users sign in with
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Daytona connection
In AgentKit > Connections, create a Daytona connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'daytona'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Daytona:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'daytona_get_current_api_key',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "daytona"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Daytona:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="daytona_get_current_api_key",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Daytona credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_tooldaytona_check_port_in_useCheck whether a specific port is in use inside a started Daytona sandbox.Read-onlyCheck Port in Use
Check whether a specific port is in use inside a started Daytona sandbox. Returns isInUse as true or false. Use daytona_check_port_in_use to confirm a server has started. Use daytona_list_ports to see all open ports.
Inputs
portintegerrequired- Port number to check, between 3000 and 9999. Example: 3000
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
daytona_download_fileRead the contents of a file inside a started Daytona sandbox.Read-onlyDownload File
Read the contents of a file inside a started Daytona sandbox. Returns the file contents; text files come back as a string. Use daytona_download_file to read source files, logs or outputs. Use daytona_get_file_info for metadata only. Binary files are not decoded.
Inputs
pathstringrequired- Path of the file to read. Example: /home/daytona/workspace/main.py
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
daytona_find_in_filesSearch the contents of files under a directory inside a started Daytona sandbox for a text pattern (like grep).Read-onlyFind in Files
Search the contents of files under a directory inside a started Daytona sandbox for a text pattern (like grep). Returns matches with file, line number and the matching line content. Use daytona_find_in_files to locate code or text. Use daytona_search_files to match file names, and daytona_replace_in_files to change matches.
Inputs
pathstringrequired- Directory to search in. Example: /home/daytona/workspace
patternstringrequired- Text pattern to search for. Example: TODO
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
daytona_get_current_api_keyGet details of the Daytona API key used for this connection.Read-onlyGet Current API Key
Get details of the Daytona API key used for this connection. Returns the key's name, masked value, permissions, createdAt and expiresAt. Use daytona_get_current_api_key to check which permissions the connected key has when a call returns 403.
Inputs
This tool takes no inputs.
daytona_get_file_infoGet metadata for one file or folder inside a started Daytona sandbox.Read-onlyGet File Info
Get metadata for one file or folder inside a started Daytona sandbox. Returns name, path, isDir, size, mode, permissions, owner, group and modifiedAt. Use daytona_get_file_info to check that a path exists or read its size and permissions. Use daytona_download_file for the contents.
Inputs
pathstringrequired- Path of the file or folder. Example: /home/daytona/workspace/main.py
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
daytona_get_organizationGet the details and per-sandbox limits of a Daytona organization.Read-onlyGet Organization
Get the details and per-sandbox limits of a Daytona organization. Returns the organization's id, name, suspension status, defaultRegionId and limits such as maxCpuPerSandbox, maxMemoryPerSandbox and maxDiskPerSandbox. Use daytona_get_organization to read limits before sizing sandboxes. Use daytona_get_organization_usage for current quota usage.
Inputs
organization_idstringrequired- ID of the Daytona organization. Every sandbox object carries it in its `organizationId` field (see daytona_get_sandbox). Example: 2c9a7a4e-1f0b-4d1e-8c3a-6f5e4d3c2b1a
daytona_get_organization_usageGet the current CPU, memory, disk and GPU usage of a Daytona organization against its quotas, per region and sandbox class.Read-onlyGet Organization Usage
Get the current CPU, memory, disk and GPU usage of a Daytona organization against its quotas, per region and sandbox class. Returns regionUsage entries with total quotas and current usage for CPU, memory, disk and GPU. Use daytona_get_organization_usage to check headroom before creating sandboxes. Use daytona_get_organization for per-sandbox limits. The API key needs the read:billing or write:sandboxes permission.
Inputs
organization_idstringrequired- ID of the Daytona organization. Every sandbox object carries it in its `organizationId` field (see daytona_get_sandbox). Example: 2c9a7a4e-1f0b-4d1e-8c3a-6f5e4d3c2b1a
daytona_get_port_preview_urlGet the HTTP preview URL for a port inside a Daytona sandbox, so a web app or API running there can be reached from a browser.Read-onlyGet Port Preview URL
Get the HTTP preview URL for a port inside a Daytona sandbox, so a web app or API running there can be reached from a browser. Returns the preview url, the sandboxId and an access token (send it as the x-daytona-preview-token header when the sandbox is private). Use daytona_get_port_preview_url for a standard preview link. Use daytona_get_signed_preview_url for a self-contained link that expires.
Inputs
portintegerrequired- Port number inside the sandbox where your app or server is listening, between 3000 and 9999. Example: 3000
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
daytona_get_registryGet one Docker registry configured in Daytona by its ID.Read-onlyGet Registry
Get one Docker registry configured in Daytona by its ID. Returns the registry's id, name, url, username, project, registryType and timestamps. Use daytona_get_registry for one registry. Use daytona_list_registries to browse.
Inputs
registry_idstringrequired- ID of the Docker registry, from the `id` field returned by daytona_list_registries. Example: 123e4567-e89b-12d3-a456-426614174000
daytona_get_sandboxGet the full details of one Daytona sandbox by ID or name.Read-onlyGet Sandbox
Get the full details of one Daytona sandbox by ID or name. Returns the sandbox object: id, name, organizationId, state, desiredState, snapshot, cpu, memory, disk, env, labels, public flag, target region, toolboxProxyUrl, errorReason and lifecycle intervals. Use daytona_get_sandbox to check state (for example after create or start) or read settings. Use daytona_list_sandboxes to search across sandboxes.
Inputs
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
verboseboolean- Include verbose output in the response. Defaults to false.
daytona_get_sandbox_build_logs_urlGet the URL for the build logs of a Daytona sandbox that was built from a Dockerfile or image.Read-onlyGet Sandbox Build Logs URL
Get the URL for the build logs of a Daytona sandbox that was built from a Dockerfile or image. Returns an object with the logs url. Use daytona_get_sandbox_build_logs_url to debug a sandbox in build_failed or pending_build state. Use daytona_get_snapshot_build_logs_url for snapshot builds.
Inputs
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
daytona_get_sandbox_logsGet OpenTelemetry logs emitted by a Daytona sandbox within a time range, with optional severity and text filters.Read-onlyGet Sandbox Logs
Get OpenTelemetry logs emitted by a Daytona sandbox within a time range, with optional severity and text filters. Returns log entries (timestamp, body, severityText, serviceName, attributes, traceId) with total and page counts. Use daytona_get_sandbox_logs to inspect application logs. Use daytona_get_sandbox_traces for traces and daytona_get_sandbox_metrics for metrics.
Inputs
fromstringrequired- Start of the time range, ISO 8601. Example: 2024-01-01T00:00:00Z
sandbox_idstringrequired- ID of the sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
tostringrequired- End of the time range, ISO 8601. Example: 2024-01-01T01:00:00Z
limitinteger- Number of log entries per page. Defaults to 100. Example: 50
pageinteger- Page number, starting at 1. Defaults to 1.
searchstring- Only return logs whose body contains this text. Example: timeout
severitiesarray- Only return logs with these severity levels: DEBUG, INFO, WARN or ERROR. Example: ["ERROR", "WARN"]
daytona_get_sandbox_metricsGet OpenTelemetry metric series recorded for a Daytona sandbox within a time range.Read-onlyGet Sandbox Metrics
Get OpenTelemetry metric series recorded for a Daytona sandbox within a time range. Returns metric series, each with metricName and its timestamped dataPoints. Use daytona_get_sandbox_metrics for historical resource and app metrics. Use daytona_get_sandbox_resource_usage for the current CPU, memory and disk snapshot.
Inputs
fromstringrequired- Start of the time range, ISO 8601. Example: 2024-01-01T00:00:00Z
sandbox_idstringrequired- ID of the sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
tostringrequired- End of the time range, ISO 8601. Example: 2024-01-01T01:00:00Z
metric_namesarray- Only return these metric names. Example: ["system.cpu.utilization"]
daytona_get_sandbox_resource_usageGet the current CPU, memory and disk usage of a started Daytona sandbox.Read-onlyGet Sandbox Resource Usage
Get the current CPU, memory and disk usage of a started Daytona sandbox. Returns cpuCount, cpuUsedPct, memTotal, memUsed, memCache, diskTotal, diskUsed, diskFree (bytes) and a timestamp. Use daytona_get_sandbox_resource_usage for a live snapshot before resizing. Use daytona_get_sandbox_metrics for history.
Inputs
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
daytona_get_sandbox_tracesGet OpenTelemetry trace summaries recorded for a Daytona sandbox within a time range.Read-onlyGet Sandbox Traces
Get OpenTelemetry trace summaries recorded for a Daytona sandbox within a time range. Returns traces with traceId, rootSpanName, startTime, endTime, durationMs, spanCount and statusCode, plus total, page and totalPages. Use daytona_get_sandbox_traces to find slow or failing requests. Use daytona_get_sandbox_logs for log lines.
Inputs
fromstringrequired- Start of the time range, ISO 8601. Example: 2024-01-01T00:00:00Z
sandbox_idstringrequired- ID of the sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
tostringrequired- End of the time range, ISO 8601. Example: 2024-01-01T01:00:00Z
limitinteger- Number of traces per page. Defaults to 100. Example: 50
pageinteger- Page number, starting at 1. Defaults to 1.
daytona_get_secretGet the metadata of one Daytona secret by ID (the value is never returned).Read-onlyGet Secret
Get the metadata of one Daytona secret by ID (the value is never returned). Returns the secret's id, name, description, placeholder, allowed hosts and timestamps. Use daytona_get_secret to check a secret's allowed hosts. Use daytona_list_secrets to browse.
Inputs
secret_idstringrequired- ID of the secret, from the `id` field returned by daytona_list_secrets. Example: 123e4567-e89b-12d3-a456-426614174000
daytona_get_sessionGet one shell session inside a started Daytona sandbox, with the commands run in it.Read-onlyGet Session
Get one shell session inside a started Daytona sandbox, with the commands run in it. Returns the sessionId and its commands (id, command, exitCode). Use daytona_get_session to see a session's command history. Use daytona_get_session_command for one command.
Inputs
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
session_idstringrequired- ID of the shell session, as chosen in daytona_create_session. Example: build-session
daytona_get_session_commandGet the status of one command run in a shell session inside a started Daytona sandbox.Read-onlyGet Session Command
Get the status of one command run in a shell session inside a started Daytona sandbox. Returns the command id, command text and exitCode (empty while it is still running). Use daytona_get_session_command to check whether an async command has finished. Use daytona_get_session_command_logs for its output.
Inputs
command_idstringrequired- ID of the command, from the cmdId field returned by daytona_session_execute_command. Example: 0b2f7c9e-1a3d-4e5f-8a9b-7c6d5e4f3a2b
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
session_idstringrequired- ID of the shell session, as chosen in daytona_create_session. Example: build-session
daytona_get_session_command_logsGet the output logs of a command run in a shell session inside a started Daytona sandbox.Read-onlyGet Session Command Logs
Get the output logs of a command run in a shell session inside a started Daytona sandbox. Returns the command's output so far (stdout and stderr). Use daytona_get_session_command_logs to read output of async commands. Use daytona_get_session_command for the exit code.
Inputs
command_idstringrequired- ID of the command, from the cmdId field returned by daytona_session_execute_command. Example: 0b2f7c9e-1a3d-4e5f-8a9b-7c6d5e4f3a2b
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
session_idstringrequired- ID of the shell session, as chosen in daytona_create_session. Example: build-session
daytona_get_signed_preview_urlGet a signed, expiring preview URL for a port inside a Daytona sandbox; the token is embedded in the URL so no header is needed.Read-onlyGet Signed Preview URL
Get a signed, expiring preview URL for a port inside a Daytona sandbox; the token is embedded in the URL so no header is needed. Returns the signed url, port, sandboxId and token. Use daytona_get_signed_preview_url to share a link temporarily. Use daytona_get_port_preview_url for a standard link, and daytona_expire_signed_preview_url to revoke one early.
Inputs
portintegerrequired- Port number inside the sandbox where your app or server is listening, between 3000 and 9999. Example: 3000
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
expires_in_secondsinteger- How long the URL stays valid, in seconds. Defaults to 60. Example: 3600
daytona_get_snapshotGet one Daytona snapshot by its ID or name.Read-onlyGet Snapshot
Get one Daytona snapshot by its ID or name. Returns the snapshot's id, name, imageName, state, errorReason, size, entrypoint, cpu, gpu, memory, disk and timestamps. Use daytona_get_snapshot to check whether a snapshot is active before creating sandboxes from it. Use daytona_list_snapshots to browse.
Inputs
snapshot_id_or_namestringrequired- ID or name of the snapshot. Example: python-data-science
daytona_get_snapshot_build_logs_urlGet the URL for the build logs of a Daytona snapshot.Read-onlyGet Snapshot Build Logs URL
Get the URL for the build logs of a Daytona snapshot. Returns an object with the logs url. Use daytona_get_snapshot_build_logs_url to debug a snapshot stuck in building or in build_failed. Use daytona_get_sandbox_build_logs_url for sandbox builds.
Inputs
snapshot_idstringrequired- ID of the snapshot, from the `id` field returned by daytona_list_snapshots. Example: 7b1e2d3c-4a5b-6c7d-8e9f-0a1b2c3d4e5f
daytona_get_toolbox_proxy_urlGet the toolbox proxy base URL that serves process, file and Git operations for a Daytona sandbox.Read-onlyGet Toolbox Proxy URL
Get the toolbox proxy base URL that serves process, file and Git operations for a Daytona sandbox. Returns an object with the url, for example https://proxy.app.daytona.io/toolbox. Use daytona_get_toolbox_proxy_url to check which region proxy a sandbox uses; the toolbox tools in this connector call https://proxy.app.daytona.io/toolbox.
Inputs
sandbox_idstringrequired- ID of the sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
daytona_get_user_home_dirGet the home directory of the sandbox user in a started Daytona sandbox.Read-onlyGet User Home Directory
Get the home directory of the sandbox user in a started Daytona sandbox. Returns the dir path. Use daytona_get_user_home_dir to locate the user's home folder. Use daytona_get_work_dir for the default command directory.
Inputs
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
daytona_get_volumeGet one Daytona volume by its ID.Read-onlyGet Volume
Get one Daytona volume by its ID. Returns the volume's id, name, state, timestamps and errorReason. Use daytona_get_volume to check a volume is ready. Use daytona_get_volume_by_name when you only know the name.
Inputs
volume_idstringrequired- ID of the volume, from the `id` field returned by daytona_list_volumes. Example: 9d8c7b6a-5e4f-4a3b-2c1d-0e9f8a7b6c5d
daytona_get_volume_by_nameGet one Daytona volume by its name.Read-onlyGet Volume by Name
Get one Daytona volume by its name. Returns the volume's id, name, state, timestamps and errorReason. Use daytona_get_volume_by_name to resolve a name to an ID. Use daytona_get_volume when you already have the ID.
Inputs
namestringrequired- Name of the volume. Example: shared-datasets
daytona_get_work_dirGet the default working directory of a started Daytona sandbox.Read-onlyGet Working Directory
Get the default working directory of a started Daytona sandbox. Returns the dir path used for running commands. Use daytona_get_work_dir to build absolute paths for file and Git tools. Use daytona_get_user_home_dir for the home folder.
Inputs
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
daytona_git_historyGet the commit history of a Git repository inside a started Daytona sandbox.Read-onlyGit History
Get the commit history of a Git repository inside a started Daytona sandbox. Returns commits with hash, author, email, message and timestamp. Use daytona_git_history to review past commits. Use daytona_git_status for uncommitted changes.
Inputs
pathstringrequired- Path of the Git repository inside the sandbox, absolute or relative to the working directory. Example: workspace/my-repo
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
daytona_git_list_branchesList the branches of a Git repository inside a started Daytona sandbox.Read-onlyGit List Branches
List the branches of a Git repository inside a started Daytona sandbox. Returns a branches array and the current branch name. Use daytona_git_list_branches before switching with daytona_git_checkout. Use daytona_git_status for the working-tree state.
Inputs
pathstringrequired- Path of the Git repository inside the sandbox, absolute or relative to the working directory. Example: workspace/my-repo
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
daytona_git_list_remotesList the remotes configured in a Git repository inside a started Daytona sandbox.Read-onlyGit List Remotes
List the remotes configured in a Git repository inside a started Daytona sandbox. Returns a remotes array with each remote's name and url. Use daytona_git_list_remotes to check where pushes go. Use daytona_git_add_remote to add one.
Inputs
pathstringrequired- Path of the Git repository inside the sandbox, absolute or relative to the working directory. Example: workspace/my-repo
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
daytona_git_statusGet the Git status of a repository inside a started Daytona sandbox.Read-onlyGit Status
Get the Git status of a repository inside a started Daytona sandbox. Returns currentBranch, upstream, ahead, behind, detached, branchPublished and fileStatus entries with each file's staging and worktree status. Use daytona_git_status before committing to see what changed. Use daytona_git_history for past commits.
Inputs
pathstringrequired- Path of the Git repository inside the sandbox, absolute or relative to the working directory. Example: workspace/my-repo
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
daytona_list_available_sandbox_classesList the sandbox classes (container, linux-vm, windows) and GPU types the Daytona organization can use in each region.Read-onlyList Available Sandbox Classes
List the sandbox classes (container, linux-vm, windows) and GPU types the Daytona organization can use in each region. Returns entries with regionId, sandboxClass, gpuAvailable and allowedGpuTypes. Use daytona_list_available_sandbox_classes before creating GPU or VM sandboxes. Use daytona_list_regions for region details.
Inputs
organization_idstringrequired- ID of the Daytona organization. Every sandbox object carries it in its `organizationId` field (see daytona_get_sandbox). Example: 2c9a7a4e-1f0b-4d1e-8c3a-6f5e4d3c2b1a
daytona_list_filesList files and folders at a path inside a started Daytona sandbox, optionally recursing several levels.Read-onlyList Files
List files and folders at a path inside a started Daytona sandbox, optionally recursing several levels. Returns entries with name, path, isDir, size, mode, permissions, owner, group and modifiedAt. Use daytona_list_files to explore a directory. Use daytona_search_files to match file names by pattern and daytona_find_in_files to search file contents.
Inputs
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
depthinteger- How many levels deep to list: 1 lists the directory's entries, 2 also includes their children, and so on. Defaults to 1.
pathstring- Directory to list. Defaults to the sandbox working directory. Example: /home/daytona/workspace
daytona_list_portsList the ports that processes are listening on inside a started Daytona sandbox.Read-onlyList Ports
List the ports that processes are listening on inside a started Daytona sandbox. Returns a ports array of port numbers. Use daytona_list_ports to find a running app's port before calling daytona_get_port_preview_url. Use daytona_check_port_in_use for one port.
Inputs
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
daytona_list_regionsList the regions available to the Daytona organization for creating sandboxes.Read-onlyList Regions
List the regions available to the Daytona organization for creating sandboxes. Returns regions with id, name, regionType (shared, dedicated or custom), proxyUrl and timestamps. Use daytona_list_regions to choose a target for daytona_create_sandbox. Use daytona_list_available_sandbox_classes for what each region supports.
Inputs
This tool takes no inputs.
daytona_list_registriesList the Docker registries configured in the Daytona organization.Read-onlyList Registries
List the Docker registries configured in the Daytona organization. Returns registries with id, name, url, username, project, registryType and timestamps. Use daytona_list_registries to see which private registries snapshots can pull from. Use daytona_get_registry for one registry.
Inputs
This tool takes no inputs.
daytona_list_sandboxesList sandboxes in the Daytona organization, with filters for name, labels, state, snapshot, region, resources and dates.Read-onlyList Sandboxes
List sandboxes in the Daytona organization, with filters for name, labels, state, snapshot, region, resources and dates. Returns a page of sandbox summaries (id, name, state, desiredState, snapshot, cpu, memory, disk, labels, target region, createdAt) plus nextCursor. Use daytona_list_sandboxes to browse or find a sandbox ID. Use daytona_get_sandbox for full details of one sandbox.
Inputs
created_at_afterstring- Only include sandboxes created after this ISO 8601 timestamp. Example: 2024-01-01T00:00:00Z
created_at_beforestring- Only include sandboxes created before this ISO 8601 timestamp. Example: 2024-12-31T23:59:59Z
cursorstring- Pagination cursor. Pass the nextCursor value from the previous response to get the next page.
idstring- Filter by sandbox ID prefix (case-insensitive). Example: 3f2b8c1e
include_errored_deletedboolean- Also return sandboxes in an error state whose desired state is deleted. Defaults to false.
is_publicboolean- Filter by whether the sandbox's HTTP preview is public (true) or private (false).
labelsobject- Only return sandboxes that carry all of these labels, as a JSON object of key-value pairs. Example: {"team": "backend"}
limitinteger- Number of sandboxes per page. Defaults to 100. Example: 20
namestring- Filter by sandbox name prefix (case-insensitive). Example: agent-
orderstring- Sort direction: asc or desc.one of
ascdesc region_idsarray- Only return sandboxes in these region IDs (for Daytona Cloud, us or eu). Example: ["us"]
snapshotsarray- Only return sandboxes created from these snapshot names. Example: ["daytonaio/sandbox:0.4.3"]
sortstring- Field to sort by: name, cpu, memoryGib, diskGib, lastActivityAt or createdAt.one of
namecpumemoryGibdiskGiblastActivityAtcreatedAt statesarray- Only return sandboxes in these states, such as started, stopped, archived, paused or error. Example: ["started", "stopped"]
daytona_list_secretsList the organization secrets stored in Daytona (values are never returned).Read-onlyList Secrets
List the organization secrets stored in Daytona (values are never returned). Returns a page of secrets with id, name, description, placeholder, allowed hosts and timestamps, plus a cursor for the next page. Use daytona_list_secrets to find secret names to mount with daytona_create_sandbox or daytona_update_sandbox_secrets. Use daytona_get_secret for one secret.
Inputs
cursorstring- Pagination cursor from the previous response. Leave empty for the first page.
limitinteger- Number of secrets per page. Defaults to 100. Example: 20
namestring- Filter by partial secret name. Example: OPENAI
orderstring- Sort direction: asc or desc. Defaults to desc.one of
ascdesc sortstring- Field to sort by: name, createdAt or updatedAt. Defaults to createdAt.one of
namecreatedAtupdatedAt
daytona_list_sessionsList the active shell sessions inside a started Daytona sandbox.Read-onlyList Sessions
List the active shell sessions inside a started Daytona sandbox. Returns sessions with sessionId and the commands run in each (id, command, exitCode). Use daytona_list_sessions to find existing sessions. Use daytona_get_session for one session.
Inputs
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
daytona_list_snapshotsList snapshots (sandbox templates) available to the Daytona organization, with optional name filter and sorting.Read-onlyList Snapshots
List snapshots (sandbox templates) available to the Daytona organization, with optional name filter and sorting. Returns a page of snapshots with id, name, imageName, state, size, cpu, gpu, memory, disk, general flag and timestamps, plus total, page and totalPages. Use daytona_list_snapshots to pick a snapshot for daytona_create_sandbox. Use daytona_get_snapshot for one snapshot by ID or name.
Inputs
limitinteger- Number of snapshots per page. Defaults to 100. Example: 20
namestring- Filter by partial snapshot name. Example: python
orderstring- Sort direction: asc or desc. Defaults to desc.one of
ascdesc pageinteger- Page number, starting at 1. Defaults to 1.
sortstring- Field to sort by: name, state, lastUsedAt or createdAt. Defaults to lastUsedAt.one of
namestatelastUsedAtcreatedAt source_sandbox_idstring- Only return snapshots created from this sandbox ID. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
daytona_list_volumesList the persistent volumes in the Daytona organization.Read-onlyList Volumes
List the persistent volumes in the Daytona organization. Returns volumes with id, name, state, createdAt, updatedAt, lastUsedAt and errorReason. Use daytona_list_volumes to find a volume to mount in daytona_create_sandbox. Use daytona_get_volume_by_name when you know the name.
Inputs
include_deletedboolean- Also return deleted volumes. Defaults to false.
daytona_search_filesFind files whose names match a glob pattern under a directory inside a started Daytona sandbox.Read-onlySearch Files
Find files whose names match a glob pattern under a directory inside a started Daytona sandbox. Returns a files array of matching paths. Use daytona_search_files to find files by name or extension. Use daytona_find_in_files to search inside files.
Inputs
pathstringrequired- Directory to search in. Example: /home/daytona/workspace
patternstringrequired- File name pattern to match. Example: *.py
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
daytona_activate_snapshotActivate an inactive Daytona snapshot so it can be used to create sandboxes again.WriteActivate Snapshot
Activate an inactive Daytona snapshot so it can be used to create sandboxes again. Returns the snapshot object with its updated state. Use daytona_activate_snapshot to restore a snapshot turned off by daytona_deactivate_snapshot.
Inputs
snapshot_idstringrequired- ID of the snapshot, from the `id` field returned by daytona_list_snapshots. Example: 7b1e2d3c-4a5b-6c7d-8e9f-0a1b2c3d4e5f
daytona_archive_sandboxArchive a stopped Daytona sandbox, moving its filesystem to cheaper object storage.WriteArchive Sandbox
Archive a stopped Daytona sandbox, moving its filesystem to cheaper object storage. Returns the updated sandbox object with its id, name, state, resources (cpu, memory, disk), labels and auto-stop/archive/delete settings. Use daytona_archive_sandbox for sandboxes you want to keep but not use soon. Use daytona_stop_sandbox for a short pause, and daytona_start_sandbox to restore an archived one. The sandbox must be stopped first (daytona_stop_sandbox).
Inputs
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
daytona_create_folderCreate a folder inside a started Daytona sandbox with the given permissions.WriteCreate Folder
Create a folder inside a started Daytona sandbox with the given permissions. Returns an empty response on success. Use daytona_create_folder to prepare a directory. Use daytona_execute_command with mkdir -p for nested folders in one call.
Inputs
pathstringrequired- Path of the folder to create. Example: /home/daytona/workspace/output
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
modestring- Octal permission mode for the folder. Defaults to 0755. Example: 0755default
0755
daytona_create_registryAdd a private Docker registry with its credentials so Daytona snapshots can pull images from it.WriteCreate Registry
Add a private Docker registry with its credentials so Daytona snapshots can pull images from it. Returns the new registry with id, name, url, username, project and registryType. Use daytona_create_registry before creating snapshots from private images with daytona_create_snapshot.
Inputs
namestringrequired- Display name for the registry. Example: My Docker Hub
passwordstringrequired- Password or access token for the registry.
urlstringrequired- Registry URL. Example: https://registry.hub.docker.com
usernamestringrequired- Username for the registry. Example: my-docker-user
projectstring- Registry project or namespace, if the registry uses one. Example: my-project
daytona_create_sandboxCreate a new Daytona sandbox from a snapshot (or the default image) with optional resources, environment variables, labels, volumes and lifecycle intervals.WriteCreate Sandbox
Create a new Daytona sandbox from a snapshot (or the default image) with optional resources, environment variables, labels, volumes and lifecycle intervals. Returns the new sandbox object, including its id, name, state, target region, resources and toolboxProxyUrl. Use daytona_create_sandbox to provision a fresh environment. Use daytona_fork_sandbox to copy an existing sandbox, and daytona_start_sandbox to resume a stopped one. The sandbox starts in the creating state; poll daytona_get_sandbox until state is started before using the toolbox tools.
Inputs
auto_archive_intervalinteger- Minutes a stopped sandbox waits before being archived; 0 uses the maximum interval. Example: 10080
auto_delete_intervalinteger- Minutes a stopped sandbox waits before being deleted; a negative value disables auto-delete and 0 deletes it as soon as it stops. Example: -1
auto_stop_intervalinteger- Minutes of inactivity before the sandbox stops automatically; 0 disables auto-stop. Defaults to 15. Example: 30
build_infoobject- Build the sandbox from a Dockerfile instead of a snapshot. Provide the Dockerfile text as dockerfileContent. Example: {"dockerfileContent": "FROM python:3.12-slim\nRUN pip install requests"}
cpuinteger- vCPU cores to allocate. Defaults to 1; the default organization limit is 4. Example: 2
diskinteger- Disk space in GB to allocate. Defaults to 3; the default organization limit is 10. Example: 10
domain_allow_liststring- Comma-separated domains the sandbox may reach. Example: example.com,*.github.com
envobject- Environment variables for the sandbox, as a JSON object of name-value pairs. Example: {"NODE_ENV": "production"}
gpuinteger- GPU units to allocate, for GPU-enabled organizations. Example: 1
gpu_typearray- Preferred GPU types in order of preference, used with gpu. Allowed values: H100, H200, B300, RTX-PRO-6000, RTX-4090, RTX-5090, MI355X. Example: ["H100"]
labelsobject- Labels to attach to the sandbox, as a JSON object of key-value pairs. Useful for filtering in daytona_list_sandboxes. Example: {"team": "backend"}
memoryinteger- Memory in GB to allocate. Defaults to 1; the default organization limit is 8. Example: 4
namestring- Unique name for the sandbox. If omitted, the sandbox ID is used as its name. Example: my-agent-sandbox
network_allow_liststring- Comma-separated CIDR ranges the sandbox may reach. Example: 192.168.1.0/16,10.0.0.0/24
network_block_allboolean- Block all outbound network access from the sandbox. Defaults to false.
publicboolean- Whether the sandbox's HTTP preview URLs are publicly accessible without a token. Defaults to false.
secretsarray- Organization secrets to mount as environment variables. Each entry maps an env var name to a secret name. Example: [{"OPENAI_API_KEY": "openai-prod"}]
snapshotstring- ID or name of the snapshot to create the sandbox from. Omit to use the organization default. Example: daytonaio/sandbox:0.4.3
targetstring- Region to create the sandbox in, for example us or eu. Defaults to the organization default region. Toolbox tools in this connector reach US-region sandboxes only.
ttl_minutesinteger- Maximum lifetime in minutes from creation, regardless of state; 0 disables it. When it elapses the sandbox is destroyed. Example: 1440
userstring- Linux user that runs processes inside the sandbox. Example: daytona
volumesarray- Volumes to mount. Each entry needs the volume ID or name and the mount path inside the sandbox, and can limit the mount to a sub-folder. Example: [{"volumeId": "my-volume", "mountPath": "/data"}]
daytona_create_sandbox_snapshotCapture an existing Daytona sandbox as a new reusable snapshot.WriteCreate Sandbox Snapshot
Capture an existing Daytona sandbox as a new reusable snapshot. Returns the updated sandbox object with its id, name, state, resources (cpu, memory, disk), labels and auto-stop/archive/delete settings. Use daytona_create_sandbox_snapshot to save a configured environment as a template. Use daytona_create_snapshot to build one from an image, and daytona_fork_sandbox to copy a sandbox directly. Container sandboxes can be captured while running; VM sandboxes must be stopped unless include_memory is true.
Inputs
namestringrequired- Name for the new snapshot. Example: my-dev-env-v1
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
include_memoryboolean- Also capture the VM's memory (VM sandboxes only; the sandbox must then be started). Defaults to false.
daytona_create_secretStore a secret in the Daytona organization vault so sandboxes can use it without seeing the raw value.WriteCreate Secret
Store a secret in the Daytona organization vault so sandboxes can use it without seeing the raw value. Returns the secret's id, name, description, placeholder and allowed hosts (the value is not returned). Use daytona_create_secret before mounting it with daytona_create_sandbox or daytona_update_sandbox_secrets. Set hosts so the secret is only sent to the services that need it.
Inputs
namestringrequired- Secret name using letters, numbers, hyphens and underscores. Example: OPENAI_API_KEY
valuestringrequired- The secret value to store.
descriptionstring- Optional description of what the secret is for. Example: OpenAI key for agents
hostsarray- Hosts this secret may be sent to from a sandbox. A secret with no hosts is substituted into requests to any host, so set this. Example: ["api.openai.com"]
daytona_create_sessionCreate a persistent shell session inside a started Daytona sandbox, which keeps working directory and environment between commands.WriteCreate Session
Create a persistent shell session inside a started Daytona sandbox, which keeps working directory and environment between commands. Returns an empty response on success. Use daytona_create_session before daytona_session_execute_command for multi-step or long-running work. Use daytona_execute_command for one-off commands.
Inputs
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
session_idstringrequired- ID to give the new session; you choose it. Example: build-session
daytona_create_snapshotCreate a reusable Daytona snapshot from a container image or a Dockerfile, with default resources for sandboxes created from it.WriteCreate Snapshot
Create a reusable Daytona snapshot from a container image or a Dockerfile, with default resources for sandboxes created from it. Returns the new snapshot with its id, name, state (it starts in a pending or building state), size and resources. Use daytona_create_snapshot to define a template from an image. Use daytona_create_sandbox_snapshot to capture an existing sandbox instead. Wait until daytona_get_snapshot reports state active before using it in daytona_create_sandbox.
Inputs
namestringrequired- Unique name for the snapshot. Example: python-data-science
build_infoobject- Build the snapshot from a Dockerfile instead of an image. Provide the Dockerfile text as dockerfileContent. Example: {"dockerfileContent": "FROM python:3.12-slim\nRUN pip install pandas"}
cpuinteger- CPU cores for sandboxes created from this snapshot. Example: 2
diskinteger- Disk space in GB for sandboxes created from this snapshot. Example: 10
entrypointarray- Entrypoint command for the snapshot, as a list of arguments. Example: ["sleep", "infinity"]
gpuinteger- GPU units for sandboxes created from this snapshot. Example: 0
image_namestring- Container image to build the snapshot from, with a specific tag (the :latest tag is rejected). Required unless build_info is given. Example: python:3.12-slim
memoryinteger- Memory in GB for sandboxes created from this snapshot. Example: 4
region_idstring- Region where the snapshot is available. Defaults to the organization default region. Example: us
daytona_create_ssh_accessCreate a temporary SSH access token for a Daytona sandbox.WriteCreate SSH Access
Create a temporary SSH access token for a Daytona sandbox. Returns the SSH access id, token, expiresAt and a ready-to-run sshCommand. Use daytona_create_ssh_access to give a person terminal access. Use daytona_revoke_ssh_access to remove it early.
Inputs
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
expires_in_minutesinteger- How long the SSH access stays valid, in minutes. Defaults to 60. Example: 120
daytona_create_volumeCreate a persistent volume that can be mounted into Daytona sandboxes to share or keep data.WriteCreate Volume
Create a persistent volume that can be mounted into Daytona sandboxes to share or keep data. Returns the new volume with its id, name and state. Use daytona_create_volume before mounting storage with the volumes input of daytona_create_sandbox.
Inputs
namestringrequired- Name for the volume. Example: shared-datasets
daytona_deactivate_snapshotDeactivate a Daytona snapshot so it is no longer used for new sandboxes, without deleting it.WriteDeactivate Snapshot
Deactivate a Daytona snapshot so it is no longer used for new sandboxes, without deleting it. Returns an empty response on success. Use daytona_deactivate_snapshot to retire a template temporarily. Use daytona_activate_snapshot to bring it back, and daytona_delete_snapshot to remove it.
Inputs
snapshot_idstringrequired- ID of the snapshot, from the `id` field returned by daytona_list_snapshots. Example: 7b1e2d3c-4a5b-6c7d-8e9f-0a1b2c3d4e5f
daytona_execute_commandRun a shell command inside a started Daytona sandbox and wait for it to finish.WriteExecute Command
Run a shell command inside a started Daytona sandbox and wait for it to finish. Returns the command's combined output as result and its exitCode. Use daytona_execute_command for one-off commands that finish within the timeout. Use daytona_run_code to run a code snippet, and daytona_session_execute_command for long-running or stateful work. The sandbox must be started (daytona_start_sandbox).
Inputs
commandstringrequired- Shell command to run. Example: ls -la && python --version
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
cwdstring- Working directory for the command. Defaults to the sandbox working directory. Example: /home/daytona/workspace
envsobject- Extra environment variables for this command, as a JSON object. Example: {"DEBUG": "1"}
timeoutinteger- Maximum run time in seconds. Defaults to 10 seconds; raise it for slower commands. Example: 60
daytona_expire_signed_preview_urlExpire a signed preview URL for a Daytona sandbox port before its scheduled expiry.WriteExpire Signed Preview URL
Expire a signed preview URL for a Daytona sandbox port before its scheduled expiry. Returns an empty response on success. Use daytona_expire_signed_preview_url to revoke a link created by daytona_get_signed_preview_url.
Inputs
portintegerrequired- Port number inside the sandbox where your app or server is listening, between 3000 and 9999. Example: 3000
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
tokenstringrequired- Token of the signed preview URL to expire, from the token field of daytona_get_signed_preview_url. Example: jl6wb9z5o3eii
daytona_fork_sandboxFork a Daytona sandbox into a new sandbox that starts from a copy of its current filesystem.WriteFork Sandbox
Fork a Daytona sandbox into a new sandbox that starts from a copy of its current filesystem. Returns the new (forked) sandbox object with its own id and name. Use daytona_fork_sandbox to branch an environment for parallel experiments. Use daytona_create_sandbox_snapshot to keep a reusable template instead.
Inputs
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
namestring- Name for the forked sandbox. If omitted, a unique name is generated. Example: my-forked-sandbox
daytona_git_addStage files in a Git repository inside a started Daytona sandbox.WriteGit Add
Stage files in a Git repository inside a started Daytona sandbox. Returns an empty response on success. Use daytona_git_add before daytona_git_commit. Use daytona_git_restore to unstage files.
Inputs
filesarrayrequired- Files to stage, relative to the repository. Use ["."] to stage everything. Example: ["src/main.py", "README.md"]
pathstringrequired- Path of the Git repository inside the sandbox, absolute or relative to the working directory. Example: workspace/my-repo
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
daytona_git_add_remoteAdd or overwrite a remote in a Git repository inside a started Daytona sandbox.WriteGit Add Remote
Add or overwrite a remote in a Git repository inside a started Daytona sandbox. Returns an empty response on success. Use daytona_git_add_remote after daytona_git_init, then daytona_git_push. Use daytona_git_list_remotes to see existing remotes.
Inputs
namestringrequired- Remote name. Example: origin
pathstringrequired- Path of the Git repository inside the sandbox, absolute or relative to the working directory. Example: workspace/my-repo
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
urlstringrequired- Remote URL. Example: https://github.com/acme/app.git
fetchboolean- Fetch from the remote right after adding it. Defaults to false.
overwriteboolean- Replace an existing remote with the same name. Defaults to false.
daytona_git_checkoutSwitch a Git repository inside a started Daytona sandbox to another branch or commit.WriteGit Checkout
Switch a Git repository inside a started Daytona sandbox to another branch or commit. Returns an empty response on success. Use daytona_git_checkout to change branches. Use daytona_git_create_branch first for a new branch.
Inputs
branchstringrequired- Branch name or commit hash to check out. Example: main
pathstringrequired- Path of the Git repository inside the sandbox, absolute or relative to the working directory. Example: workspace/my-repo
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
daytona_git_cloneClone a Git repository into a folder inside a started Daytona sandbox, optionally at a branch or commit and with credentials.WriteGit Clone
Clone a Git repository into a folder inside a started Daytona sandbox, optionally at a branch or commit and with credentials. Returns an empty response on success. Use daytona_git_clone to bring code into a sandbox. Use daytona_git_init to start a new repository, and daytona_git_pull to update an existing clone.
Inputs
pathstringrequired- Destination folder inside the sandbox. Example: workspace/hello-world
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
urlstringrequired- Repository URL to clone. Example: https://github.com/octocat/Hello-World.git
branchstring- Branch to check out. Defaults to the remote's default branch. Example: main
commit_idstring- Specific commit to check out after cloning. Example: 7fd1a60b01f91b314f59955a4e4d4e80d8edf11d
depthinteger- Create a shallow clone with this many commits of history. Example: 1
passwordstring- Password or personal access token for an authenticated remote. Leave empty for public repositories.
usernamestring- Username for an authenticated remote. For GitHub, any non-empty value works with a token as the password. Example: git
daytona_git_commitCommit the staged changes in a Git repository inside a started Daytona sandbox.WriteGit Commit
Commit the staged changes in a Git repository inside a started Daytona sandbox. Returns the new commit hash. Use daytona_git_commit after daytona_git_add, then daytona_git_push to publish. Use daytona_git_status to review changes first.
Inputs
authorstringrequired- Author name for the commit. Example: Jane Doe
emailstringrequired- Author email for the commit. Example: jane@example.com
messagestringrequired- Commit message. Example: Fix off-by-one error in parser
pathstringrequired- Path of the Git repository inside the sandbox, absolute or relative to the working directory. Example: workspace/my-repo
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
allow_emptyboolean- Allow a commit with no changes. Defaults to false.
daytona_git_configure_userSet the Git user name and email inside a started Daytona sandbox, globally or for one repository.WriteGit Configure User
Set the Git user name and email inside a started Daytona sandbox, globally or for one repository. Returns an empty response on success. Use daytona_git_configure_user before committing with tools that rely on Git's configured identity. daytona_git_commit sets the author per commit.
Inputs
emailstringrequired- Git user email. Example: jane@example.com
namestringrequired- Git user name. Example: Jane Doe
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
pathstring- Repository path. Required when scope is local. Example: workspace/my-repo
scopestring- Where to set the identity: global (default), local or system.one of
globallocalsystem
daytona_git_create_branchCreate a new branch in a Git repository inside a started Daytona sandbox.WriteGit Create Branch
Create a new branch in a Git repository inside a started Daytona sandbox. Returns an empty response on success. Use daytona_git_create_branch, then daytona_git_checkout to switch to it.
Inputs
namestringrequired- Name of the new branch. Example: feature/login
pathstringrequired- Path of the Git repository inside the sandbox, absolute or relative to the working directory. Example: workspace/my-repo
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
daytona_git_initInitialize a new Git repository in a folder inside a started Daytona sandbox.WriteGit Init
Initialize a new Git repository in a folder inside a started Daytona sandbox. Returns an empty response on success. Use daytona_git_init to start version control for new code. Use daytona_git_clone to copy an existing repository, then daytona_git_add_remote to connect a remote.
Inputs
pathstringrequired- Path of the Git repository inside the sandbox, absolute or relative to the working directory. Example: workspace/my-repo
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
bareboolean- Create a bare repository without a working tree. Defaults to false.
initial_branchstring- Name of the initial branch. Example: main
daytona_git_pullPull changes from the remote into a Git repository inside a started Daytona sandbox.WriteGit Pull
Pull changes from the remote into a Git repository inside a started Daytona sandbox. Returns an empty response on success. Use daytona_git_pull to update an existing clone. Use daytona_git_clone for a new copy.
Inputs
pathstringrequired- Path of the Git repository inside the sandbox, absolute or relative to the working directory. Example: workspace/my-repo
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
branchstring- Branch to pull. Defaults to the current branch's upstream. Example: main
passwordstring- Password or personal access token for an authenticated remote. Leave empty for public repositories.
remotestring- Remote to pull from. Defaults to origin.
usernamestring- Username for an authenticated remote. For GitHub, any non-empty value works with a token as the password. Example: git
daytona_git_pushPush local commits from a Git repository inside a started Daytona sandbox to its remote.WriteGit Push
Push local commits from a Git repository inside a started Daytona sandbox to its remote. Returns an empty response on success. Use daytona_git_push after daytona_git_commit. Use daytona_git_pull to fetch remote changes first.
Inputs
pathstringrequired- Path of the Git repository inside the sandbox, absolute or relative to the working directory. Example: workspace/my-repo
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
branchstring- Branch to push. Defaults to the current branch. Example: feature/login
passwordstring- Password or personal access token for an authenticated remote. Leave empty for public repositories.
remotestring- Remote to push to. Defaults to origin.
set_upstreamboolean- Record the pushed branch as the upstream tracking branch. Defaults to false.
usernamestring- Username for an authenticated remote. For GitHub, any non-empty value works with a token as the password. Example: git
daytona_git_resetReset the current HEAD of a Git repository inside a started Daytona sandbox to a revision.WriteGit Reset
Reset the current HEAD of a Git repository inside a started Daytona sandbox to a revision. Returns an empty response on success. Use daytona_git_reset to undo commits or unstage everything. Mode hard discards working-tree changes. Use daytona_git_restore for individual files.
Inputs
pathstringrequired- Path of the Git repository inside the sandbox, absolute or relative to the working directory. Example: workspace/my-repo
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
filesarray- Limit the reset to these paths. Example: ["src/main.py"]
modestring- Reset mode: soft, mixed (default), hard, merge or keep. hard discards uncommitted changes.one of
softmixedhardmergekeep targetstring- Revision to reset to. Defaults to HEAD. Example: HEAD~1
daytona_git_restoreRestore working-tree files or unstage changes in a Git repository inside a started Daytona sandbox.WriteGit Restore
Restore working-tree files or unstage changes in a Git repository inside a started Daytona sandbox. Returns an empty response on success. Use daytona_git_restore to discard edits to specific files or unstage them. Use daytona_git_reset to move HEAD.
Inputs
filesarrayrequired- Files to restore, relative to the repository. Example: ["src/main.py"]
pathstringrequired- Path of the Git repository inside the sandbox, absolute or relative to the working directory. Example: workspace/my-repo
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
sourcestring- Revision to restore file contents from instead of the index. Example: HEAD~1
stagedboolean- Restore the staging area for these files (unstage them).
worktreeboolean- Restore the working-tree copy of these files (discard edits).
daytona_move_fileMove or rename a file or folder inside a started Daytona sandbox.WriteMove File
Move or rename a file or folder inside a started Daytona sandbox. Returns an empty response on success. Use daytona_move_file to rename or relocate files. Use daytona_execute_command with cp to copy instead.
Inputs
destinationstringrequired- New path for the file or folder. Example: /home/daytona/workspace/new.txt
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
sourcestringrequired- Current path of the file or folder. Example: /home/daytona/workspace/old.txt
daytona_pause_sandboxPause a running Daytona sandbox, keeping its memory state so it resumes where it left off.WritePause Sandbox
Pause a running Daytona sandbox, keeping its memory state so it resumes where it left off. Returns the updated sandbox object with its id, name, state, resources (cpu, memory, disk), labels and auto-stop/archive/delete settings. Use daytona_pause_sandbox for VM-class sandboxes that support pausing. Use daytona_stop_sandbox for other sandboxes, and daytona_start_sandbox to resume.
Inputs
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
daytona_recover_sandboxRecover a Daytona sandbox that is in the error state.WriteRecover Sandbox
Recover a Daytona sandbox that is in the error state. Returns the updated sandbox object with its id, name, state, resources (cpu, memory, disk), labels and auto-stop/archive/delete settings. Use daytona_recover_sandbox only for sandboxes whose state is error and that are marked recoverable. Use daytona_start_sandbox for normal stopped sandboxes.
Inputs
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
skip_startboolean- Leave the sandbox stopped after recovery instead of starting it. Defaults to false.
daytona_replace_in_filesReplace a text pattern with a new value in one or more files inside a started Daytona sandbox.WriteReplace in Files
Replace a text pattern with a new value in one or more files inside a started Daytona sandbox. Returns one result per file with file, success and any error. Use daytona_replace_in_files for targeted edits. Use daytona_find_in_files first to find which files contain the pattern.
Inputs
filesarrayrequired- Paths of the files to edit. Example: ["/home/daytona/workspace/config.py"]
new_valuestringrequired- Replacement text. Example: DEBUG = False
patternstringrequired- Text to find. Example: DEBUG = True
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
daytona_replace_sandbox_labelsReplace all labels on a Daytona sandbox with a new set of key-value pairs.WriteReplace Sandbox Labels
Replace all labels on a Daytona sandbox with a new set of key-value pairs. Returns the sandbox's labels object after the update. Use daytona_replace_sandbox_labels to tag sandboxes for filtering in daytona_list_sandboxes. Existing labels not in the new set are removed.
- Idempotent
Inputs
labelsobjectrequired- The complete new set of labels as a JSON object of key-value pairs; it replaces every existing label. Example: {"environment": "dev", "team": "backend"}
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
daytona_resize_sandboxChange the CPU, memory or disk allocated to a Daytona sandbox.WriteResize Sandbox
Change the CPU, memory or disk allocated to a Daytona sandbox. Returns the updated sandbox object with its id, name, state, resources (cpu, memory, disk), labels and auto-stop/archive/delete settings. Use daytona_resize_sandbox to scale an existing sandbox. Disk can only grow. Set resources at creation time with daytona_create_sandbox.
Inputs
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
cpuinteger- New number of CPU cores (minimum 1). Example: 4
diskinteger- New disk size in GB; disk can only be increased. Example: 20
memoryinteger- New memory size in GB (minimum 1). Example: 8
daytona_run_codeRun a Python, JavaScript or TypeScript snippet inside a started Daytona sandbox.WriteRun Code
Run a Python, JavaScript or TypeScript snippet inside a started Daytona sandbox. Returns the program output as result, its exitCode, and artifacts such as matplotlib charts. Use daytona_run_code to execute generated code. Use daytona_execute_command for shell commands. The sandbox must be started (daytona_start_sandbox).
Inputs
codestringrequired- Source code to run. Example: print(sum(range(10)))
languagestringrequired- Language of the code: python, javascript or typescript.one of
pythonjavascripttypescript sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
argvarray- Command-line arguments passed to the program. Example: ["--verbose"]
envsobject- Environment variables for the program, as a JSON object. Example: {"MODE": "test"}
timeoutinteger- Maximum run time in seconds. Example: 60
daytona_send_session_command_inputSend input text to a running command in a shell session inside a started Daytona sandbox, for interactive programs.WriteSend Session Command Input
Send input text to a running command in a shell session inside a started Daytona sandbox, for interactive programs. Returns an empty response on success. Use daytona_send_session_command_input to answer prompts from a command started with daytona_session_execute_command and run_async.
Inputs
command_idstringrequired- ID of the command, from the cmdId field returned by daytona_session_execute_command. Example: 0b2f7c9e-1a3d-4e5f-8a9b-7c6d5e4f3a2b
datastringrequired- Text to send to the command's standard input. Include a trailing newline to submit a line. Example: y\n
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
session_idstringrequired- ID of the shell session, as chosen in daytona_create_session. Example: build-session
daytona_session_execute_commandRun a command in an existing shell session inside a started Daytona sandbox, optionally in the background.WriteSession Execute Command
Run a command in an existing shell session inside a started Daytona sandbox, optionally in the background. Returns the cmdId plus, for synchronous runs, exitCode, output, stdout and stderr. Use daytona_session_execute_command for commands that depend on earlier state or run long (set run_async). Use daytona_get_session_command_logs to read output of async commands. Create the session first with daytona_create_session.
Inputs
commandstringrequired- Shell command to run in the session. Example: npm install && npm run build
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
session_idstringrequired- ID of the shell session, as chosen in daytona_create_session. Example: build-session
run_asyncboolean- Return immediately with a cmdId instead of waiting for the command to finish. Defaults to false.
suppress_input_echoboolean- Do not echo input sent with daytona_send_session_command_input into the output. Defaults to false.
daytona_set_file_permissionsSet the permission mode, owner or group of a file or folder inside a started Daytona sandbox.WriteSet File Permissions
Set the permission mode, owner or group of a file or folder inside a started Daytona sandbox. Returns an empty response on success. Use daytona_set_file_permissions to make a script executable or change ownership. Use daytona_get_file_info to check the current values.
Inputs
pathstringrequired- Path of the file or folder. Example: /home/daytona/workspace/run.sh
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
groupstring- New group, as a group name or GID. Example: daytona
modestring- Permission mode in octal. Example: 0755
ownerstring- New owner, as a username or UID. Example: daytona
daytona_set_sandbox_autoarchive_intervalSet how many minutes a stopped Daytona sandbox waits before it is archived automatically.WriteSet Sandbox Auto-Archive Interval
Set how many minutes a stopped Daytona sandbox waits before it is archived automatically. Returns the updated sandbox object with its id, name, state, resources (cpu, memory, disk), labels and auto-stop/archive/delete settings. Use daytona_set_sandbox_autoarchive_interval to move long-stopped sandboxes to cheaper storage. Use daytona_set_sandbox_autostop_interval for the running-to-stopped step.
Inputs
intervalintegerrequired- Minutes a stopped sandbox waits before being archived; 0 uses the maximum interval. Example: 10080
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
daytona_set_sandbox_autodelete_intervalSet how many minutes a stopped Daytona sandbox waits before it is deleted automatically.WriteSet Sandbox Auto-Delete Interval
Set how many minutes a stopped Daytona sandbox waits before it is deleted automatically. Returns the updated sandbox object with its id, name, state, resources (cpu, memory, disk), labels and auto-stop/archive/delete settings. Use daytona_set_sandbox_autodelete_interval to clean up throwaway sandboxes. Use daytona_set_sandbox_ttl for a hard lifetime that applies in any state.
Inputs
intervalintegerrequired- Minutes a stopped sandbox waits before deletion; a negative value disables auto-delete and 0 deletes it as soon as it stops. Example: 60
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
daytona_set_sandbox_autopause_intervalSet how many minutes of inactivity a Daytona sandbox waits before pausing automatically.WriteSet Sandbox Auto-Pause Interval
Set how many minutes of inactivity a Daytona sandbox waits before pausing automatically. Returns the updated sandbox object with its id, name, state, resources (cpu, memory, disk), labels and auto-stop/archive/delete settings. Use daytona_set_sandbox_autopause_interval for sandbox classes that support pausing. Use daytona_set_sandbox_autostop_interval for all other sandboxes.
Inputs
intervalintegerrequired- Minutes of inactivity before the sandbox pauses; 0 disables auto-pause. Example: 60
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
daytona_set_sandbox_autostop_intervalSet how many minutes of inactivity a Daytona sandbox waits before stopping automatically.WriteSet Sandbox Auto-Stop Interval
Set how many minutes of inactivity a Daytona sandbox waits before stopping automatically. Returns the updated sandbox object with its id, name, state, resources (cpu, memory, disk), labels and auto-stop/archive/delete settings. Use daytona_set_sandbox_autostop_interval to control idle cost. Use daytona_set_sandbox_autoarchive_interval and daytona_set_sandbox_autodelete_interval for what happens after it stops.
Inputs
intervalintegerrequired- Minutes of inactivity before the sandbox stops; 0 disables auto-stop. Example: 30
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
daytona_set_sandbox_publicMake a Daytona sandbox's HTTP preview URLs public or private.WriteSet Sandbox Public Status
Make a Daytona sandbox's HTTP preview URLs public or private. Returns the updated sandbox object with its id, name, state, resources (cpu, memory, disk), labels and auto-stop/archive/delete settings. Use daytona_set_sandbox_public to share a running app without a token. Use daytona_get_signed_preview_url to share one port temporarily instead.
Inputs
is_publicbooleanrequired- true makes preview URLs reachable without a token; false requires the preview token.
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
daytona_set_sandbox_ttlSet a maximum lifetime for a Daytona sandbox, counted from now; when it elapses the sandbox is destroyed even if stopped, paused or archived.WriteSet Sandbox TTL
Set a maximum lifetime for a Daytona sandbox, counted from now; when it elapses the sandbox is destroyed even if stopped, paused or archived. Returns the updated sandbox object with its id, name, state, resources (cpu, memory, disk), labels and auto-stop/archive/delete settings. Use daytona_set_sandbox_ttl for a hard expiry. Use daytona_set_sandbox_autodelete_interval to delete only after the sandbox stops.
Inputs
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
ttl_minutesintegerrequired- Lifetime in minutes from now; 0 disables the TTL. Example: 1440
daytona_start_sandboxStart a stopped or archived Daytona sandbox, or resume a paused one.WriteStart Sandbox
Start a stopped or archived Daytona sandbox, or resume a paused one. Returns the updated sandbox object with its id, name, state, resources (cpu, memory, disk), labels and auto-stop/archive/delete settings. Use daytona_start_sandbox before running commands in a stopped sandbox. Use daytona_create_sandbox to make a new one, and daytona_recover_sandbox for a sandbox in the error state.
Inputs
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
daytona_stop_sandboxStop a running Daytona sandbox, keeping its filesystem so it can be started again.WriteStop Sandbox
Stop a running Daytona sandbox, keeping its filesystem so it can be started again. Returns the updated sandbox object with its id, name, state, resources (cpu, memory, disk), labels and auto-stop/archive/delete settings. Use daytona_stop_sandbox to save compute while keeping the sandbox. Use daytona_pause_sandbox to keep memory state, daytona_archive_sandbox for long-term storage, and daytona_delete_sandbox to remove it.
Inputs
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
forceboolean- Stop with SIGKILL instead of SIGTERM. Defaults to false.
daytona_update_registryUpdate the name, URL, credentials or project of a Docker registry in Daytona.WriteUpdate Registry
Update the name, URL, credentials or project of a Docker registry in Daytona. Returns the updated registry. Use daytona_update_registry to rotate registry credentials. Name, URL and username are always required by the API.
- Idempotent
Inputs
namestringrequired- Display name for the registry. Example: My Docker Hub
registry_idstringrequired- ID of the Docker registry, from the `id` field returned by daytona_list_registries. Example: 123e4567-e89b-12d3-a456-426614174000
urlstringrequired- Registry URL. Example: https://registry.hub.docker.com
usernamestringrequired- Username for the registry. Example: my-docker-user
passwordstring- New password or access token. Leave empty to keep the current one.
projectstring- Registry project or namespace. Example: my-project
daytona_update_sandbox_network_settingsChange the outbound network policy of a running Daytona sandbox: block all traffic, restore access, or set CIDR and domain allow lists.WriteUpdate Sandbox Network Settings
Change the outbound network policy of a running Daytona sandbox: block all traffic, restore access, or set CIDR and domain allow lists. Returns the updated sandbox object with its id, name, state, resources (cpu, memory, disk), labels and auto-stop/archive/delete settings. Use daytona_update_sandbox_network_settings to lock down or open up a sandbox after creation. Set the initial policy in daytona_create_sandbox.
Inputs
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
domain_allow_liststring- Comma-separated domains the sandbox may reach. Example: example.com,*.github.com
network_allow_liststring- Comma-separated CIDR ranges the sandbox may reach. Example: 10.0.0.0/24,192.168.1.0/16
network_block_allboolean- true blocks all outbound network access; false restores it.
daytona_update_sandbox_secretsReplace the set of organization secrets mounted in a Daytona sandbox as environment variables.WriteUpdate Sandbox Secrets
Replace the set of organization secrets mounted in a Daytona sandbox as environment variables. Returns the updated sandbox object with its id, name, state, resources (cpu, memory, disk), labels and auto-stop/archive/delete settings. Use daytona_update_sandbox_secrets to attach, detach or rotate secrets on an existing sandbox. Create the secrets first with daytona_create_secret. A sandbox created without any secrets must be restarted for newly attached secrets to work.
- Idempotent
Inputs
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
secretsarrayrequired- The complete list of secrets to mount; it replaces the current set. Each entry maps an env var name to a secret name. Pass an empty list to detach all. Example: [{"OPENAI_API_KEY": "openai-prod"}]
daytona_update_secretUpdate the value, description or allowed hosts of a Daytona secret.WriteUpdate Secret
Update the value, description or allowed hosts of a Daytona secret. Returns the updated secret metadata (the value is not returned). Use daytona_update_secret to rotate a secret; sandboxes that mount it pick up the new value within seconds.
- Idempotent
Inputs
secret_idstringrequired- ID of the secret, from the `id` field returned by daytona_list_secrets. Example: 123e4567-e89b-12d3-a456-426614174000
descriptionstring- New description. Example: OpenAI key for agents
hostsarray- New list of hosts this secret may be sent to. Example: ["api.openai.com"]
valuestring- New secret value. Leave empty to keep the current one.
daytona_delete_fileDelete a file or folder inside a started Daytona sandbox.DestructiveDelete File
Delete a file or folder inside a started Daytona sandbox. Returns an empty response on success. Use daytona_delete_file to remove files. Set recursive to true to delete a folder and its contents.
- Idempotent
Inputs
pathstringrequired- Path of the file or folder to delete. Example: /home/daytona/workspace/tmp.txt
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
recursiveboolean- Delete a folder and everything in it. Required for non-empty folders. Defaults to false.
daytona_delete_registryDelete a Docker registry configuration from Daytona.DestructiveDelete Registry
Delete a Docker registry configuration from Daytona. Returns an empty response on success. Use daytona_delete_registry to remove registry credentials you no longer need.
- Idempotent
Inputs
registry_idstringrequired- ID of the Docker registry, from the `id` field returned by daytona_list_registries. Example: 123e4567-e89b-12d3-a456-426614174000
daytona_delete_sandboxPermanently delete a Daytona sandbox and its filesystem.DestructiveDelete Sandbox
Permanently delete a Daytona sandbox and its filesystem. Returns the sandbox object with its desiredState set to destroyed. Use daytona_delete_sandbox only when the sandbox is no longer needed. Use daytona_stop_sandbox or daytona_archive_sandbox to keep it for later.
- Idempotent
Inputs
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
daytona_delete_secretDelete a secret from the Daytona organization vault.DestructiveDelete Secret
Delete a secret from the Daytona organization vault. Returns an empty response on success. Use daytona_delete_secret to remove a secret you no longer need. Detach it from sandboxes first with daytona_update_sandbox_secrets.
- Idempotent
Inputs
secret_idstringrequired- ID of the secret, from the `id` field returned by daytona_list_secrets. Example: 123e4567-e89b-12d3-a456-426614174000
daytona_delete_sessionDelete a shell session inside a started Daytona sandbox and end its processes.DestructiveDelete Session
Delete a shell session inside a started Daytona sandbox and end its processes. Returns an empty response on success. Use daytona_delete_session to clean up after daytona_session_execute_command work is done.
- Idempotent
Inputs
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
session_idstringrequired- ID of the shell session, as chosen in daytona_create_session. Example: build-session
daytona_delete_snapshotPermanently delete a Daytona snapshot.DestructiveDelete Snapshot
Permanently delete a Daytona snapshot. Returns an empty response on success. Use daytona_delete_snapshot to remove a template you no longer need. Use daytona_deactivate_snapshot to keep it but stop it being used.
- Idempotent
Inputs
snapshot_idstringrequired- ID of the snapshot, from the `id` field returned by daytona_list_snapshots. Example: 7b1e2d3c-4a5b-6c7d-8e9f-0a1b2c3d4e5f
daytona_delete_volumeMark a Daytona volume for deletion.DestructiveDelete Volume
Mark a Daytona volume for deletion. Returns an empty response on success; returns 409 if a sandbox still uses the volume. Use daytona_delete_volume to remove storage you no longer need. Delete or reconfigure the sandboxes that mount it first.
- Idempotent
Inputs
volume_idstringrequired- ID of the volume, from the `id` field returned by daytona_list_volumes. Example: 9d8c7b6a-5e4f-4a3b-2c1d-0e9f8a7b6c5d
daytona_git_delete_branchDelete a local branch from a Git repository inside a started Daytona sandbox.DestructiveGit Delete Branch
Delete a local branch from a Git repository inside a started Daytona sandbox. Returns an empty response on success. Use daytona_git_delete_branch to clean up merged branches. It does not delete the branch on the remote.
- Idempotent
Inputs
namestringrequired- Name of the branch to delete. Example: feature/old-experiment
pathstringrequired- Path of the Git repository inside the sandbox, absolute or relative to the working directory. Example: workspace/my-repo
sandbox_idstringrequired- ID of a started sandbox (the UUID in the `id` field from daytona_list_sandboxes or daytona_get_sandbox, not the name). The sandbox must be in the started state and in the US region. Example: 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b
daytona_revoke_ssh_accessRevoke SSH access to a Daytona sandbox, either one token or all of them.DestructiveRevoke SSH Access
Revoke SSH access to a Daytona sandbox, either one token or all of them. Returns the sandbox object. Use daytona_revoke_ssh_access to cut off access granted by daytona_create_ssh_access.
- Idempotent
Inputs
sandbox_id_or_namestringrequired- ID or name of the sandbox. Use daytona_list_sandboxes to find it. Example: my-sandbox
tokenstring- SSH access token to revoke. Leave empty to revoke all SSH access for the sandbox. Example: abc123def456
No tools match.
