Manage your model’s release cycles with environments.
Environments provide structured management for deployments, ensuring controlled rollouts, stable endpoints, and autoscaling. They help teams stage, test, and release models without affecting production traffic.Deployments can be promoted to an environment (e.g., “staging”) to validate outputs before moving to production, allowing for safer model iteration and evaluation.
In addition to the standard production environment, you can create as many custom environments as needed. There are two ways to create a custom environment:
In the model management page on the Baseten dashboard.
To ensure the environment variable remains updated, enable** “Re-deploy when promoting” **in the UI or via the REST API. This guarantees the environment is fully initialized after a promotion.
Environments can be deleted, except for production. To remove a production deployment, first promote another deployment to production or delete the entire model.
Deleted environments are removed from the overview but remain in billing history.
They do not consume resources after deletion.
API requests to a deleted environment return a 404 error.
Deletion is permanent - consider deactivation instead.