--- canonical_url: "https://docs.composio.dev/toolkits/daytona" markdown_url: "https://docs.composio.dev/toolkits/daytona.md" product: "platform" version: null last_updated: null --- # Daytona Daytona is a development environment management platform that provides cloud-based development workspaces with API access for automation - **Category:** developer tools - **Auth:** API_KEY, OAUTH2 - **Composio-managed OAuth available?** Yes - **Tools:** 114 - **Triggers:** 0 - **Slug:** `DAYTONA` - **Version:** 20260721_00 ## Tools ### Archive Sandbox **Slug:** `DAYTONA_ARCHIVE_SANDBOX` Archives 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxIdOrName` | string | Yes | The unique identifier or name of the sandbox to archive | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Cancel Organization Invitation **Slug:** `DAYTONA_CANCEL_ORGANIZATION_INVITATION` Cancels 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `invitationId` | string | Yes | The ID of the invitation to cancel | | `organizationId` | string | Yes | The ID of the organization that sent the invitation | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Checkout Git Branch **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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `path` | string | Yes | The path to the git repository within the sandbox | | `branch` | string | Yes | The name of the branch to checkout, or the commit hash to checkout | | `sandboxId` | string | Yes | The unique identifier of the sandbox | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Clone Repository **Slug:** `DAYTONA_CLONE_REPOSITORY` Clones 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `url` | string | Yes | The URL of the Git repository to clone | | `path` | string | Yes | The directory path where the repository will be cloned | | `branch` | string | No | The specific branch to clone. If not specified, the default branch will be cloned | | `password` | string | No | Password or access token for authentication if the repository requires it | | `username` | string | No | Username for authentication if the repository requires it (e.g., private repositories) | | `commit_id` | string | No | A specific commit ID to checkout after cloning. If specified with branch, the commit must be on that branch | | `sandboxId` | string | Yes | The ID of the sandbox to clone the repository into | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create API Key **Slug:** `DAYTONA_CREATE_API_KEY` Creates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | The name of the API key | | `expiresAt` | string | No | 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. | | `permissions` | array | Yes | 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Sandbox Backup **Slug:** `DAYTONA_CREATE_BACKUP` Initiates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxIdOrName` | string | Yes | The ID or name of the sandbox to create a backup for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Folder in Sandbox **Slug:** `DAYTONA_CREATE_FOLDER_FILES` Creates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `mode` | string | Yes | Folder permissions in octal format (e.g., '755' for rwxr-xr-x) | | `path` | string | Yes | The path where the folder should be created (e.g., 'my-folder' or 'projects/my-app') | | `sandboxId` | string | Yes | The unique identifier of the sandbox where the folder will be created | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Organization **Slug:** `DAYTONA_CREATE_ORGANIZATION` Creates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | The name of the organization to create | | `defaultRegionId` | string | Yes | The ID of the default region for the organization | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Organization Invitation **Slug:** `DAYTONA_CREATE_ORGANIZATION_INVITATION` Creates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `role` | string ("owner" | "member") | Yes | Organization member role for the invitee (owner or member) | | `email` | string | Yes | Email address of the invitee | | `expiresAt` | string | No | Expiration date of the invitation (ISO 8601 format) | | `organizationId` | string | Yes | The unique identifier of the organization | | `assignedRoleIds` | array | Yes | Array of assigned role IDs for the invitee | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Organization Role **Slug:** `DAYTONA_CREATE_ORGANIZATION_ROLE` Creates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | The name of the role to create | | `description` | string | Yes | A description explaining the purpose and scope of the role | | `permissions` | array | Yes | The list of permissions to assign to this role. Each permission controls access to specific resources and operations. | | `organizationId` | string | Yes | The unique identifier of the organization to create the role in | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Process Session **Slug:** `DAYTONA_CREATE_PROCESS_SESSION` Creates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxId` | string | Yes | The unique identifier of the sandbox | | `sessionId` | string | Yes | The unique identifier for the process session | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create PTY Session **Slug:** `DAYTONA_CREATE_PTY_SESSION` Creates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The unique identifier for the PTY session | | `cwd` | string | No | Starting directory for the PTY session, defaults to the sandbox's working directory | | `cols` | integer | No | Number of terminal columns | | `envs` | object | No | Environment variables for the PTY session | | `rows` | integer | No | Number of terminal rows | | `lazyStart` | boolean | No | Whether to start the PTY session lazily (only start when first client connects) | | `sandboxId` | string | Yes | The unique identifier of the sandbox | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Docker Registry **Slug:** `DAYTONA_CREATE_REGISTRY` Creates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `url` | string | Yes | The URL of the registry. For Docker Hub use 'https://registry.hub.docker.com', for other registries provide the full URL. | | `name` | string | Yes | The name of the registry to create. This should be a descriptive name that identifies the registry. | | `project` | string | No | Optional project name to associate with the registry. If not specified, the registry will be associated with the organization. | | `password` | string | Yes | The password or access token for authenticating with the registry. For security, this field is not returned in responses. | | `username` | string | Yes | The username for authenticating with the registry. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Sandbox **Slug:** `DAYTONA_CREATE_SANDBOX` Creates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `cpu` | integer | No | CPU cores allocated to the sandbox | | `env` | object | No | Environment variables for the sandbox | | `gpu` | integer | No | GPU units allocated to the sandbox | | `disk` | integer | No | Disk space allocated to the sandbox in GB | | `name` | string | No | The name of the sandbox. If not provided, the sandbox ID will be used as the name | | `user` | string | No | The user associated with the project | | `labels` | object | No | Labels for the sandbox | | `memory` | integer | No | Memory allocated to the sandbox in GB | | `public` | boolean | No | Whether the sandbox HTTP preview is publicly accessible | | `target` | string | No | The target (region) where the sandbox will be created | | `gpuType` | array | No | 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. | | `volumes` | array | No | Array of volumes to attach to the sandbox | | `snapshot` | string | No | The ID or name of the snapshot used for the sandbox | | `buildInfo` | object | No | Build information for the sandbox. | | `linkedSandbox` | string | No | 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. | | `networkBlockAll` | boolean | No | Whether to block all network access for the sandbox | | `autoStopInterval` | integer | No | Auto-stop interval in minutes (0 means disabled) | | `networkAllowList` | string | No | Comma-separated list of allowed CIDR network addresses for the sandbox | | `autoDeleteInterval` | integer | No | Auto-delete interval in minutes (negative value means disabled, 0 means delete immediately upon stopping) | | `autoArchiveInterval` | integer | No | Auto-archive interval in minutes (0 means the maximum interval will be used) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Snapshot **Slug:** `DAYTONA_CREATE_SNAPSHOT` Creates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `cpu` | integer | No | CPU cores allocated to the resulting sandbox | | `gpu` | integer | No | GPU units allocated to the resulting sandbox | | `disk` | integer | No | Disk space allocated to the sandbox in GB | | `name` | string | Yes | The name of the snapshot. This is a required field and must be unique within the organization. | | `memory` | integer | No | Memory allocated to the resulting sandbox in GB | | `gpuType` | array | No | Preferred GPU type for the resulting sandbox. | | `regionId` | string | No | ID of the region where the snapshot will be available. Defaults to organization default region if not specified. | | `buildInfo` | object | No | Build information for the snapshot request. | | `imageName` | string | No | The image name of the snapshot (e.g., ubuntu:22.04) | | `entrypoint` | array | No | The entrypoint command for the snapshot | | `sandboxClass` | string ("linux-vm" | "container" | "android" | "windows") | No | Target sandbox class — determines which runners can host the sandbox. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create SSH Access **Slug:** `DAYTONA_CREATE_SSH_ACCESS` Creates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxIdOrName` | string | Yes | The ID or name of the sandbox to create SSH access for | | `expiresInMinutes` | integer | No | Expiration time in minutes for the SSH access. Default is 60 minutes. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Volume **Slug:** `DAYTONA_CREATE_VOLUME` Creates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | The name of the volume to create. This should be a descriptive identifier for the volume. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Deactivate Snapshot **Slug:** `DAYTONA_DEACTIVATE_SNAPSHOT` Deactivates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The ID of the snapshot to deactivate | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete API Key **Slug:** `DAYTONA_DELETE_API_KEY` Deletes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | The name of the API key to delete. URL-encode special characters if needed | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete API Key for User **Slug:** `DAYTONA_DELETE_API_KEY_USER` Deletes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | The name of the API key to delete. URL-encode special characters if needed | | `userId` | string | Yes | The unique identifier of the user whose API key is being deleted | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Sandbox File **Slug:** `DAYTONA_DELETE_FILES` Deletes a file inside a sandbox by its path. Use when you need to permanently remove a file from a sandbox that is no longer needed. This action is irreversible — once a file is deleted, it cannot be recovered. Ensure the file is not needed before proceeding with deletion. Note: This action uses a deprecated API endpoint. Consider migrating to an alternative method for file management when available. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `path` | string | Yes | The path to the file to delete within the sandbox. Must be an absolute path | | `recursive` | boolean | No | If true, delete directories recursively. If false or not specified, only delete files | | `sandboxId` | string | Yes | The ID of the sandbox where the file is located | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Git Branch **Slug:** `DAYTONA_DELETE_GIT_BRANCH` Deletes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | The name of the branch to delete | | `path` | string | Yes | The path to the git repository within the sandbox (e.g., '.' for root) | | `sandboxId` | string | Yes | The ID of the sandbox where the git repository is located | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Organization **Slug:** `DAYTONA_DELETE_ORGANIZATION` Deletes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organizationId` | string | Yes | The unique identifier of the organization to delete | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Organization OTEL Config **Slug:** `DAYTONA_DELETE_ORGANIZATION_OTEL_CONFIG` Deletes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organizationId` | string | Yes | The unique identifier of the organization whose OTEL config should be deleted | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Organization Role **Slug:** `DAYTONA_DELETE_ORGANIZATION_ROLE` Deletes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `roleId` | string | Yes | The unique identifier of the role to delete | | `organizationId` | string | Yes | The unique identifier of the organization | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete PTY Session **Slug:** `DAYTONA_DELETE_PTY_SESSION` Deletes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxId` | string | Yes | The unique identifier of the sandbox containing the PTY session | | `sessionId` | string | Yes | The unique identifier of the PTY session to delete | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Recording **Slug:** `DAYTONA_DELETE_RECORDING` Deletes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The unique identifier of the recording to delete | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Docker Registry **Slug:** `DAYTONA_DELETE_REGISTRY` Deletes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | ID of the docker registry to delete | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Sandbox **Slug:** `DAYTONA_DELETE_SANDBOX` Deletes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxIdOrName` | string | Yes | The ID or name of the sandbox to delete. URL-encode special characters if using a name with special characters | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Session **Slug:** `DAYTONA_DELETE_SESSION` Deletes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxId` | string | Yes | The unique identifier of the sandbox containing the session | | `sessionId` | string | Yes | The unique identifier of the session to delete | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Snapshot **Slug:** `DAYTONA_DELETE_SNAPSHOT` Deletes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The unique identifier of the snapshot to delete | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Volume **Slug:** `DAYTONA_DELETE_VOLUME` Deletes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `volumeId` | string | Yes | The ID of the volume to delete | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Download File (Deprecated) **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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `path` | string | Yes | The file path to download (must be an absolute path within the sandbox) | | `sandboxId` | string | Yes | The ID of the sandbox | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Download Multiple Files **Slug:** `DAYTONA_DOWNLOAD_FILES` Downloads multiple files from a sandbox as a multipart/form-data bundle. Use this action when you need to retrieve multiple files from a sandbox in a single operation. The files are returned as a streamed multipart response where each file is a separate part. This is a read-only operation that does not modify any resources. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `paths` | array | Yes | List of remote file paths to download from the sandbox | | `sandboxId` | string | Yes | The ID of the sandbox to download files from | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Enroll in SMS MFA **Slug:** `DAYTONA_ENROLL_IN_SMS_MFA` Enrolls 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Execute Command **Slug:** `DAYTONA_EXECUTE_COMMAND` Executes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `cwd` | string | No | The current working directory for the command execution | | `envs` | object | No | Environment variables to set for the command execution | | `command` | string | Yes | The command to execute in the sandbox shell | | `timeout` | integer | No | Timeout for the command execution in seconds. Defaults to 10 seconds if not specified | | `sandboxId` | string | Yes | The unique identifier of the sandbox | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Expire Signed Port Preview URL **Slug:** `DAYTONA_EXPIRE_SIGNED_PORT_PREVIEW_URL` Expires 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `port` | integer | Yes | The port number to expire the signed preview URL for | | `token` | string | Yes | The token of the signed preview URL to expire | | `sandboxIdOrName` | string | Yes | The ID or name of the sandbox | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Find In Files (Deprecated) **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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `path` | string | Yes | The directory path to search in (e.g., / or /src) | | `pattern` | string | Yes | The text or regex pattern to search for in files | | `sandboxId` | string | Yes | The ID of the sandbox to search in | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Focus Accessibility Node **Slug:** `DAYTONA_FOCUS_ACCESSIBILITY_NODE` Focuses 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The unique identifier of the accessibility node to focus | | `sandboxId` | string | Yes | The ID of the sandbox where the accessibility node is located | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get API Key **Slug:** `DAYTONA_GET_API_KEY` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | The name of the API key to retrieve | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Available Account Providers **Slug:** `DAYTONA_GET_AVAILABLE_ACCOUNT_PROVIDERS` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Build Logs URL **Slug:** `DAYTONA_GET_BUILD_LOGS_URL` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxIdOrName` | string | Yes | The ID or name of the sandbox to retrieve build logs URL for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Commit History **Slug:** `DAYTONA_GET_COMMIT_HISTORY` Gets commit history from a repository in a sandbox toolbox. Use this action when you need to retrieve the commit history including: - Commit hash - Author name and email - Commit message - Timestamp This is a read-only operation that does not modify any resources. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `path` | string | Yes | The path to the git repository | | `sandboxId` | string | Yes | The ID of the sandbox to get commit history from | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Computer Use Status **Slug:** `DAYTONA_GET_COMPUTER_USE_STATUS` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxId` | string | Yes | The ID of the sandbox to get computer use status for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Daytona Config **Slug:** `DAYTONA_GET_CONFIG` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Display Info **Slug:** `DAYTONA_GET_DISPLAY_INFO` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxId` | string | Yes | The ID of the sandbox to get display info for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Entrypoint Logs **Slug:** `DAYTONA_GET_ENTRYPOINT_LOGS` Retrieves entrypoint logs for a sandbox session. Use this action when you need to fetch the stdout, stderr, and combined output logs from an entrypoint process running within a sandbox. This is useful for debugging process initialization, monitoring entrypoint execution, or retrieving historical entrypoint log information. This is a read-only operation that does not modify any resources. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `follow` | boolean | No | Whether to follow the logs stream in real-time (WebSocket only) | | `sandboxId` | string | Yes | The unique identifier of the sandbox | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get File Info (Deprecated) **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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `path` | string | Yes | The path to the file or directory to get info for | | `sandboxId` | string | Yes | The ID of the sandbox to get file info from | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Git History (Deprecated) **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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `path` | string | Yes | The path to the git repository | | `sandboxId` | string | Yes | The ID of the sandbox to get git history from | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Check Sandbox Access **Slug:** `DAYTONA_GET_HAS_SANDBOX_ACCESS` Checks if the authenticated user has access to a specific sandbox. Use this action when you need to verify whether the current user has permission to access a particular sandbox before performing further operations on it. This is a read-only operation that does not modify any sandbox data. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxId` | string | Yes | The unique identifier of the sandbox to check access for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Daytona Health Status **Slug:** `DAYTONA_GET_HEALTH` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organization **Slug:** `DAYTONA_GET_ORGANIZATION` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | The unique identifier of the organization to retrieve. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organization Audit Logs **Slug:** `DAYTONA_GET_ORGANIZATION_AUDIT_LOGS` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `to` | string | No | End date for filtering audit logs (ISO 8601 format, e.g., 2024-12-31T23:59:59Z). | | `from` | string | No | Start date for filtering audit logs (ISO 8601 format, e.g., 2024-01-01T00:00:00Z). | | `page` | integer | No | Page number for pagination. When nextToken is provided, this parameter is ignored. | | `limit` | integer | No | Number of results per page. Default is 25, maximum is 100. | | `nextToken` | string | No | Token for cursor-based pagination. When provided, takes precedence over the page parameter. | | `organizationId` | string | Yes | The unique identifier of the organization. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organization Invitations Count **Slug:** `DAYTONA_GET_ORGANIZATION_INVITATIONS_COUNT_USER` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organization Usage Overview **Slug:** `DAYTONA_GET_ORGANIZATION_USAGE_OVERVIEW` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organizationId` | string | Yes | The unique identifier of the organization | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Process Status **Slug:** `DAYTONA_GET_PROCESS_STATUS` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxId` | string | Yes | The ID of the sandbox containing the VNC process | | `processName` | string | Yes | The name of the VNC process to check status for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Project Dir (Deprecated) **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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxId` | string | Yes | The ID of the sandbox to get the project directory from | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get PTY Session **Slug:** `DAYTONA_GET_PTY_SESSION` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxId` | string | Yes | The ID of the sandbox containing the PTY session | | `sessionId` | string | Yes | The unique identifier of the PTY session to retrieve | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Push Access **Slug:** `DAYTONA_GET_PUSH_ACCESS` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Docker Registry **Slug:** `DAYTONA_GET_REGISTRY` Retrieves details of a specific Docker registry by its unique identifier. Use this action when you need to fetch information about a particular Docker registry, including its URL, credentials, project association, and type. This is a read-only operation that does not modify any resources. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The unique identifier of the Docker registry to retrieve | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Sandbox **Slug:** `DAYTONA_GET_SANDBOX` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `verbose` | boolean | No | Include verbose output in the response | | `sandboxIdOrName` | string | Yes | The ID or name of the sandbox to retrieve | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Session Command Logs **Slug:** `DAYTONA_GET_SESSION_COMMAND_LOGS` Retrieves logs for a specific command executed within a session. Use this action when you need to fetch the log output of a command that was executed in a sandbox session. The endpoint returns the combined stdout/stderr as plain text. This is useful for debugging command execution failures, reviewing command output, monitoring command performance, or retrieving historical command execution results. This is a read-only operation that does not modify any resources. Note: The follow parameter enables WebSocket-based real-time log streaming. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `follow` | boolean | No | Whether to follow logs in real-time (WebSocket only) | | `commandId` | string | Yes | The unique identifier of the command to retrieve logs for | | `sandboxId` | string | Yes | The unique identifier of the sandbox that owns the session | | `sessionId` | string | Yes | The unique identifier of the session containing the command | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Session (Deprecated) **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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxId` | string | Yes | The ID of the sandbox containing the session | | `sessionId` | string | Yes | The ID of the session to retrieve | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Snapshot **Slug:** `DAYTONA_GET_SNAPSHOT` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The ID or name of the snapshot to retrieve | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Snapshot Build Logs **Slug:** `DAYTONA_GET_SNAPSHOT_BUILD_LOGS` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The unique identifier of the snapshot | | `follow` | boolean | No | Whether to follow the logs stream in real-time | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Toolbox Proxy URL **Slug:** `DAYTONA_GET_TOOLBOX_PROXY_URL` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxIdOrName` | string | Yes | The ID or name of the sandbox | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Transient Push Access **Slug:** `DAYTONA_GET_TRANSIENT_PUSH_ACCESS` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `regionId` | string | No | ID of the region where the snapshot will be available (defaults to organization default region) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Authenticated User **Slug:** `DAYTONA_GET_USER` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get User Home Dir (Deprecated) **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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxId` | string | Yes | The ID of the sandbox | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Volume **Slug:** `DAYTONA_GET_VOLUME` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `volumeId` | string | Yes | The unique identifier of the volume to retrieve | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Windows **Slug:** `DAYTONA_GET_WINDOWS` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxId` | string | Yes | The ID of the sandbox to get windows information for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Working Directory **Slug:** `DAYTONA_GET_WORK_DIR` Gets 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxId` | string | Yes | The ID of the sandbox to get the working directory from | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Work Dir (Deprecated) **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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxId` | string | Yes | The ID of the sandbox | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List API Keys **Slug:** `DAYTONA_LIST_API_KEYS` Lists 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Available Regions **Slug:** `DAYTONA_LIST_AVAILABLE_REGIONS` Lists 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Files (Deprecated) **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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `path` | string | No | The directory path to list files from. Defaults to root directory if not specified. | | `sandboxId` | string | Yes | The ID of the sandbox to list files from | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Git Branches (Deprecated) **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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `path` | string | Yes | The path to the git repository | | `sandboxId` | string | Yes | The ID of the sandbox to list git branches from | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Organization Invitations **Slug:** `DAYTONA_LIST_ORGANIZATION_INVITATIONS` Lists 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organizationId` | string | Yes | The unique identifier of the organization | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Organization Invitations for User **Slug:** `DAYTONA_LIST_ORGANIZATION_INVITATIONS_USER` Lists 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List organization members **Slug:** `DAYTONA_LIST_ORGANIZATION_MEMBERS` Lists 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organizationId` | string | Yes | The unique identifier of the organization | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List organization roles **Slug:** `DAYTONA_LIST_ORGANIZATION_ROLES` Lists 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organizationId` | string | Yes | The unique identifier of the organization | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Organizations **Slug:** `DAYTONA_LIST_ORGANIZATIONS` Lists 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Process Sessions **Slug:** `DAYTONA_LIST_PROCESS_SESSION` Lists 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxId` | string | Yes | The ID of the sandbox to list process sessions for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List PTY Sessions **Slug:** `DAYTONA_LIST_PTY_SESSIONS` Lists 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxId` | string | Yes | The ID of the sandbox to list PTY sessions for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List registries **Slug:** `DAYTONA_LIST_REGISTRIES` Lists 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Sandboxes **Slug:** `DAYTONA_LIST_SANDBOXES` Lists all sandboxes for the organization. Use this action when you need to retrieve information about all available sandboxes, including their configuration, state, labels, and resource quotas. This is a read-only operation that does not modify any resources. Optional filters can be applied to include verbose output, filter by specific labels, or include errored and deleted sandboxes in the results. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `page` | integer | No | Page number for pagination. When cursor is provided, this parameter is ignored. | | `limit` | integer | No | Number of results per page. Default is 25, maximum is 500. | | `cursor` | string | No | Cursor for cursor-based pagination. When provided, takes precedence over the page parameter. | | `labels` | string | No | JSON encoded labels to filter sandboxes by. Example: {"label1": "value1", "label2": "value2"} | | `verbose` | boolean | No | Include verbose output in the response | | `includeErroredDeleted` | boolean | No | Include errored and deleted sandboxes in the response | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Sandboxes Paginated **Slug:** `DAYTONA_LIST_SANDBOXES_PAGINATED` Lists 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | No | Filter by partial sandbox ID match | | `name` | string | No | Filter by partial sandbox name match | | `page` | integer | No | Page number of the results (default: 1) | | `sort` | string ("id" | "name" | "state" | "snapshot" | "region" | "updatedAt" | "createdAt" | "lastActivityAt") | No | Sort field options for listing sandboxes. | | `limit` | integer | No | Number of results per page (default: 25, max: 500) | | `order` | string ("asc" | "desc") | No | Sort order direction. | | `labels` | string | No | JSON encoded labels to filter by (e.g., '{"label1": "value1"}') | | `maxCpu` | number | No | Maximum CPU cores | | `minCpu` | number | No | Minimum CPU cores | | `states` | array | No | List of states to filter by | | `regions` | array | No | List of regions to filter by | | `snapshots` | array | No | List of snapshot names to filter by | | `maxDiskGiB` | number | No | Maximum disk space in GiB | | `minDiskGiB` | number | No | Minimum disk space in GiB | | `maxMemoryGiB` | number | No | Maximum memory in GiB | | `minMemoryGiB` | number | No | Minimum memory in GiB | | `lastEventAfter` | string | No | Include items with last event after this timestamp (ISO 8601) | | `lastEventBefore` | string | No | Include items with last event before this timestamp (ISO 8601) | | `includeErroredDeleted` | boolean | No | Include results with errored state and deleted desired state | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List shared regions **Slug:** `DAYTONA_LIST_SHARED_REGIONS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Snapshots **Slug:** `DAYTONA_LIST_SNAPSHOTS` Lists 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | No | Filter by partial name match. Case-insensitive. | | `page` | integer | No | Page number of the results. Defaults to 1 if not specified. | | `sort` | string ("name" | "state" | "lastUsedAt" | "createdAt") | No | Fields available for sorting snapshots. | | `limit` | integer | No | Number of results per page. Default is 25, maximum is 500. | | `order` | string ("asc" | "desc") | No | Order direction for sorting snapshots. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Volumes **Slug:** `DAYTONA_LIST_VOLUMES` Lists 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `includeDeleted` | boolean | No | Include deleted volumes in the response | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Replace In Files **Slug:** `DAYTONA_REPLACE_IN_FILES` Replaces 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `files` | array | Yes | List of file paths to process for replacement | | `pattern` | string | Yes | The text or pattern to search for in the files | | `newValue` | string | Yes | The new value to replace the pattern with | | `sandboxId` | string | Yes | The unique identifier of the sandbox | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Replace Sandbox Labels **Slug:** `DAYTONA_REPLACE_SANDBOX_LABELS` Replaces 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `labels` | object | Yes | Key-value pairs of labels to set. This will replace all existing labels on the sandbox | | `sandboxIdOrName` | string | Yes | The ID or name of the sandbox. URL-encode special characters if using a name with special characters | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Resize PTY Session **Slug:** `DAYTONA_RESIZE_PTY_SESSION` Resizes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `cols` | integer | Yes | New number of columns (width) for the PTY terminal. Must be between 1 and 1000 | | `rows` | integer | Yes | New number of rows (height) for the PTY terminal. Must be between 1 and 1000 | | `sandboxId` | string | Yes | The ID of the sandbox containing the PTY session | | `sessionId` | string | Yes | The unique identifier of the PTY session to resize | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Revoke SSH Access **Slug:** `DAYTONA_REVOKE_SSH_ACCESS` Revokes SSH access credentials for a sandbox environment. Use this action when you need to invalidate SSH access to a sandbox, either for a specific token or all SSH access. This is useful for security purposes when you need to immediately terminate SSH sessions or prevent further SSH connections to the sandbox. This action is irreversible — once SSH access is revoked, the tokens cannot be recovered. New SSH access must be created using the Create SSH Access action if needed. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `token` | string | No | SSH access token to revoke. If not provided, all SSH access for the sandbox will be revoked. | | `sandboxIdOrName` | string | Yes | The ID or name of the sandbox to revoke SSH access for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Search Files **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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `path` | string | Yes | The directory path to search in | | `pattern` | string | Yes | The search pattern to match files against (e.g., '*' for all files, '*.txt' for text files) | | `sandboxId` | string | Yes | The ID of the sandbox to search files in | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Set Sandbox Auto Archive Interval **Slug:** `DAYTONA_SET_AUTO_ARCHIVE_INTERVAL` Sets 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `interval` | integer | Yes | Auto-archive interval in minutes. Set to 0 to use the maximum interval. | | `sandboxIdOrName` | string | Yes | The ID or name of the sandbox | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Set Auto Delete Interval **Slug:** `DAYTONA_SET_AUTO_DELETE_INTERVAL` Sets 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `interval` | integer | Yes | Auto-delete interval in minutes. Negative value means disabled, 0 means delete immediately upon stopping | | `sandboxIdOrName` | string | Yes | The ID or name of the sandbox | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Set Autostop Interval **Slug:** `DAYTONA_SET_AUTOSTOP_INTERVAL` Sets 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `interval` | integer | Yes | Auto-stop interval in minutes. Set to 0 to disable auto-stop, or a positive number to specify the idle timeout in minutes | | `sandboxIdOrName` | string | Yes | The ID or name of the sandbox to configure. URL-encode special characters if using a name with special characters | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Start Computer Use **Slug:** `DAYTONA_START_COMPUTER_USE` Starts all VNC desktop processes (Xvfb, xfce4, x11vnc, novnc) for a sandbox. Use this action when you need to start all VNC desktop processes for a sandbox to enable remote desktop access. This action starts the X virtual framebuffer (Xvfb), Xfce desktop environment, x11vnc server, and noVNC web interface. Each process will have a status indicating whether it started successfully. Note: This endpoint is deprecated. Consider using alternative methods for starting computer use processes in new implementations. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxId` | string | Yes | The ID of the sandbox to start computer use processes for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Start LSP Server **Slug:** `DAYTONA_START_LSP_SERVER` Starts 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxId` | string | Yes | The unique identifier of the sandbox | | `languageId` | string | Yes | The language identifier for the LSP server (e.g., typescript, python, go) | | `pathToProject` | string | Yes | The path to the project directory within the sandbox | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Start VNC Process **Slug:** `DAYTONA_START_PROCESS` Restarts 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxId` | string | Yes | The unique identifier of the sandbox | | `processName` | string | Yes | The name of the VNC process to restart | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Start Sandbox **Slug:** `DAYTONA_START_SANDBOX` Starts 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxIdOrName` | string | Yes | The ID or name of the sandbox to start | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Stop LSP Server **Slug:** `DAYTONA_STOP_LSP_SERVER` Stops 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxId` | string | Yes | The unique identifier of the sandbox | | `languageId` | string | Yes | The language identifier for the LSP server (e.g., typescript, python, go) | | `pathToProject` | string | Yes | The path to the project directory within the sandbox | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Stop Sandbox **Slug:** `DAYTONA_STOP_SANDBOX` Stops a running sandbox in the Daytona platform. Use this action when you need to gracefully stop a running sandbox that is no longer needed or should be temporarily shut down. The sandbox can be restarted later if needed. Note: If the sandbox does not respond to normal termination signals (SIGTERM), you can use the `force` parameter to forcibly terminate it (SIGKILL). This action is reversible — the sandbox can be restarted after being stopped. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `force` | boolean | No | Force stop the sandbox using SIGKILL instead of SIGTERM. Use this when the sandbox does not respond to normal termination signals | | `sandboxIdOrName` | string | Yes | The ID or name of the sandbox to stop. URL-encode special characters if using a name with special characters | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Take Compressed Screenshot **Slug:** `DAYTONA_TAKE_COMPRESSED_SCREENSHOT` Takes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `scale` | number | No | Scale factor for the screenshot (0.1-1.0). Lower values produce smaller images | | `format` | string | No | Image format for the screenshot - either 'png' or 'jpeg' | | `quality` | integer | No | JPEG quality for the screenshot (1-100). Only applies when format is 'jpeg' | | `sandboxId` | string | Yes | The ID of the sandbox where the screenshot should be taken | | `showCursor` | boolean | No | Whether to show cursor in the screenshot | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Unlink Account **Slug:** `DAYTONA_UNLINK_ACCOUNT` Unlinks a connected provider account (such as GitHub, GitLab, or Bitbucket) from the authenticated user's Daytona profile. Use when a user wants to remove a connected account or revoke its integration with Daytona. This action is irreversible — once an account is unlinked, it cannot be automatically reconnected without going through the OAuth flow again. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `provider` | string | Yes | The name of the provider to unlink (e.g., 'github', 'gitlab', 'bitbucket') | | `providerUserId` | string | Yes | The user ID on the provider side (e.g., the GitHub user ID) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Experimental Config **Slug:** `DAYTONA_UPDATE_EXPERIMENTAL_CONFIG` Updates experimental configuration for an organization on the Daytona platform. Use this action when you need to configure experimental features such as OpenTelemetry settings for observability. The organization ID is automatically injected from the authentication context, so only the configuration object needs to be provided. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `otel` | object | No | OpenTelemetry collector configuration. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Last Activity **Slug:** `DAYTONA_UPDATE_LAST_ACTIVITY` Updates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sandboxId` | string | Yes | The ID of the sandbox to update last activity for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Organization Invitation **Slug:** `DAYTONA_UPDATE_ORGANIZATION_INVITATION` Updates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `role` | string | Yes | Organization member role | | `expiresAt` | string | No | Expiration date of the invitation in ISO 8601 format | | `invitationId` | string | Yes | The ID of the invitation to update | | `organizationId` | string | Yes | The ID of the organization | | `assignedRoleIds` | array | Yes | Array of role IDs to assign | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Organization OpenTelemetry Config **Slug:** `DAYTONA_UPDATE_ORGANIZATION_OTEL_CONFIG` Updates the OpenTelemetry configuration for an organization. Use this action when you need to configure or update the OTLP endpoint and custom headers for an organization's OpenTelemetry setup. This allows you to specify where telemetry data should be sent and any authentication headers required for the collector. Note: This action returns HTTP 204 on success with no response body. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `headers` | object | No | Custom headers to include with OTLP requests (e.g., API keys) | | `endpoint` | string | Yes | The OpenTelemetry collector endpoint URL | | `organizationId` | string | Yes | The unique identifier of the organization | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Organization Role **Slug:** `DAYTONA_UPDATE_ORGANIZATION_ROLE` Updates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | The new name for the role | | `roleId` | string | Yes | The unique identifier of the role to update | | `description` | string | Yes | The description of the role | | `permissions` | array | Yes | The list of permissions to assign to the role | | `organizationId` | string | Yes | The unique identifier of the organization | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Public Status **Slug:** `DAYTONA_UPDATE_PUBLIC_STATUS` Updates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `isPublic` | boolean | Yes | Whether the sandbox should be public. Set to true to make the sandbox publicly accessible, false to restrict access | | `sandboxIdOrName` | string | Yes | The ID or name of the sandbox. URL-encode special characters if using a name with special characters | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Docker Registry **Slug:** `DAYTONA_UPDATE_REGISTRY` Updates a Docker registry configuration. Use this action when you need to modify the settings of an existing Docker registry, such as updating the registry name, URL, or credentials. This is a modification operation that updates the registry's configuration on the Daytona platform. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | ID of the docker registry to update | | `url` | string | Yes | Registry URL | | `name` | string | Yes | Registry name | | `project` | string | No | Registry project | | `password` | string | No | Registry password | | `username` | string | Yes | Registry username | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Sandbox Default Limited Network Egress **Slug:** `DAYTONA_UPDATE_SANDBOX_DEFAULT_LIMITED_NETWORK_EGRESS` Updates the sandbox default limited network egress setting for an organization. Use this action when you need to configure whether new sandboxes should have limited network egress enabled by default within a specific organization. This action modifies organization-level settings and may affect how new sandboxes are provisioned. Existing sandboxes are not affected by this change. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organizationId` | string | Yes | The unique identifier of the organization. | | `sandboxDefaultLimitedNetworkEgress` | boolean | Yes | Whether to enable limited network egress by default for new sandboxes. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not |