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.

Rate limits

Management API requests are rate limited per API key. See Rate limits for endpoint limits and guidance for handling 429 responses.

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}/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/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.

Routes

Method	Endpoint	Description
`GET`	`/v1/routes`	Lists routes.
`GET`	`/v1/routes/{route_id}`	Gets a route.
`POST`	`/v1/routes`	Creates a route.
`PATCH`	`/v1/routes/{route_id}`	Updates a route.
`DELETE`	`/v1/routes/{route_id}`	Deletes a route.
`GET`	`/v1/routes/usage`	Gets daily route usage and estimated costs.

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.

Reference

Inference API

Management API

Loops API

Training API

Frontier Gateway API

CLI reference

SDKs and clients

Configuration

Metrics

Integrations

Management API reference

Resources

Authentication

Rate limits

Guides

Endpoints

Models

Chains

Deployments

Environments

Environment groups

Training capacity

Instance types

Regions

Model APIs

Library listings

Teams

Users

Organization

Secrets

Volumes

Routes

Explore

Blob credentials

API keys

Billing

Audit logs

Sandboxes

​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

​Explore

​Blob credentials

​API keys

​Billing

​Audit logs

​Sandboxes

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

Explore

Blob credentials

API keys

Billing

Audit logs

Sandboxes