What is the Toolbox API?
The Toolbox API is an internal service that:- Runs automatically inside every Daytona sandbox
- Provides RESTful endpoints for sandbox operations
- Enables automation and integration with development tools
- Powers the Daytona SDKs (TypeScript, Python, Ruby, Go)
How It Works
When a Daytona sandbox starts, the Toolbox API server automatically launches and listens on a local port. The API provides authenticated access to sandbox resources through HTTP endpoints organized by functionality:- Process - Execute commands, manage PTY sessions, and shell sessions
- File System - Read, write, search, and manage files and directories
- Git - Clone repositories, manage branches, commit, push, and pull changes
- LSP - Language Server Protocol integration for code intelligence
- Port - Manage and query network ports
- Computer Use - GUI automation capabilities (keyboard, mouse, screenshots)
Authentication
The Toolbox API requires authentication via bearer token:For Internal Use via SDKs
Instead of calling the Toolbox API directly, use the appropriate SDK:- TypeScript/JavaScript:
@daytona/sdk - Python:
daytona-sdk - Ruby:
daytona-sdk - Go:
github.com/daytonaio/daytona/pkg/sdk
- Type-safe interfaces
- Error handling
- Automatic authentication
- Connection management
- Higher-level abstractions
Base URL
The Toolbox API runs onhttp://localhost:<port> inside the sandbox. The port is dynamically assigned and available through the SDK configuration.
API Organization
The API endpoints are organized into logical groups:| Group | Endpoints | Description |
|---|---|---|
| Process | /process/* | Command execution, PTY, and sessions |
| File System | /files/* | File and directory operations |
| Git | /git/* | Version control operations |
| LSP | /lsp/* | Language server integration |
| Port | /port/* | Port management |
| Computer Use | /computeruse/* | GUI automation |
| Info | /version, /work-dir, /user-home-dir | System information |
| Server | /init | Server initialization |
Next Steps
Process API
Execute commands and manage processes
File System API
Manage files and directories
Git API
Version control operations
LSP API
Language server integration