Skip to main content
Daytona logo
  • Category: developer tools
  • Auth: API_KEY, OAUTH2
  • Composio-managed OAuth available? Yes
  • Tools: 114
  • Triggers: 0
  • Slug: DAYTONA
  • Version: 20261101_00

Tools

Slug: DAYTONA_ARCHIVE_SANDBOXArchives a sandbox in the Daytona platform. Use this action when you need to archive a sandbox that is no longer needed but should be preserved for future reference. The sandbox will be marked as archived and its state will change to reflect the archival status. Note: Archiving a sandbox does not delete it immediately. The sandbox can potentially be restored or recovered from an archived state depending on the platform configuration.

Input Parameters

string
required
The unique identifier or name of the sandbox to archive

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_CANCEL_ORGANIZATION_INVITATIONCancels a pending organization invitation. Use when you need to revoke an invitation that has been sent but not yet accepted by the recipient. This action is irreversible — once an invitation is cancelled, it cannot be reactivated and the recipient will no longer be able to accept it. The cancelled invitation would need to be re-sent as a new invitation if access is still desired.

Input Parameters

string
required
The ID of the invitation to cancel
string
required
The ID of the organization that sent the invitation

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_CHECKOUT_GIT[DEPRECATED] Checkout a branch or commit in a git repository within a sandbox. Use this action when you need to switch branches or checkout a specific commit in a git repository that exists within a sandbox toolbox. This operation modifies the working tree of the repository. Note: This endpoint is deprecated. Consider using alternative approaches for git operations if available. The sandbox must be in a running state for this operation to succeed.

Input Parameters

string
required
The path to the git repository within the sandbox
string
required
The name of the branch to checkout, or the commit hash to checkout
string
required
The unique identifier of the sandbox

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_CLONE_REPOSITORYClones a Git repository into a sandbox toolbox. Use this action when you need to clone a public or private Git repository into a specific directory within a sandbox. Supports optional branch selection and commit checkout. This is commonly used to set up a development environment or fetch source code for further operations. Note: Credentials (username/password) should only be provided when the target repository requires authentication. The sandbox must be running to perform this operation.

Input Parameters

string
required
The URL of the Git repository to clone
string
required
The directory path where the repository will be cloned
string
The specific branch to clone. If not specified, the default branch will be cloned
string
Password or access token for authentication if the repository requires it
string
Username for authentication if the repository requires it (e.g., private repositories)
string
A specific commit ID to checkout after cloning. If specified with branch, the commit must be on that branch
string
required
The ID of the sandbox to clone the repository into

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_CREATE_API_KEYCreates a new API key for the organization. Use when you need to generate a new API key that can be used to authenticate API requests. The created API key value is only returned once in the response and cannot be retrieved again, so it must be stored securely. This action requires appropriate organization permissions.

Input Parameters

string
required
The name of the API key
string
When the API key expires, in ISO 8601 format (e.g., ‘2025-06-09T12:00:00.000Z’). If not provided, the key does not expire.
array
required
The list of organization resource permissions explicitly assigned to the API key. Choose from: write:registries, delete:registries, write:snapshots, delete:snapshots, write:sandboxes, delete:sandboxes, read:volumes, write:volumes, delete:volumes, write:regions, delete:regions, read:runners, write:runners, delete:runners, read:audit_logs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_CREATE_BACKUPInitiates a backup operation for an existing sandbox environment. Use this action when you need to create a point-in-time snapshot of a sandbox that can be used for restoration or cloning purposes. The backup operation is asynchronous and the status can be tracked via the backupState field in the response (Pending -> InProgress -> Completed or Error). Note: This action creates a backup resource. Ensure the sandbox is in a suitable state for backing up. Large sandboxes may take longer to complete the backup.

Input Parameters

string
required
The ID or name of the sandbox to create a backup for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_CREATE_FOLDER_FILESCreates a new folder inside a sandbox’s filesystem. Use this action when you need to create a directory within a running sandbox’s filesystem. This is useful for organizing files, preparing directory structures, or setting up paths for subsequent file operations. Note: This endpoint is deprecated. Consider using alternative methods for folder creation if available.

Input Parameters

string
required
Folder permissions in octal format (e.g., ‘755’ for rwxr-xr-x)
string
required
The path where the folder should be created (e.g., ‘my-folder’ or ‘projects/my-app’)
string
required
The unique identifier of the sandbox where the folder will be created

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_CREATE_ORGANIZATIONCreates a new organization in Daytona. Use this action when you need to set up a new organization with a specific name and default region configuration. This action creates a top-level organization entity that can manage sandboxes, users, and resources within the specified region.

Input Parameters

string
required
The name of the organization to create
string
required
The ID of the default region for the organization

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_CREATE_ORGANIZATION_INVITATIONCreates an invitation to join an organization with specified roles and permissions. The invitation will be sent to the provided email address. Use this action when you need to invite a new member to an organization with specific role assignments. The invitation email will include a link to accept the invitation.

Input Parameters

string ("owner" | "member")
required
Organization member role for the invitee (owner or member)
string
required
Email address of the invitee
string
Expiration date of the invitation (ISO 8601 format)
string
required
The unique identifier of the organization
array
required
Array of assigned role IDs for the invitee

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_CREATE_ORGANIZATION_ROLECreates a new organization role with specified permissions. Use this action when you need to define custom roles for organization members, allowing fine-grained control over what resources they can access and what operations they can perform. Common use cases include creating roles like “Developer” (with sandbox write access), “Viewer” (read-only access), or “Admin” (full access to all resources).

Input Parameters

string
required
The name of the role to create
string
required
A description explaining the purpose and scope of the role
array
required
The list of permissions to assign to this role. Each permission controls access to specific resources and operations.
string
required
The unique identifier of the organization to create the role in

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_CREATE_PROCESS_SESSIONCreates a new session in the sandbox for process management. Use this action when you need to establish a new process session within a running sandbox environment. This enables managing process execution and state within the Daytona platform. The session can be used to track and manage process-related operations. Note: This endpoint is deprecated. Consider using alternative methods for process session management if available. The sandbox must be in a running state for this operation to succeed.

Input Parameters

string
required
The unique identifier of the sandbox
string
required
The unique identifier for the process session

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_CREATE_PTY_SESSIONCreates a new PTY (pseudo-terminal) session in a sandbox. Use this action when you need to establish an interactive terminal session within a running sandbox environment. This enables real-time command execution and terminal interaction through the Daytona platform. The session can be configured with specific terminal dimensions (cols/rows), working directory, and environment variables. Note: This endpoint is deprecated. The sandbox must be in a running state for this operation to succeed. Consider alternative methods for terminal sessions if available.

Input Parameters

string
required
The unique identifier for the PTY session
string
Starting directory for the PTY session, defaults to the sandbox’s working directory
integer
Number of terminal columns
object
Environment variables for the PTY session
integer
Number of terminal rows
boolean
Whether to start the PTY session lazily (only start when first client connects)
string
required
The unique identifier of the sandbox

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_CREATE_REGISTRYCreates a new Docker registry for the organization. Use when you need to register a new container registry (such as Docker Hub, GCR, ECR, or other Docker registries) so that Daytona can pull images from it. The registry credentials are stored securely and used for pulling images when creating sandboxes. Ensure the provided credentials have appropriate permissions (typically read access to the registry).

Input Parameters

string
required
The URL of the registry. For Docker Hub use ‘https://registry.hub.docker.com’, for other registries provide the full URL.
string
required
The name of the registry to create. This should be a descriptive name that identifies the registry.
string
Optional project name to associate with the registry. If not specified, the registry will be associated with the organization.
string
required
The password or access token for authenticating with the registry. For security, this field is not returned in responses.
string
required
The username for authenticating with the registry.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_CREATE_SANDBOXCreates a new sandbox environment for development or testing purposes. Use this action when you need to provision a new isolated environment with configurable compute resources (CPU, memory, GPU), networking options, and storage volumes. The sandbox can be customized with environment variables, labels, and automatic lifecycle management settings. Note: This action creates a new resource. Ensure you have the appropriate permissions in your organization before creating sandboxes.

Input Parameters

integer
CPU cores allocated to the sandbox
object
Environment variables for the sandbox
integer
GPU units allocated to the sandbox
integer
Disk space allocated to the sandbox in GB
string
The name of the sandbox. If not provided, the sandbox ID will be used as the name
string
The user associated with the project
object
Labels for the sandbox
integer
Memory allocated to the sandbox in GB
boolean
Whether the sandbox HTTP preview is publicly accessible
string
The target (region) where the sandbox will be created
array
Preferred GPU type for the sandbox. Accepts a single value or an ordered preference list — the scheduler tries each in order and pins the sandbox to the first that has capacity.
array
Array of volumes to attach to the sandbox
string
The ID or name of the snapshot used for the sandbox
object
Build information for the sandbox.
string
ID or name of an existing sandbox to link the new sandbox to. The new sandbox will be scheduled on the same runner as the linked sandbox so a local network can be established between them. Linked sandboxes must be ephemeral (autoDeleteInterval=0) and cannot themselves be linked to another sandbox.
boolean
Whether to block all network access for the sandbox
integer
Auto-stop interval in minutes (0 means disabled)
string
Comma-separated list of allowed CIDR network addresses for the sandbox
integer
Auto-delete interval in minutes (negative value means disabled, 0 means delete immediately upon stopping)
integer
Auto-archive interval in minutes (0 means the maximum interval will be used)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_CREATE_SNAPSHOTCreates a new snapshot resource that can be used as a base image for sandboxes. Use this action when you need to create a new snapshot with specific compute resources (CPU, memory, GPU, disk) and a container image. Snapshots define the base configuration that sandboxes will inherit when created from them. The snapshot can be built from a Dockerfile using the buildInfo parameter, or use an existing image via the imageName parameter. Note: Snapshots with tags like “:latest” are not allowed. Ensure the name parameter is unique within your organization.

Input Parameters

integer
CPU cores allocated to the resulting sandbox
integer
GPU units allocated to the resulting sandbox
integer
Disk space allocated to the sandbox in GB
string
required
The name of the snapshot. This is a required field and must be unique within the organization.
integer
Memory allocated to the resulting sandbox in GB
array
Preferred GPU type for the resulting sandbox.
string
ID of the region where the snapshot will be available. Defaults to organization default region if not specified.
object
Build information for the snapshot request.
string
The image name of the snapshot (e.g., ubuntu:22.04)
array
The entrypoint command for the snapshot
string ("linux-vm" | "container" | "android" | "windows")
Target sandbox class — determines which runners can host the sandbox.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_CREATE_SSH_ACCESSCreates SSH access credentials for a sandbox environment. Use this action when you need to establish an SSH connection to a sandbox for administrative tasks, file transfers, or development operations. The returned credentials include a token and SSH command that can be used to connect to the sandbox securely. Note: SSH access tokens have a limited validity period. By default, they expire after 60 minutes. Use the expiresInMinutes parameter to customize the expiration time if needed.

Input Parameters

string
required
The ID or name of the sandbox to create SSH access for
integer
Expiration time in minutes for the SSH access. Default is 60 minutes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_CREATE_VOLUMECreates a new volume for storing data that can be attached to sandboxes. Use this action when you need to provision persistent storage for your sandbox environments. Volumes persist data across sandbox restarts and can be mounted to sandboxes to provide additional storage capacity. Note: This action creates a new storage resource. Ensure you have the appropriate permissions in your organization before creating volumes.

Input Parameters

string
required
The name of the volume to create. This should be a descriptive identifier for the volume.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_DEACTIVATE_SNAPSHOTDeactivates a snapshot in the Daytona platform. Use this action when you need to deactivate a snapshot that is currently active. This will stop the snapshot from being used for new sandbox creations. Note: Deactivating a snapshot does not delete it. The snapshot data remains accessible but the snapshot is marked as inactive.

Input Parameters

string
required
The ID of the snapshot to deactivate

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_DELETE_API_KEYDeletes an API key by its name. Use when you need to revoke access for an API key that is no longer needed or has been compromised. This action is irreversible — once an API key is deleted, it cannot be recovered and any systems using that key will immediately lose access.

Input Parameters

string
required
The name of the API key to delete. URL-encode special characters if needed

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_DELETE_API_KEY_USERDeletes an API key for a specific user. Use when you need to remove an existing API key associated with a user account, such as when cleaning up unused credentials or revoking access. This action is irreversible — once the API key is deleted, it cannot be recovered and any systems relying on that key will lose access.

Input Parameters

string
required
The name of the API key to delete. URL-encode special characters if needed
string
required
The unique identifier of the user whose API key is being deleted

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_DELETE_FILESDeletes a file inside a sandbox by its path, with an option to delete directories recursively. This action uses a deprecated API endpoint.

Input Parameters

string
required
The path to the file to delete within the sandbox. Must be an absolute path
boolean
If true, delete directories recursively. If false or not specified, only delete files
string
required
The ID of the sandbox where the file is located

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_DELETE_GIT_BRANCHDeletes a branch from a git repository inside a sandbox by its name. Use when you need to permanently remove a git branch that is no longer needed. This action is irreversible — once a branch is deleted, it cannot be recovered unless it has been pushed to a remote. Ensure the branch has been properly merged or is no longer needed before proceeding. Note: This action uses a deprecated API endpoint. The API documentation marks this endpoint as [DEPRECATED]. Consider using alternative methods for git branch management when available.

Input Parameters

string
required
The name of the branch to delete
string
required
The path to the git repository within the sandbox (e.g., ’.’ for root)
string
required
The ID of the sandbox where the git repository is located

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_DELETE_ORGANIZATIONDeletes an organization. Use when you need to permanently remove an organization from the system, including all associated data, members, and resources. This action is irreversible — once an organization is deleted, it cannot be recovered. All organization data, including workspaces, sandboxes, and member information, will be permanently lost. Ensure you have appropriate backups or have migrated necessary data before proceeding.

Input Parameters

string
required
The unique identifier of the organization to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_DELETE_ORGANIZATION_OTEL_CONFIGDeletes the OpenTelemetry (OTEL) configuration for an organization. Use this action when you need to remove the OpenTelemetry settings that were previously configured for an organization’s observability and tracing capabilities. This action is irreversible — once the OpenTelemetry configuration is deleted, the organization will no longer have OTEL tracing enabled and any previously collected telemetry data will no longer be accessible through the configured OTEL endpoint. A new configuration would need to be created to re-enable OpenTelemetry observability.

Input Parameters

string
required
The unique identifier of the organization whose OTEL config should be deleted

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_DELETE_ORGANIZATION_ROLEDeletes an organization role. Use when you need to permanently remove a role from an organization, such as cleaning up unused custom roles or removing roles that are no longer needed. This action is irreversible — once a role is deleted, it cannot be recovered. Users who were assigned this role will lose the associated permissions and access. Ensure no active users or resources depend on this role before proceeding.

Input Parameters

string
required
The unique identifier of the role to delete
string
required
The unique identifier of the organization

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_DELETE_PTY_SESSIONDeletes a PTY session and terminates the associated process. Use this action when you need to clean up an active PTY session that is no longer needed. This will terminate any process running in that session and release the associated resources. Note: This endpoint is deprecated. Consider using alternative methods for managing PTY sessions in new implementations. This action is irreversible — once the PTY session is deleted and the process is terminated, they cannot be recovered.

Input Parameters

string
required
The unique identifier of the sandbox containing the PTY session
string
required
The unique identifier of the PTY session to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_DELETE_RECORDINGDeletes a recording from the Daytona platform by its ID. Use when you need to permanently remove a recording that is no longer needed. This action is irreversible — once a recording is deleted, it cannot be recovered. Any data associated with the recording will be permanently lost.

Input Parameters

string
required
The unique identifier of the recording to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_DELETE_REGISTRYDeletes a Docker registry from the Daytona platform. Use when you need to remove an existing Docker registry configuration. This is an irreversible operation — once a registry is deleted, it cannot be recovered and any references to it in workspaces may fail until reconfigured.

Input Parameters

string
required
ID of the docker registry to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_DELETE_SANDBOXDeletes a sandbox from the Daytona platform by its ID or name. Use when you need to permanently remove a sandbox that is no longer needed. This action is irreversible — once a sandbox is deleted, it cannot be recovered. Any data, processes, or configurations within the sandbox will be permanently lost. Ensure all important work has been saved or backed up before proceeding.

Input Parameters

string
required
The ID or name of the sandbox to delete. URL-encode special characters if using a name with special characters

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_DELETE_SESSIONDeletes a session from the Daytona platform by its ID. Use when you need to permanently remove a session that is no longer needed. This action is irreversible — once a session is deleted, it cannot be recovered. Any ongoing processes or data associated with the session will be permanently lost.

Input Parameters

string
required
The unique identifier of the sandbox containing the session
string
required
The unique identifier of the session to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_DELETE_SNAPSHOTDeletes a snapshot from the Daytona platform by its ID. Use when you need to permanently remove a snapshot that is no longer needed. This action is irreversible — once a snapshot is deleted, it cannot be recovered. Any data stored in the snapshot will be permanently lost.

Input Parameters

string
required
The unique identifier of the snapshot to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_DELETE_VOLUMEDeletes a volume from the Daytona platform by its ID. Use when you need to permanently remove a volume that is no longer needed. This action is irreversible — once a volume is deleted, it cannot be recovered. Ensure all important data has been backed up before proceeding. Note: A volume cannot be deleted if it is in use by one or more sandboxes.

Input Parameters

string
required
The ID of the volume to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_DOWNLOAD_FILE_DEPRECATED[DEPRECATED] Downloads a file from a sandbox’s toolbox filesystem. Use this action when you need to retrieve a file from the sandbox’s toolbox. Note: This endpoint is deprecated. Consider using an alternative if available. This is a read-only operation that does not modify any resources.

Input Parameters

string
required
The file path to download (must be an absolute path within the sandbox)
string
required
The ID of the sandbox

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_DOWNLOAD_FILESDownloads multiple files from a sandbox in a single operation as a multipart/form-data bundle. The bundle is returned as a downloadable file.

Input Parameters

array
required
List of remote file paths to download from the sandbox
string
required
The ID of the sandbox to download files from

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_ENROLL_IN_SMS_MFAEnrolls the authenticated user in SMS-based multi-factor authentication. Use when you need to enable SMS-based MFA for the authenticated user account. This action initiates the enrollment process and returns a URL where the user can complete the MFA setup by providing their phone number. Note: After enrollment, the user must complete the verification process by visiting the returned URL and entering the verification code sent to their phone.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_EXECUTE_COMMANDExecutes a shell command within a running sandbox via the toolbox proxy. Use this action when you need to run shell commands, scripts, or any executable commands inside a sandbox environment. This is useful for automation tasks, running build commands, executing scripts, or performing system operations within the sandbox. The sandbox must be in a running state for this action to succeed. Command execution is synchronous and will wait for completion up to the specified timeout (default 10 seconds).

Input Parameters

string
The current working directory for the command execution
object
Environment variables to set for the command execution
string
required
The command to execute in the sandbox shell
integer
Timeout for the command execution in seconds. Defaults to 10 seconds if not specified
string
required
The unique identifier of the sandbox

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_EXPIRE_SIGNED_PORT_PREVIEW_URLExpires a signed preview URL for a sandbox port. Use this action when you need to immediately invalidate a signed preview URL for a specific port on a sandbox, revoking access for anyone holding the token. This action is useful for security purposes when you need to quickly revoke access to a previously shared preview URL. This action is irreversible — once the signed preview URL is expired, the token will no longer provide access to the sandbox port, and a new signed preview URL must be generated if access is needed again.

Input Parameters

integer
required
The port number to expire the signed preview URL for
string
required
The token of the signed preview URL to expire
string
required
The ID or name of the sandbox

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_FIND_IN_FILES_DEPRECATED[DEPRECATED] Searches for text or patterns in files within a sandbox. Use this action when you need to find occurrences of a specific text or pattern across files in a sandbox. This is useful for code search, debugging, or locating specific content within the sandbox file system. This is a read-only operation. NOTE: This action is deprecated and may be removed in future versions. Consider using alternative search mechanisms if available.

Input Parameters

string
required
The directory path to search in (e.g., / or /src)
string
required
The text or regex pattern to search for in files
string
required
The ID of the sandbox to search in

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_FOCUS_ACCESSIBILITY_NODEFocuses an accessibility node in a sandbox’s computer use system. Use this action when you need to programmatically set focus to a specific accessibility node within a sandbox’s desktop environment. This is particularly useful for UI automation workflows where you need to ensure a specific element has focus before performing keyboard or mouse actions on it. Note: The sandbox must have computer use enabled for this action to work. This action is idempotent — focusing the same node multiple times will have the same effect.

Input Parameters

string
required
The unique identifier of the accessibility node to focus
string
required
The ID of the sandbox where the accessibility node is located

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_API_KEYRetrieves an API key by its name. Use when you need to retrieve details about a specific API key, including its creation date, expiration, permissions, and usage statistics. This is a read-only operation that does not modify any resources.

Input Parameters

string
required
The name of the API key to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_AVAILABLE_ACCOUNT_PROVIDERSRetrieves all available account providers that can be used to authenticate and link accounts. Use when you need to discover which account providers (such as GitHub, GitLab, Google) are available for linking to the user’s account. This is a read-only operation that does not modify any resources. Note: The list includes both the provider name (machine-readable) and displayName (human-readable) for each provider.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_BUILD_LOGS_URLRetrieves the build logs URL for a specific sandbox by its ID or name. Use this action when you need to access build logs for a sandbox, such as during troubleshooting build failures, monitoring build progress, or retrieving historical build information. This is a read-only operation that does not modify any resources.

Input Parameters

string
required
The ID or name of the sandbox to retrieve build logs URL for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_COMMIT_HISTORYGets commit history from a repository in a sandbox toolbox, including commit hashes, authors, messages, and timestamps. An empty or HTML HTTP 200 response is returned as an empty history.

Input Parameters

string
required
The path to the git repository
string
required
The ID of the sandbox to get commit history from

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_COMPUTER_USE_STATUSRetrieves the status of all VNC desktop processes in a sandbox. Use this action when you need to check the current state of all VNC desktop processes running within a sandbox. The status can indicate whether services are fully operational (active), partially running (partial), not running (inactive), or experiencing errors (error). This is useful for monitoring the health of computer use services and troubleshooting connectivity issues. This is a read-only operation that does not modify any resources. Note: This endpoint is deprecated. Consider using alternative methods for checking computer use status in new implementations.

Input Parameters

string
required
The ID of the sandbox to get computer use status for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_CONFIGRetrieves the Daytona platform configuration including URLs, OIDC settings, analytics, rate limits, and other platform-level settings. Use this action when you need to fetch the current Daytona configuration settings, such as the dashboard URL, proxy settings, SSH gateway configuration, analytics endpoints, or to check if maintenance mode is enabled. This is a read-only operation that returns the platform configuration.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_DISPLAY_INFORetrieves information about displays connected to a sandbox. Use this action when you need to get information about all displays connected to a sandbox, including their dimensions, positions, and active status. This is a read-only operation that does not modify any resources. Note: This endpoint is deprecated. Consider using alternative methods for retrieving display information in new implementations.

Input Parameters

string
required
The ID of the sandbox to get display info for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_ENTRYPOINT_LOGSRetrieves stdout, stderr, and combined entrypoint logs for a sandbox session. A non-JSON response is returned as empty logs.

Input Parameters

boolean
Whether to follow the logs stream in real-time (WebSocket only)
string
required
The unique identifier of the sandbox

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_FILE_INFO[DEPRECATED] Gets file info inside a sandbox toolbox. Use this action when you need to retrieve detailed information about a specific file or directory within a sandbox toolbox, including its size, permissions, ownership, and modification timestamps. This is a read-only operation that does not modify any resources. Note: This endpoint is deprecated. It is recommended to use alternative approaches for file operations in newer integrations.

Input Parameters

string
required
The path to the file or directory to get info for
string
required
The ID of the sandbox to get file info from

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_GIT_HISTORY_DEPRECATED[DEPRECATED] Get commit history from a git repository in a sandbox toolbox. Use this action when you need to retrieve the commit history of a git repository within a sandbox toolbox. This is a read-only operation that retrieves the commit log without modifying any resources. Note: This endpoint is deprecated. It is recommended to use alternative approaches for git operations in newer integrations.

Input Parameters

string
required
The path to the git repository
string
required
The ID of the sandbox to get git history from

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_HAS_SANDBOX_ACCESSChecks whether the authenticated user has access to a specified sandbox. Use this read-only check before performing operations that require access to the sandbox.

Input Parameters

string
required
The unique identifier of the sandbox to check access for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_HEALTHRetrieves the current health status of the Daytona service. Use when you need to verify that the Daytona API is running and accessible. This action is read-only and does not modify any data. This action is useful for monitoring, debugging connection issues, or confirming API availability before performing other operations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_ORGANIZATIONRetrieves detailed information about an organization by its unique identifier. Use when you need to fetch organization settings, rate limits, sandbox configurations, suspension status, OpenTelemetry settings, and other organization-level details. This is a read-only operation that returns the current organization state.

Input Parameters

string
required
The unique identifier of the organization to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_ORGANIZATION_AUDIT_LOGSRetrieves audit logs for an organization. Use when you need to track user activities, monitor security events, investigate incidents, or meet compliance requirements. This action supports both page-based and cursor-based pagination. For fetching subsequent pages, use the nextToken from the previous response. Date range filtering can narrow results to specific time periods.

Input Parameters

string
End date for filtering audit logs (ISO 8601 format, e.g., 2024-12-31T23:59:59Z).
string
Start date for filtering audit logs (ISO 8601 format, e.g., 2024-01-01T00:00:00Z).
integer
Page number for pagination. When nextToken is provided, this parameter is ignored.
integer
Number of results per page. Default is 25, maximum is 100.
string
Token for cursor-based pagination. When provided, takes precedence over the page parameter.
string
required
The unique identifier of the organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_ORGANIZATION_INVITATIONS_COUNT_USERRetrieves the count of organization invitations for the authenticated user. Use this action when you need to check how many organization invitations are pending for the currently authenticated user. This is a read-only operation that does not modify any data. The count includes all pending invitations across all organizations the user has been invited to.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_ORGANIZATION_USAGE_OVERVIEWRetrieves the current usage overview for an organization, including CPU, memory, disk, snapshot, and volume usage metrics across all regions. Use this action when you need to check an organization’s current resource usage, such as monitoring quota consumption, planning capacity, or auditing resource utilization. This is a read-only operation that does not modify any resources.

Input Parameters

string
required
The unique identifier of the organization

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_PROCESS_STATUSRetrieves the status of a specific VNC process in a sandbox. Use this action when you need to check if a particular VNC process (such as xfce4) is currently running within a sandbox. This is useful for monitoring process availability, verifying desktop environment readiness, or determining if a process needs to be started. This is a read-only operation that does not modify any resources. Note: This endpoint is deprecated. Consider using alternative methods for checking process status in new implementations.

Input Parameters

string
required
The ID of the sandbox containing the VNC process
string
required
The name of the VNC process to check status for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_PROJECT_DIR_DEPRECATED[DEPRECATED] Gets the project directory path within a sandbox toolbox. Use this action when you need to retrieve the project directory path for a specific sandbox toolbox. This is a read-only operation that does not modify any resources. Note: This endpoint is deprecated. It is recommended to use alternative approaches for determining the project directory in newer integrations.

Input Parameters

string
required
The ID of the sandbox to get the project directory from

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_PTY_SESSIONRetrieves information about a PTY (pseudo-terminal) session in a sandbox. Use this action when you need to fetch details about a specific PTY session within a sandbox, including its configuration (terminal dimensions, working directory, environment variables), creation timestamp, and active status. This is useful for monitoring PTY session state, checking if a session is still active, or retrieving session configuration details. This is a read-only operation that does not modify any resources. Note: This endpoint is deprecated. Consider using alternative methods for managing PTY sessions in new implementations.

Input Parameters

string
required
The ID of the sandbox containing the PTY session
string
required
The unique identifier of the PTY session to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_PUSH_ACCESSRetrieves temporary storage access credentials for pushing objects to object storage. Use this action when you need to upload or push objects to the Daytona object storage service. The returned credentials (access key, secret, session token, storage URL, and bucket name) are temporary and should be used immediately for the push operation. This is a read-only operation that does not modify any stored objects. Note: The returned credentials have a limited validity period. Use them promptly after retrieval for any object storage operations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_REGISTRYRetrieves details of a Docker registry by its unique identifier, including its URL, username, project association, and type. This is a read-only operation.

Input Parameters

string
required
The unique identifier of the Docker registry to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_SANDBOXRetrieves details of a specific sandbox by its ID or name. Use this action when you need to fetch detailed information about a particular sandbox, including its configuration, state, resource quotas, labels, environment variables, volumes, and other metadata. This is a read-only operation that does not modify any resources.

Input Parameters

boolean
Include verbose output in the response
string
required
The ID or name of the sandbox to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_SESSION_COMMAND_LOGSRetrieves the combined stdout and stderr logs for a command in a sandbox session as plain text. Use this read-only operation to review command output or investigate execution issues. It returns the response body rather than a live WebSocket stream.

Input Parameters

boolean
Whether to follow logs in real-time (WebSocket only)
string
required
The unique identifier of the command to retrieve logs for
string
required
The unique identifier of the sandbox that owns the session
string
required
The unique identifier of the session containing the command

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_SESSION_DEPRECATED[DEPRECATED] Retrieves details of a specific session in a sandbox toolbox. Use this action when you need to fetch information about a particular session, including its ID and the commands that have been executed within it. This is a read-only operation that does not modify any resources. Note: This endpoint is deprecated. It is recommended to use alternative approaches for session management in newer integrations.

Input Parameters

string
required
The ID of the sandbox containing the session
string
required
The ID of the session to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_SNAPSHOTRetrieves details of a specific snapshot by its ID or name. Use this action when you need to fetch detailed information about a particular snapshot, including its configuration, state, resource quotas, build information, and other metadata. This is a read-only operation that does not modify any resources.

Input Parameters

string
required
The ID or name of the snapshot to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_SNAPSHOT_BUILD_LOGSRetrieves build logs for a specific snapshot. Use this action when you need to access build logs for a snapshot, such as during troubleshooting build failures, monitoring build progress, or retrieving historical build information. This is a read-only operation that does not modify any resources.

Input Parameters

string
required
The unique identifier of the snapshot
boolean
Whether to follow the logs stream in real-time

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_TOOLBOX_PROXY_URLRetrieves the toolbox proxy URL for a sandbox by its ID or name. Use this action when you need to access the toolbox interface of a sandbox, enabling command execution and file management operations. This is a read-only operation that does not modify any resources.

Input Parameters

string
required
The ID or name of the sandbox

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_TRANSIENT_PUSH_ACCESSRetrieves temporary registry access credentials for pushing snapshots. Use this action when you need to obtain short-lived authentication credentials to push Docker images or snapshots to the Daytona registry. The credentials expire after a short time, so use them immediately after obtaining them. This action is idempotent - calling it generates a fresh set of temporary credentials.

Input Parameters

string
ID of the region where the snapshot will be available (defaults to organization default region)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_USERRetrieves the profile of the authenticated user. Use when you need to fetch details about the currently logged-in user, including their ID, email, name, creation date, and associated public keys. This action requires authentication and uses the bearer token provided in the request headers to identify the user. This is a read-only operation that does not modify any resources.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_USER_HOME_DIR_DEPRECATED[DEPRECATED] Gets the user home directory path for a sandbox. Use this action when you need to retrieve the home directory path for a user within a sandbox toolbox. This is a read-only operation that does not modify any resources. Note: This endpoint is deprecated. It is recommended to use alternative approaches for sandbox operations in newer integrations.

Input Parameters

string
required
The ID of the sandbox

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_VOLUMERetrieves details of a specific volume by its ID. Use this action when you need to fetch information about a particular volume, including its name, state, organization, creation timestamp, and last usage. This is a read-only operation that does not modify any resources.

Input Parameters

string
required
The unique identifier of the volume to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_WINDOWSRetrieves information about all windows in a sandbox. Use this action when you need to get a list of all windows currently open in a sandbox desktop environment. The response includes each window’s position, dimensions, title, and active status. This is useful for monitoring the desktop state, automating window interactions, or determining which application is currently in focus. This is a read-only operation that does not modify any resources.

Input Parameters

string
required
The ID of the sandbox to get windows information for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_WORK_DIRGets the current working directory inside a sandbox toolbox. Use this action when you need to retrieve the current working directory path within a sandbox toolbox. This is a read-only operation that does not modify any resources. This is useful for determining the context for subsequent file operations or command execution within the sandbox.

Input Parameters

string
required
The ID of the sandbox to get the working directory from

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_GET_WORK_DIR_DEPRECATED[DEPRECATED] Retrieves the working directory path of a sandbox toolbox. Use this action when you need to determine the current working directory path within a sandbox toolbox environment. This is a read-only operation that does not modify any resources. Note: This endpoint is deprecated. It is recommended to use alternative approaches for determining sandbox working directories in newer integrations.

Input Parameters

string
required
The ID of the sandbox

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_LIST_API_KEYSLists all API keys for the organization. Use when you need to retrieve information about all available API keys, including their names, creation dates, expiration dates, and associated permissions. This is a read-only operation that does not modify any resources. Note: API key values are returned masked (e.g., “bb_********************def”).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_LIST_AVAILABLE_REGIONSLists all available regions for the organization. Use this action when you need to retrieve information about all available regions, including their IDs, names, types, and associated URLs (proxy, SSH gateway, snapshot manager). This is a read-only operation that does not modify any resources.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_LIST_FILES_DEPRECATED[DEPRECATED] Lists files and directories in a sandbox toolbox. Use this action when you need to retrieve the list of files and directories in a specific path within a sandbox toolbox. This is a read-only operation that does not modify any resources. Note: This endpoint is deprecated. It is recommended to use alternative approaches for file listing in newer integrations.

Input Parameters

string
The directory path to list files from. Defaults to root directory if not specified.
string
required
The ID of the sandbox to list files from

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_LIST_GIT_BRANCHES[DEPRECATED] Lists all git branches from a repository in a sandbox toolbox. Use this action when you need to retrieve the list of git branches from a repository within a sandbox toolbox. This is a read-only operation that does not modify any resources. Note: This endpoint is deprecated. It is recommended to use alternative approaches for git operations in newer integrations.

Input Parameters

string
required
The path to the git repository
string
required
The ID of the sandbox to list git branches from

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_LIST_ORGANIZATION_INVITATIONSLists all pending organization invitations. Use this action when you need to retrieve all invitations for an organization, including pending, accepted, declined, or cancelled invitations. This is useful for managing organization membership and reviewing pending invitations. This is a read-only operation that does not modify any resources.

Input Parameters

string
required
The unique identifier of the organization

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_LIST_ORGANIZATION_INVITATIONS_USERLists all organization invitations for the authenticated user. Use when you need to retrieve pending and past organization invitations that have been sent to or received by the current user, including their status, assigned roles, and expiration details. This is a read-only operation that does not modify any resources.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_LIST_ORGANIZATION_MEMBERSLists all members of a specific organization. Use when you need to retrieve information about all organization members, including their names, emails, roles, and assigned permissions. This is a read-only operation that does not modify any resources.

Input Parameters

string
required
The unique identifier of the organization

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_LIST_ORGANIZATION_ROLESLists all roles available in an organization. Use when you need to retrieve information about all organization roles, including their names, descriptions, permissions, and whether they are global roles. This is a read-only operation that does not modify any resources.

Input Parameters

string
required
The unique identifier of the organization

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_LIST_ORGANIZATIONSLists all organizations that the authenticated user has access to. Use this action when you need to retrieve a list of all organizations available to the authenticated user, including their settings, rate limits, and configuration. This is a read-only operation that does not modify any resources.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_LIST_PROCESS_SESSIONLists all active process sessions in a sandbox. Use this action when you need to retrieve information about all active process sessions running within a sandbox. This includes session IDs and command history for each session. This is a read-only operation that does not modify any resources. Note: This endpoint is deprecated. Consider using alternative methods for retrieving process session information in new implementations.

Input Parameters

string
required
The ID of the sandbox to list process sessions for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_LIST_PTY_SESSIONSLists all active PTY sessions in a sandbox. Use this action when you need to retrieve information about all active pseudo-terminal (PTY) sessions running within a sandbox. This includes session identifiers, working directories, terminal dimensions, and environment variables. This is useful for monitoring active sessions, auditing terminal activity, or managing multiple concurrent terminal sessions. This is a read-only operation that does not modify any resources. Note: This endpoint is deprecated. Consider using alternative methods for listing PTY sessions in new implementations.

Input Parameters

string
required
The ID of the sandbox to list PTY sessions for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_LIST_REGISTRIESLists all docker registries available in the organization. Use when you need to retrieve information about all configured docker registries, including their IDs, names, URLs, authentication details, and types. This is a read-only operation that does not modify any resources.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_LIST_SANDBOXESLists a page of sandboxes for the organization, including information about their configuration, state, labels, and resource quotas. Supports label filtering, verbose output, and inclusion of errored and deleted sandboxes. The page size defaults to 25 and is limited to 500; a supplied cursor takes precedence over the page number.

Input Parameters

integer
Page number for pagination. When cursor is provided, this parameter is ignored.
integer
Number of results per page. Default is 25, maximum is 500.
string
Cursor for cursor-based pagination. When provided, takes precedence over the page parameter.
string
JSON encoded labels to filter sandboxes by. Example: {“label1”: “value1”, “label2”: “value2”}
boolean
Include verbose output in the response
boolean
Include errored and deleted sandboxes in the response

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_LIST_SANDBOXES_PAGINATEDLists all sandboxes with pagination support. Use when you need to retrieve a paginated list of sandboxes for an organization, with optional filtering by name, labels, state, region, CPU/memory/disk specifications, and other attributes. Supports sorting by various fields and ordering results in ascending or descending order. This is a read-only operation that does not modify any resources.

Input Parameters

string
Filter by partial sandbox ID match
string
Filter by partial sandbox name match
integer
Page number of the results (default: 1)
string ("id" | "name" | "state" | "snapshot" | "region" | "updatedAt" | "createdAt" | "lastActivityAt")
Sort field options for listing sandboxes.
integer
Number of results per page (default: 25, max: 500)
string ("asc" | "desc")
Sort order direction.
string
JSON encoded labels to filter by (e.g., ’{“label1”: “value1”}’)
number
Maximum CPU cores
number
Minimum CPU cores
array
List of states to filter by
array
List of regions to filter by
array
List of snapshot names to filter by
number
Maximum disk space in GiB
number
Minimum disk space in GiB
number
Maximum memory in GiB
number
Minimum memory in GiB
string
Include items with last event after this timestamp (ISO 8601)
string
Include items with last event before this timestamp (ISO 8601)
boolean
Include results with errored state and deleted desired state

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_LIST_SHARED_REGIONSTool to list all shared regions. Use when you need to retrieve information about all available shared regions, including their IDs, names, types, and associated URLs (proxy, SSH gateway, snapshot manager). This is a read-only operation that does not modify any resources.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_LIST_SNAPSHOTSLists all snapshots for the organization. Use this action when you need to retrieve information about all available snapshots, including their configuration, state, resource allocations, and usage information. Supports filtering by partial name match and pagination for large result sets. This is a read-only operation that does not modify any resources.

Input Parameters

string
Filter by partial name match. Case-insensitive.
integer
Page number of the results. Defaults to 1 if not specified.
string ("name" | "state" | "lastUsedAt" | "createdAt")
Fields available for sorting snapshots.
integer
Number of results per page. Default is 25, maximum is 500.
string ("asc" | "desc")
Order direction for sorting snapshots.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_LIST_VOLUMESLists all volumes in the organization. Use when you need to retrieve information about all available volumes, including their IDs, names, states, and associated organizations. This is a read-only operation that does not modify any resources. Optionally include deleted volumes by setting the includeDeleted parameter to true.

Input Parameters

boolean
Include deleted volumes in the response

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_REPLACE_IN_FILESReplaces text or patterns in multiple files within a sandbox. Use this action when you need to perform find-and-replace operations across multiple files in a sandbox. For each file specified, the action searches for the given pattern and replaces it with the new value. This action modifies files within the sandbox, so use with caution as changes may be difficult to revert. Consider backing up files before performing bulk replacements.

Input Parameters

array
required
List of file paths to process for replacement
string
required
The text or pattern to search for in the files
string
required
The new value to replace the pattern with
string
required
The unique identifier of the sandbox

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_REPLACE_SANDBOX_LABELSReplaces all labels on a sandbox with a new set of key-value pairs. Use this action when you need to update or redefine the labels associated with an existing sandbox. This operation completely replaces any existing labels — the previous labels will be removed. Note: This action modifies the sandbox’s labels in bulk. If you need to add or remove individual labels while preserving others, consider fetching the current labels first and constructing the complete new set.

Input Parameters

object
required
Key-value pairs of labels to set. This will replace all existing labels on the sandbox
string
required
The ID or name of the sandbox. URL-encode special characters if using a name with special characters

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_RESIZE_PTY_SESSIONResizes an active PTY session with new terminal dimensions. Use this action when you need to change the column and row dimensions of an existing pseudo-terminal (PTY) session within a running sandbox. This is commonly used to adjust the terminal display size to match the current viewport or user preference. The session must be active for this operation to succeed. This action is idempotent - resizing to the same dimensions is safe and will not cause errors. Note: Ensure the PTY session is active before attempting to resize it. Resizing an inactive session may result in errors.

Input Parameters

integer
required
New number of columns (width) for the PTY terminal. Must be between 1 and 1000
integer
required
New number of rows (height) for the PTY terminal. Must be between 1 and 1000
string
required
The ID of the sandbox containing the PTY session
string
required
The unique identifier of the PTY session to resize

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_REVOKE_SSH_ACCESSRevokes SSH access credentials for a sandbox identified by ID or name. Provide a token to revoke that token, or omit it to revoke all SSH access for the sandbox.

Input Parameters

string
SSH access token to revoke. If not provided, all SSH access for the sandbox will be revoked.
string
required
The ID or name of the sandbox to revoke SSH access for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_SEARCH_FILES[DEPRECATED] Search for files inside a sandbox toolbox. Use this action when you need to find files matching a specific pattern within a sandbox toolbox. This is a read-only operation that does not modify any resources. Note: This endpoint is deprecated. It is recommended to use alternative approaches for file search in newer integrations.

Input Parameters

string
required
The directory path to search in
string
required
The search pattern to match files against (e.g., '' for all files, ‘.txt’ for text files)
string
required
The ID of the sandbox to search files in

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_SET_AUTO_ARCHIVE_INTERVALSets the auto-archive interval for a sandbox. Use this action when you need to configure how long a stopped sandbox should be retained before it is automatically archived. The interval specifies the time in minutes after the sandbox stops that the archiving process will begin. Setting interval to 0 uses the maximum interval value. This action modifies the sandbox lifecycle settings and may result in the sandbox being archived if it remains stopped beyond the configured interval.

Input Parameters

integer
required
Auto-archive interval in minutes. Set to 0 to use the maximum interval.
string
required
The ID or name of the sandbox

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_SET_AUTO_DELETE_INTERVALSets the auto-delete interval for a sandbox. Use this action when you need to configure automatic deletion of a sandbox after it is stopped. The interval specifies how many minutes after stopping the sandbox before it gets deleted. Use a negative value to disable auto-delete, or 0 to delete immediately upon stopping. This action modifies the sandbox lifecycle configuration and affects when the sandbox will be permanently removed after being stopped.

Input Parameters

integer
required
Auto-delete interval in minutes. Negative value means disabled, 0 means delete immediately upon stopping
string
required
The ID or name of the sandbox

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_SET_AUTOSTOP_INTERVALSets the auto-stop interval for a sandbox in the Daytona platform. Use this action when you need to configure how long a sandbox should run idle before automatically stopping. This helps manage resources and reduce costs by automatically stopping unused sandboxes. The interval is specified in minutes. Setting the interval to 0 disables auto-stop, allowing the sandbox to run indefinitely until manually stopped. The API returns the updated sandbox object with the new auto_stop_interval value.

Input Parameters

integer
required
Auto-stop interval in minutes. Set to 0 to disable auto-stop, or a positive number to specify the idle timeout in minutes
string
required
The ID or name of the sandbox to configure. URL-encode special characters if using a name with special characters

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_START_COMPUTER_USEStarts VNC desktop processes for a sandbox using the Daytona public toolbox proxy and returns their statuses. This endpoint is deprecated.

Input Parameters

string
required
The ID of the sandbox to start computer use processes for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_START_LSP_SERVERStarts an LSP server process inside a sandbox project. Use this action when you need to initialize an LSP (Language Server Protocol) server within a running sandbox. This enables intelligent code editing features such as auto-completion, error highlighting, and code navigation for the specified programming language and project path. Note: This endpoint is deprecated. Consider alternative approaches for LSP functionality in new implementations. This action requires the sandbox to be in a running state.

Input Parameters

string
required
The unique identifier of the sandbox
string
required
The language identifier for the LSP server (e.g., typescript, python, go)
string
required
The path to the project directory within the sandbox

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_START_PROCESSRestarts a specific VNC process within a sandbox in the Daytona platform. Use this action when you need to restart a VNC process (such as xfce4) within a running sandbox. This is helpful when a desktop session becomes frozen or unresponsive. The process will be terminated and started again, which can help recover a stuck interface. Note: This endpoint is deprecated. Consider alternative approaches if available. This action is generally safe as it restarts rather than removes the process, but the sandbox should be in a running state for this operation to succeed.

Input Parameters

string
required
The unique identifier of the sandbox
string
required
The name of the VNC process to restart

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_START_SANDBOXStarts a sandbox in the Daytona platform. Use this action when you need to start a sandbox that is stopped or archived, making it ready for use. The sandbox will transition to a running state and be accessible for operations. This action can also be used to restore a sandbox from an archived state.

Input Parameters

string
required
The ID or name of the sandbox to start

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_STOP_LSP_SERVERStops an LSP server process inside a sandbox project. Use this action when you need to stop an LSP (Language Server Protocol) server that is running inside a Daytona sandbox. This is useful for freeing up resources, restarting a stuck language server, or cleaning up when LSP features are no longer needed. Note: This endpoint is deprecated. Consider alternative approaches for LSP functionality in new implementations. This action requires the sandbox to be in a running state.

Input Parameters

string
required
The unique identifier of the sandbox
string
required
The language identifier for the LSP server (e.g., typescript, python, go)
string
required
The path to the project directory within the sandbox

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_STOP_SANDBOXStops a running sandbox by ID or name, with an optional force stop using SIGKILL instead of SIGTERM. A stopped sandbox may be restarted, but its auto-delete configuration can cause deletion upon stopping.

Input Parameters

boolean
Force stop the sandbox using SIGKILL instead of SIGTERM. Use this when the sandbox does not respond to normal termination signals
string
required
The ID or name of the sandbox to stop. URL-encode special characters if using a name with special characters

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_TAKE_COMPRESSED_SCREENSHOTTakes a compressed screenshot of the entire screen in a sandbox. Use this action when you need to capture the current visual state of a sandbox’s display with compression. The response includes base64-encoded image data that can be decoded to view the screenshot. Compression options include format selection (PNG or JPEG), quality settings for JPEG, and scale factor to reduce image dimensions. This is useful for monitoring sandbox activity, debugging visual issues, or capturing screen states with minimal data transfer. This is a read-only operation that does not modify any resources.

Input Parameters

number
Scale factor for the screenshot (0.1-1.0). Lower values produce smaller images
string
Image format for the screenshot - either ‘png’ or ‘jpeg’
integer
JPEG quality for the screenshot (1-100). Only applies when format is ‘jpeg’
string
required
The ID of the sandbox where the screenshot should be taken
boolean
Whether to show cursor in the screenshot

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_UPDATE_EXPERIMENTAL_CONFIGUpdates an organization’s experimental configuration, such as OpenTelemetry settings. The organization ID must be present in the authentication headers.

Input Parameters

object
OpenTelemetry collector configuration.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_UPDATE_LAST_ACTIVITYUpdates the last activity timestamp for a sandbox in the Daytona platform. Use this action when you need to keep a sandbox active by recording activity. This is useful for preventing auto-stop mechanisms from stopping sandboxes that are still in use. The action makes a POST request to update the sandbox’s last activity timestamp.

Input Parameters

string
required
The ID of the sandbox to update last activity for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_UPDATE_ORGANIZATION_INVITATIONUpdates an organization invitation with new role and permissions. Use when you need to modify an existing organization invitation’s role (owner or member) or assigned role permissions. This action allows administrators to update invitation settings after the invitation has been created. This is useful for changing a user’s role within an organization or updating the permissions assigned to an invitation.

Input Parameters

string
required
Organization member role
string
Expiration date of the invitation in ISO 8601 format
string
required
The ID of the invitation to update
string
required
The ID of the organization
array
required
Array of role IDs to assign

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_UPDATE_ORGANIZATION_OTEL_CONFIGUpdates an organization’s OpenTelemetry configuration, including its collector endpoint and optional custom headers. The action returns a success indicator when the response body is empty.

Input Parameters

object
Custom headers to include with OTLP requests (e.g., API keys)
string
required
The OpenTelemetry collector endpoint URL
string
required
The unique identifier of the organization

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_UPDATE_ORGANIZATION_ROLEUpdates an organization role with a new name, description, and permissions. Use this action when you need to modify an existing role within an organization, such as changing what the role is called, updating its description, or changing which permissions the role grants. This action is idempotent — calling it multiple times with the same parameters will produce the same result without side effects.

Input Parameters

string
required
The new name for the role
string
required
The unique identifier of the role to update
string
required
The description of the role
array
required
The list of permissions to assign to the role
string
required
The unique identifier of the organization

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_UPDATE_PUBLIC_STATUSUpdates the public visibility status of a sandbox in the Daytona platform. Use this action when you need to change whether a sandbox can be accessed publicly via its HTTP preview. Setting a sandbox to public makes it accessible to anyone with the link, while setting it to private restricts access to authenticated users within the organization only. The API returns the updated sandbox object with the new public status.

Input Parameters

boolean
required
Whether the sandbox should be public. Set to true to make the sandbox publicly accessible, false to restrict access
string
required
The ID or name of the sandbox. URL-encode special characters if using a name with special characters

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_UPDATE_REGISTRYUpdates a Docker registry configuration by ID. The request requires the registry name, URL, and username, and can also supply a password or project.

Input Parameters

string
required
ID of the docker registry to update
string
required
Registry URL
string
required
Registry name
string
Registry project
string
Registry password
string
required
Registry username

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DAYTONA_UPDATE_SANDBOX_DEFAULT_LIMITED_NETWORK_EGRESSUpdates an organization’s default limited network egress setting for new sandboxes. Enable or disable the default for future sandbox provisioning; existing sandboxes are not affected.

Input Parameters

string
required
The unique identifier of the organization.
boolean
required
Whether to enable limited network egress by default for new sandboxes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not