Sandbox lifecycle configuration
You can now configure sandbox lifecycle behavior directly when creating a sandbox. The newlifecycle option lets you control what happens when a sandbox times out — either kill (default) or pause — and whether the sandbox should automatically resume on incoming traffic.This replaces the previous beta pause API with a cleaner, more flexible approach. Learn more in the AutoResume docs.CLI: sandbox info command
The CLI now includes a sandbox info command that displays detailed information about a sandbox, including its state, template, CPU/memory configuration, network rules, and lifecycle settings. Supports both human-readable and JSON output.CLI: sandbox pause and sandbox resume commands
You can now pause and resume sandboxes directly from the CLI:Expanded sandbox info API
The SDKgetInfo() / get_info() methods now return additional fields: lifecycle configuration, network rules, and allowInternetAccess. This gives you full visibility into a sandbox’s configuration without needing to track it separately.Template tags API
A newgetTags() / get_tags() method lets you list all tags for a template, returning each tag’s name, associated build ID, and creation timestamp. Useful for managing versioned deployments. See the tags docs.fixMissing option for template aptInstall
The template builder’s aptInstall() / apt_install() method now accepts a fixMissing / fix_missing option, which passes --fix-missing to apt-get install. This helps resolve broken package states during template builds.Updates
- Improved auto-resume reliability — Auto-resume now correctly handles sandboxes that are mid-transition (pausing or snapshotting), preventing transient 502 errors when traffic arrives during state changes.
- Better error types in SDKs — The SDKs now distinguish between “sandbox not found” and “file not found” errors with dedicated
SandboxNotFoundandFileNotFounderror types, making it easier to handle each case in your code. - Connection config propagation fix — Instance-level connection config (API key, domain, headers) is now correctly forwarded to all SDK methods including
pauseandconnect.
Bug fixes
- Dotfiles included in template uploads — Template file uploads now correctly include dotfiles (e.g.,
.env,.gitignore) that were previously skipped. - CLI
sandbox listpagination — Fixed an issue wheresandbox listcould fetch all sandboxes regardless of the specified limit. The command now defaults to 1,000 results and respects the--limitflag. - CLI
sandbox logstimeout — Fixed a bug wheresandbox logswithout--followcould hang due to unnecessary status polling. - CLI error handling — The CLI no longer crashes when the API returns non-standard HTTP status codes.
- Python SDK stream timeout — Improved timeout handling for streaming requests to prevent hanging connections.