Management API reference

Manage models, deployments, environments, and workspace resources over HTTP. For Python, TypeScript, and Go clients, see Management SDKs. Use the Management API OpenAPI specification to generate API clients or inspect request and response schemas.

Resources

Manage models, Chains, and deployments.
Configure environments and environment group restrictions.
Create and update library listings and versions.
Look up teams and users, and manage API keys.
Manage sandboxes and images.
Manage volumes and secrets, and retrieve blob credentials.
Inspect usage and activity with billing and audit logs.

Authentication

Send your Baseten API key as a bearer token:

Authorization: Bearer $BASETEN_API_KEY

Create and manage API keys from your workspace settings.

Starting October 28, 2026, the Management API and Frontier Gateway management API return 401 Unauthorized instead of 403 Forbidden for requests with missing, invalid, or expired credentials. This includes invalid or revoked API keys and expired authentication tokens.Before the rollout, update clients, monitoring, and automation that check for 403 to detect authentication failures. Handle 401 responses for these failures. Requests with valid credentials but insufficient permissions continue to return 403 Forbidden.

Rate limits

Baseten tracks Management API usage separately for each API key and endpoint. Limits vary by endpoint, and custom limits for your organization take precedence over the defaults. Handle 429 responses by waiting at least the number of seconds in retry_after before retrying. See Rate limits for endpoint limits and a retry example.

Guides

Loops API: Manage sessions, runs, samplers, checkpoints, and deployments.
Training API: Manage training projects and jobs.
Frontier Gateway API: Manage endpoints, groups, and federated API keys.

Endpoints

Endpoint pages identify experimental APIs.

Models

Method	Endpoint	Description
`GET`	`/v1/models`	Gets all models.
`GET`	`/v1/teams/{team_id}/models`	Gets all models.
`GET`	`/v1/models/{model_id}`	Gets a model by ID.
`PATCH`	`/v1/models/{model_id}`	Updates a model by ID.
`POST`	`/v1/prepare_model_upload`	Validates a model push payload and issues upload credentials.
`POST`	`/v1/models`	Creates a new model from a source.
`POST`	`/v1/teams/{team_id}/models`	Creates a new model from a source.
`POST`	`/v1/llm_models`	Creates a new BIS-LLM deployment.
`POST`	`/v1/teams/{team_id}/llm_models`	Creates a new BIS-LLM deployment.
`DELETE`	`/v1/models/{model_id}`	Deletes a model by ID.

Chains

Method	Endpoint	Description
`GET`	`/v1/chains`	Gets all chains.
`GET`	`/v1/chains/{chain_id}`	Gets a chain by ID.
`GET`	`/v1/chains/{chain_id}/deployments/{chain_deployment_id}/chainlets/{chainlet_id}/logs`	Gets the logs for a chainlet within a chain deployment.
`DELETE`	`/v1/chains/{chain_id}`	Deletes a chain by ID.

Deployments

Method	Endpoint	Description
`GET`	`/v1/models/{model_id}/deployments`	Gets all deployments of a model.
`GET`	`/v1/models/{model_id}/deployments/production`	Gets a model’s production deployment.
`GET`	`/v1/models/{model_id}/deployments/development`	Gets a model’s development deployment.
`GET`	`/v1/models/{model_id}/deployments/{deployment_id}`	Gets a model’s deployment by ID.
`GET`	`/v1/models/{model_id}/deployments/{deployment_id}/logs`	Gets the logs for a model deployment.
`GET`	`/v1/models/{model_id}/deployments/{deployment_id}/metrics`	Gets the metrics for a model deployment.
`GET`	`/v1/models/{model_id}/deployments/{deployment_id}/startups`	Lists the replica startups for a model deployment.
`GET`	`/v1/models/{model_id}/deployments/{deployment_id}/startups/summary`	Gets startup duration distributions for a model deployment.
`GET`	`/v1/models/{model_id}/deployments/{deployment_id}/config`	Gets a deployment’s config.
`GET`	`/v1/models/{model_id}/deployments/{deployment_id}/download`	Gets a presigned download URL for a deployment’s truss.
`GET`	`/v1/chains/{chain_id}/deployments`	Gets all chain deployments.
`GET`	`/v1/chains/{chain_id}/deployments/{chain_deployment_id}`	Gets a chain deployment by ID.
`GET`	`/v1/models/{model_id}/deployments/{deployment_id}/patches/state`	Gets a development deployment’s patch state.
`POST`	`/v1/models/{model_id}/deployments`	Adds a new deployment to a model.
`POST`	`/v1/llm_models/{model_id}/deployments`	Creates a new BIS-LLM deployment version.
`POST`	`/v1/models/{model_id}/deployments/{deployment_id}/patches`	Stages a patch against a development deployment.
`POST`	`/v1/models/{model_id}/deployments/{deployment_id}/patches/sync`	Syncs staged patches to a development deployment.
`POST`	`/v1/models/{model_id}/deployments/{deployment_id}/ssh/sign`	Signs an SSH certificate for an inference model.
`PATCH`	`/v1/models/{model_id}/deployments/{deployment_id}`	Updates a model’s deployment by ID.
`DELETE`	`/v1/models/{model_id}/deployments/{deployment_id}`	Deletes a model’s deployment by ID.
`DELETE`	`/v1/chains/{chain_id}/deployments/{chain_deployment_id}`	Deletes a chain deployment by ID.
`DELETE`	`/v1/models/{model_id}/deployments/{deployment_id}/replicas/{replica_id}`	Terminates a replica in a deployment.
`POST`	`/v1/models/{model_id}/environments/{env_name}/activate`	Activates a deployment associated with an environment.
`POST`	`/v1/models/{model_id}/deployments/development/activate`	Activates a development deployment.
`POST`	`/v1/models/{model_id}/deployments/{deployment_id}/activate`	Activates a deployment.
`POST`	`/v1/models/{model_id}/deployments/production/activate`	Activates a production deployment.
`POST`	`/v1/models/{model_id}/environments/{env_name}/deactivate`	Deactivates a deployment associated with an environment.
`POST`	`/v1/models/{model_id}/deployments/development/deactivate`	Deactivates a development deployment.
`POST`	`/v1/models/{model_id}/deployments/{deployment_id}/deactivate`	Deactivates a deployment.
`POST`	`/v1/models/{model_id}/deployments/production/deactivate`	Deactivates a production deployment.
`POST`	`/v1/chains/{chain_id}/deployments/{chain_deployment_id}/deactivate`	Deactivates a chain deployment.
`POST`	`/v1/models/{model_id}/deployments/development/retry`	Retries a failed development deployment.
`POST`	`/v1/models/{model_id}/deployments/{deployment_id}/retry`	Retries a failed deployment.
`POST`	`/v1/models/{model_id}/deployments/production/retry`	Retries a failed production deployment.
`POST`	`/v1/models/{model_id}/environments/{env_name}/promote`	Promotes a deployment to an environment.
`POST`	`/v1/models/{model_id}/environments/{env_name}/cancel_promotion`	Cancels a promotion to an environment.
`POST`	`/v1/models/{model_id}/deployments/development/promote`	Promotes a development deployment to production.
`POST`	`/v1/models/{model_id}/deployments/{deployment_id}/promote`	Promotes a deployment to production.
`POST`	`/v1/models/{model_id}/environments/{env_name}/pause_promotion`	Pauses a rolling promotion.
`POST`	`/v1/models/{model_id}/environments/{env_name}/resume_promotion`	Resumes a paused rolling promotion.
`POST`	`/v1/models/{model_id}/environments/{env_name}/force_cancel_promotion`	Force cancels a rolling promotion.
`POST`	`/v1/models/{model_id}/environments/{env_name}/force_roll_forward_promotion`	Force rolls forward a rolling promotion.
`POST`	`/v1/chains/{chain_id}/environments/{env_name}/promote`	Promotes a chain deployment to an environment.
`PATCH`	`/v1/models/{model_id}/deployments/development/autoscaling_settings`	Updates a development deployment’s autoscaling settings.
`PATCH`	`/v1/models/{model_id}/deployments/{deployment_id}/autoscaling_settings`	Updates a deployment’s autoscaling settings.
`PATCH`	`/v1/models/{model_id}/deployments/production/autoscaling_settings`	Updates a production deployment’s autoscaling settings.
`PATCH`	`/v1/models/{model_id}/deployments/{deployment_id}/request_backpressure_settings`	Updates a deployment’s request backpressure settings.

Environments

Method	Endpoint	Description
`GET`	`/v1/models/{model_id}/environments`	Gets all environments.
`GET`	`/v1/models/{model_id}/environments/{env_name}`	Gets an environment’s details.
`GET`	`/v1/models/{model_id}/environments/{env_name}/logs`	Gets the logs for a model environment.
`GET`	`/v1/models/{model_id}/environments/{env_name}/metrics`	Gets the metrics for a model environment.
`GET`	`/v1/models/{model_id}/environments/{env_name}/startups`	Lists replica startups across deployments in an environment.
`GET`	`/v1/models/{model_id}/environments/{env_name}/startups/summary`	Gets startup duration distributions across deployments in an environment.
`GET`	`/v1/chains/{chain_id}/environments`	Gets all chain environments.
`GET`	`/v1/chains/{chain_id}/environments/{env_name}`	Gets a chain environment’s details.
`POST`	`/v1/models/{model_id}/environments`	Creates an environment.
`POST`	`/v1/chains/{chain_id}/environments`	Creates a chain environment.
`PATCH`	`/v1/models/{model_id}/environments/{env_name}`	Updates an environment’s settings.
`PATCH`	`/v1/chains/{chain_id}/environments/{env_name}`	Updates a chain environment’s settings.
`PATCH`	`/v1/chains/{chain_id}/environments/{env_name}/chainlet_settings/autoscaling_settings`	Updates a chainlet environment’s autoscaling settings.
`POST`	`/v1/chains/{chain_id}/environments/{env_name}/chainlet_settings/instance_types/update`	Updates a chainlet environment’s instance type settings.
`DELETE`	`/v1/models/{model_id}/environments/{env_name}`	Deletes an environment.

Environment groups

Method	Endpoint	Description
`GET`	`/v1/environment_groups`	Lists environment groups.
`GET`	`/v1/environment_groups/{env_name}`	Gets an environment group by name.
`PATCH`	`/v1/environment_groups/{env_name}`	Updates an environment group’s restriction settings.
`GET`	`/v1/teams/{team_id}/environment_groups`	Lists environment groups.
`GET`	`/v1/teams/{team_id}/environment_groups/{env_name}`	Gets an environment group by name.
`PATCH`	`/v1/teams/{team_id}/environment_groups/{env_name}`	Updates an environment group’s restriction settings.

Training capacity

Method	Endpoint	Description
`GET`	`/v1/training/capacity`	Gets training GPU capacity.
`PATCH`	`/v1/training/capacity`	Sets a team’s training GPU capacity.

Instance types

Method	Endpoint	Description
`GET`	`/v1/instance_types`	Gets all available instance types.
`GET`	`/v1/instance_type_prices`	Gets prices for available instance types.

Regions

Method	Endpoint	Description
`GET`	`/v1/regions`	Lists regions available to the organization.
`GET`	`/v1/teams/{team_id}/regions`	Lists regions available to a team.

Model APIs

Method	Endpoint	Description
`GET`	`/v1/model_apis`	Lists Model APIs.
`GET`	`/v1/model_apis/{model_api_name}`	Gets a Model API.
`GET`	`/v1/model_apis/usage`	Gets Model APIs token usage in time buckets.

Library listings

Method	Endpoint	Description
`GET`	`/v1/library_listings`	Gets all library listings.
`POST`	`/v1/library_listings`	Creates a new library listing.
`GET`	`/v1/library_listings/{user_defined_listing_id}`	Gets a library listing.
`PATCH`	`/v1/library_listings/{user_defined_listing_id}`	Updates a library listing.
`DELETE`	`/v1/library_listings/{user_defined_listing_id}`	Deletes a library listing.
`GET`	`/v1/library_listings/{user_defined_listing_id}/versions`	Gets all versions for a library listing.
`POST`	`/v1/library_listings/{user_defined_listing_id}/versions`	Creates a new library listing version.
`GET`	`/v1/library_listings/{user_defined_listing_id}/versions/{version_tag}`	Gets a library listing version.
`PATCH`	`/v1/library_listings/{user_defined_listing_id}/versions/{version_tag}`	Updates a library listing version.
`DELETE`	`/v1/library_listings/{user_defined_listing_id}/versions/{version_tag}`	Deletes a library listing version.

Teams

Method	Endpoint	Description
`GET`	`/v1/teams`	Lists all teams.
`GET`	`/v1/teams/{team_id}`	Gets a team by ID.

Users

Method	Endpoint	Description
`GET`	`/v1/users`	Lists users in the workspace.
`GET`	`/v1/users/me`	Gets the authenticated user.
`GET`	`/v1/users/{user_id}`	Gets a user by ID.

Organization

Method	Endpoint	Description
`GET`	`/v1/organizations/me`	Gets the authenticated organization.

Secrets

Method	Endpoint	Description
`GET`	`/v1/secrets`	Gets all secrets (metadata only, no plain text keys).
`GET`	`/v1/teams/{team_id}/secrets`	Gets all secrets for a team (metadata only, no plain text keys).
`POST`	`/v1/secrets`	Upserts a secret.
`POST`	`/v1/teams/{team_id}/secrets`	Upserts a secret in a team.
`DELETE`	`/v1/secrets/{secret_name}`	Deletes a secret by name.
`DELETE`	`/v1/teams/{team_id}/secrets/{secret_name}`	Deletes a secret by name.

Volumes

Method	Endpoint	Description
`GET`	`/v1/volumes`	Gets the volumes in a namespace.
`GET`	`/v1/volumes/namespaces`	Gets the volume namespaces in your workspace.
`GET`	`/v1/volumes/{volume_namespace}/{volume_name}`	Gets a volume.
`DELETE`	`/v1/volumes/{volume_namespace}/{volume_name}`	Deletes a volume.
`GET`	`/v1/volumes/{volume_namespace}/{volume_name}/versions`	Gets the versions of a volume.
`GET`	`/v1/volumes/{volume_namespace}/{volume_name}/versions/{volume_version}`	Gets one version of a volume.
`DELETE`	`/v1/volumes/{volume_namespace}/{volume_name}/versions/{volume_version}`	Deletes one version of a volume.
`POST`	`/v1/volumes/{volume_namespace}/{volume_name}/versions/{volume_version}/restore`	Restores a deleted or expired version of a volume.
`POST`	`/v1/volumes/token`	Creates a volume access token.
`GET`	`/v1/volumes/syncs`	Lists volume syncs.
`POST`	`/v1/volumes/syncs`	Starts a volume sync.
`GET`	`/v1/volumes/syncs/{volume_sync_id}`	Gets a volume sync.
`POST`	`/v1/volumes/syncs/{volume_sync_id}/cancel`	Cancels a volume sync.

| PATCH | /v1/volumes/{volume_namespace}/{volume_name} | Updates a volume’s settings, including its expiration time. | | POST | /v1/volumes/{volume_namespace}/{volume_name}/tags | Creates a tag or moves it to an existing volume version. | | DELETE | /v1/volumes/{volume_namespace}/{volume_name}/tags/{volume_tag} | Deletes a tag without deleting its version. |

Routes

Method	Endpoint	Description
`GET`	`/v1/grid/routes`	Lists routes.
`GET`	`/v1/grid/routes/{route_id}`	Gets a route.
`POST`	`/v1/grid/routes`	Creates a route.
`PATCH`	`/v1/grid/routes/{route_id}`	Updates a route.
`DELETE`	`/v1/grid/routes/{route_id}`	Deletes a route.
`GET`	`/v1/grid/routes/usage`	Gets daily route usage and estimated costs.
`GET`	`/v1/grid/connections`	Lists a team’s connections to upstream providers.
`POST`	`/v1/grid/connections`	Creates a team’s connection to an upstream provider.
`PATCH`	`/v1/grid/connections/{connection_id}`	Updates a connection’s fields without changing its provider or team.
`DELETE`	`/v1/grid/connections/{connection_id}`	Deletes a connection and preserves its referenced team secret.

Classifiers

Method	Endpoint	Description
`GET`	`/v1/grid/classifiers`	Lists classifiers available for intelligent routes.
`GET`	`/v1/grid/classifiers/{classifier_id}`	Gets a classifier available for intelligent routes.

Team settings

Method	Endpoint	Description
`GET`	`/v1/grid/team_settings`	Gets a team’s Grid settings.
`PATCH`	`/v1/grid/team_settings`	Updates a team’s Grid settings.
`GET`	`/v1/grid/team_settings/users`	Lists members’ Grid settings.
`GET`	`/v1/grid/team_settings/users/{user_id}`	Gets a member’s Grid settings.
`PATCH`	`/v1/grid/team_settings/users/{user_id}`	Updates a member’s Grid settings.

Explore

Method	Endpoint	Description
`GET`	`/v1/explore/metadata`	Lists model metadata.

Blob credentials

Method	Endpoint	Description
`GET`	`/v1/blobs/credentials/model`	Gets blob credentials for models.
`GET`	`/v1/blobs/credentials/train`	Gets blob credentials for training.

API keys

Method	Endpoint	Description
`GET`	`/v1/api_keys`	Lists API keys (metadata only, no plain text keys).
`POST`	`/v1/api_keys`	Creates an API key.
`POST`	`/v1/teams/{team_id}/api_keys`	Creates a team API key.
`DELETE`	`/v1/api_keys/{api_key_prefix}`	Deletes an API key by prefix.

Billing

Method	Endpoint	Description
`GET`	`/v1/billing/usage_summary`	Gets billing usage summary for a date range.
`GET`	`/v1/billing/model_apis`	Gets daily Model APIs costs.
`GET`	`/v1/billing/tool_call_usage`	Gets server-side tool call usage.

Audit logs

Method	Endpoint	Description
`GET`	`/v1/audit_logs`	Gets the audit log for the workspace.
`GET`	`/v1/models/{model_id}/audit_logs`	Gets the audit log for a model.
`GET`	`/v1/chains/{chain_id}/audit_logs`	Gets the audit log for a chain.

Sandboxes

For authentication, team selection, and pagination, see the Sandboxes API reference.

Method	Endpoint	Description
`GET`	`/v1/sandboxes/configuration`	Gets the regions where you can create a sandbox.
`GET`	`/v1/sandboxes/instances`	Lists a page of sandboxes.
`GET`	`/v1/sandboxes/instances/{sandbox_name}`	Gets a sandbox by name.
`GET`	`/v1/sandboxes/instances/{sandbox_name}/logs`	Gets a sandbox’s runtime logs.
`GET`	`/v1/sandboxes/instances/{sandbox_name}/metrics`	Gets a sandbox’s metrics over time.
`GET`	`/v1/sandboxes/library_images`	Lists the built-in sandbox images.
`GET`	`/v1/sandboxes/images`	Lists a page of sandbox images.
`GET`	`/v1/sandboxes/images/{image_name}`	Gets a sandbox image and its processing status.
`GET`	`/v1/sandboxes/images/{image_name}/logs`	Gets logs from an image’s latest build.
`GET`	`/v1/sandboxes/images/{image_name}/tags`	Lists a page of tags for a sandbox image.
`POST`	`/v1/token`	Creates a token for accessing a sandbox.
`POST`	`/v1/sandboxes/instances`	Creates a sandbox from an image.
`PATCH`	`/v1/sandboxes/instances/{sandbox_name}`	Updates the configuration of a sandbox.
`DELETE`	`/v1/sandboxes/instances/{sandbox_name}`	Deletes a sandbox and its local data.
`POST`	`/v1/sandboxes/images`	Imports a sandbox image or starts an image build.
`DELETE`	`/v1/sandboxes/images/{image_name}/tags/{tag_name}`	Deletes a version of a sandbox image.
`DELETE`	`/v1/sandboxes/images/{image_name}`	Deletes a sandbox image and its tags.
`POST`	`/v1/sandboxes/cleanup_images`	Removes unused image versions.
`GET`	`/v1/sandboxes/instances/{sandbox_name}/previews`	Lists a sandbox’s application previews.
`GET`	`/v1/sandboxes/instances/{sandbox_name}/previews/{preview_name}`	Gets a preview’s configuration, URL, and status.
`GET`	`/v1/sandboxes/instances/{sandbox_name}/previews/{preview_name}/tokens`	Lists tokens for a private sandbox preview, including expired tokens.
`POST`	`/v1/sandboxes/instances/{sandbox_name}/previews`	Exposes a sandbox port through a public or token-protected HTTPS URL.
`PATCH`	`/v1/sandboxes/instances/{sandbox_name}/previews/{preview_name}`	Updates a preview’s access, headers, or expiration.
`DELETE`	`/v1/sandboxes/instances/{sandbox_name}/previews/{preview_name}`	Deletes a sandbox preview and revokes its tokens.
`POST`	`/v1/sandboxes/instances/{sandbox_name}/previews/{preview_name}/tokens`	Creates a token for accessing a private sandbox preview.
`DELETE`	`/v1/sandboxes/instances/{sandbox_name}/previews/{preview_name}/tokens/{token_name}`	Revokes a token for a private sandbox preview.

​Resources

​Authentication

​Rate limits

​Guides

​Related APIs

​Endpoints

​Models

​Chains

​Deployments

​Environments

​Environment groups

​Training capacity

​Instance types

​Regions

​Model APIs

​Library listings

​Teams

​Users

​Organization

​Secrets

​Volumes

​Routes

​Classifiers

​Team settings

​Explore

​Blob credentials

​API keys

​Billing

​Audit logs

​Sandboxes