Skip to main content
Novita Agent Sandbox has released a new SDK / CLI version and updated the default cluster used by the official documentation starting June 8, 2026 UTC. Released versions:
  • Python SDK: 2.0.1
  • TypeScript SDK: 2.0.0
  • CLI: 2.0.0
The latest SDK / CLI will use the new Sandbox cluster by default when no domain is explicitly configured: https://us-phx-1.sandbox.novita.ai The new SDK / CLI is not fully compatible with older versions. If you are using Sandbox in production, please avoid automatic upgrades and complete compatibility checks before upgrading. The legacy Sandbox endpoint remains available for existing users: https://sandbox.novita.ai

​
If you do not plan to upgrade for now

To avoid unexpected impact on your existing Sandbox workloads, we recommend that you:
  1. Pin your current SDK / CLI version.
  2. Avoid automatic dependency upgrades.
  3. Explicitly configure the current Sandbox domain through the SDK / CLI configuration or by setting the NOVITA_DOMAIN environment variable. For SDK / CLI domain configuration, use sandbox.novita.ai.
  4. Review any production automation scripts that depend on SDK / CLI behavior, and avoid switching to the new version before completing compatibility validation.

​
If you plan to upgrade

Before upgrading production workloads, we recommend that you:
  1. Test in a staging environment first.
  2. Add the new Sandbox cluster endpoint to your firewall, proxy, CORS, or enterprise gateway allowlist if applicable: https://us-phx-1.sandbox.novita.ai.
  3. For SDK / CLI domain configuration, use us-phx-1.sandbox.novita.ai.
  4. Review resource, API, CLI, network, and runtime compatibility.
  5. Check whether your integration depends on sandboxes, paused sandboxes, templates, snapshots, or commit artifacts from the legacy cluster. Resources are not shared across the legacy and new clusters, so some resources may need to be rebuilt or migrated.
If needed, our team can help review your current integration and provide upgrade guidance.