About Daytona
Daytona is a cloud development environment platform that enables teams to create, manage, and scale isolated sandbox environments. The Daytona API enables programmatic management of sandboxes, snapshots, volumes, and organization resources.What the Daytona integration enables
| Capability | Description |
|---|---|
| Sandbox Management | Create, start, stop, resize, and delete cloud development environments |
| Snapshot Management | Create and manage environment snapshots for reproducible setups |
| Volume Management | Manage persistent storage volumes attached to sandboxes |
| Organization Management | Manage users, roles, and organization settings |
Setting up Daytona API Access
This guide will walk you through setting up API key authentication for Daytona, which is required for integrating with Serval.Step 1: Generate a Daytona API Key
- Log in to the Daytona Dashboard
- Click Create Key
- Enter a descriptive name for the key (e.g., “Serval Integration”)
- Set an appropriate expiration date
- Select the permissions your workflows will need (see recommended scopes below)
- Click Create and copy the generated API key
Available Scopes
| Scope | Description |
|---|---|
write:sandboxes | Create and modify sandboxes |
delete:sandboxes | Delete sandboxes |
write:snapshots | Create and modify snapshots |
delete:snapshots | Delete snapshots |
read:volumes | View volumes |
write:volumes | Create and modify volumes |
delete:volumes | Delete volumes |
read:audit_logs | View audit logs |
write:regions | Create and modify regions |
delete:regions | Delete regions |
Only provide Serval with the scopes that you intend to utilize. You can always update your API key’s scopes later as your workflow needs change.
Step 2: Add the key to Serval
- In Serval, navigate to Applications → Connect new → Daytona → Connect
-
Enter the following information:
Field Description Instance Name A friendly name for this integration (e.g., “Daytona Production”) Server URL Your Daytona server URL including the /apipath (e.g.,https://app.daytona.io/apifor Daytona Cloud, or your self-hosted instance URL)API Key The API key you copied from Daytona - Click Submit to complete the integration
Your Daytona integration is now connected! You can start creating workflows to automate sandbox and environment management.
Troubleshooting
Healthcheck failure
Healthcheck failure
- Verify your API key is properly copied and pasted with no extra characters
- Ensure your Server URL includes the
/apipath (e.g.,https://app.daytona.io/api) - Confirm the API key has not expired
Self-hosted instance connection issues
Self-hosted instance connection issues
- Ensure your server URL includes the
/apipath suffix (e.g.,https://daytona.yourcompany.com/api) - Verify the Daytona server is reachable from the internet
- Check that your API key was created on the correct Daytona instance
Additional Resources
Daytona Documentation
Official Daytona platform documentation
Daytona API Reference
Complete API reference for all Daytona endpoints
Need help? Contact support@serval.com for assistance with your Daytona integration.