Documentation Index
Fetch the complete documentation index at: https://docs.baseten.co/llms.txt
Use this file to discover all available pages before exploring further.
activate
Options
ID of the deployment.
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
ID of the model.Mutually exclusive with other flags in group
model-ref.Name of the model. Use —team to disambiguate when the same name exists in multiple teams.Mutually exclusive with other flags in group
model-ref.Output formatOne of:
text, json, jsonl, noneBaseten remote URL, overrides BASETEN_REMOTE_URL (default https://app.baseten.co)
Team name or ID. Only valid with —model-name.
Enable verbose logging
Examples
Activate a deploymentFilter output with --jq
Print just the success flag
Output
Text mode (--output text): On success, prints “Activated deployment id” to stderr; no stdout output.
JSON mode (--output json): payload type managementapi.ActivateResponse.
config
Options
ID of the deployment.
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
ID of the model.Mutually exclusive with other flags in group
model-ref.Name of the model. Use —team to disambiguate when the same name exists in multiple teams.Mutually exclusive with other flags in group
model-ref.Output formatOne of:
text, json, jsonl, noneBaseten remote URL, overrides BASETEN_REMOTE_URL (default https://app.baseten.co)
Team name or ID. Only valid with —model-name.
Enable verbose logging
Examples
Print the deployment’s config.yamlFilter output with --jq
Extract the parsed model_name field
Output
Text mode (--output text): The original config.yaml text (preserving comments and ordering) when available, otherwise the parsed config marshaled as YAML.
JSON mode (--output json): payload type managementapi.DeploymentConfigResponse.
The full {config, raw_config} envelope. raw_config is the original config.yaml text; config is the parsed shape.
deactivate
Options
ID of the deployment.
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
ID of the model.Mutually exclusive with other flags in group
model-ref.Name of the model. Use —team to disambiguate when the same name exists in multiple teams.Mutually exclusive with other flags in group
model-ref.Output formatOne of:
text, json, jsonl, noneBaseten remote URL, overrides BASETEN_REMOTE_URL (default https://app.baseten.co)
Team name or ID. Only valid with —model-name.
Skip the interactive confirmation prompt. Required when stdin is not a terminal.
Enable verbose logging
Examples
Deactivate a deployment without the confirmation promptFilter output with --jq
Print just the success flag
Output
Text mode (--output text): On success, prints “Deactivated deployment id” to stderr; no stdout output.
JSON mode (--output json): payload type managementapi.DeactivateResponse.
download
Options
ID of the deployment.
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
ID of the model.Mutually exclusive with other flags in group
model-ref.Name of the model. Use —team to disambiguate when the same name exists in multiple teams.Mutually exclusive with other flags in group
model-ref.Extract the Truss tar into this directory.Mutually exclusive with other flags in group
download-out.Save the Truss as an uncompressed tar file at this path.Mutually exclusive with other flags in group
download-out.Output formatOne of:
text, json, jsonl, noneAllow overwriting an existing file or non-empty directory.
Baseten remote URL, overrides BASETEN_REMOTE_URL (default https://app.baseten.co)
Team name or ID. Only valid with —model-name.
Enable verbose logging
Examples
Save the Truss as a tar fileFilter output with --jq
Print just the destination path
Output
Text mode (--output text): Writes the Truss to disk; prints progress and the final destination path to stderr; no stdout output.
JSON mode (--output json): payload type cmd.ModelDeploymentDownloadResult.
On success, stdout is a JSON object with either out_file or out_dir set to the path written.
promote
Options
ID of the deployment.
Target environment name. Defaults to production.
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
ID of the model.Mutually exclusive with other flags in group
model-ref.Name of the model. Use —team to disambiguate when the same name exists in multiple teams.Mutually exclusive with other flags in group
model-ref.Output formatOne of:
text, json, jsonl, noneUse this deployment’s instance type instead of preserving the target environment’s.
Baseten remote URL, overrides BASETEN_REMOTE_URL (default https://app.baseten.co)
Team name or ID. Only valid with —model-name.
Skip the interactive confirmation prompt. Required when stdin is not a terminal.
Enable verbose logging
Examples
Promote a deployment to production without the confirmation promptFilter output with --jq
Print the promoted deployment’s status
Output
Text mode (--output text): On success, prints “Promoted deployment id to environment env” to stderr; no stdout output.
JSON mode (--output json): payload type managementapi.Deployment.
Under —output json, the promoted deployment object.
delete
Options
ID of the deployment.
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
ID of the model.Mutually exclusive with other flags in group
model-ref.Name of the model. Use —team to disambiguate when the same name exists in multiple teams.Mutually exclusive with other flags in group
model-ref.Output formatOne of:
text, json, jsonl, noneBaseten remote URL, overrides BASETEN_REMOTE_URL (default https://app.baseten.co)
Team name or ID. Only valid with —model-name.
Skip the interactive confirmation prompt. Required when stdin is not a terminal.
Enable verbose logging
Examples
Delete a deployment without the confirmation promptFilter output with --jq
Print the deleted deployment’s ID
Output
Text mode (--output text): On success, prints “Deleted deployment id” to stderr; no stdout output.
JSON mode (--output json): payload type managementapi.DeploymentTombstone.
fetch
Options
ID of the deployment.
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
ID of the model.Mutually exclusive with other flags in group
model-ref.Name of the model. Use —team to disambiguate when the same name exists in multiple teams.Mutually exclusive with other flags in group
model-ref.Output formatOne of:
text, json, jsonl, noneBaseten remote URL, overrides BASETEN_REMOTE_URL (default https://app.baseten.co)
Team name or ID. Only valid with —model-name.
Enable verbose logging
Examples
Fetch a deployment by IDFilter output with --jq
Print just the deployment status
Output
Text mode (--output text): Field-per-line summary: ID, Name, Model, Environment (optional), Status, Instance (optional), Replicas, Created.
JSON mode (--output json): payload type managementapi.Deployment.
list
Options
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
ID of the model.Mutually exclusive with other flags in group
model-ref.Name of the model. Use —team to disambiguate when the same name exists in multiple teams.Mutually exclusive with other flags in group
model-ref.Output formatOne of:
text, json, jsonl, noneBaseten remote URL, overrides BASETEN_REMOTE_URL (default https://app.baseten.co)
Team name or ID. Only valid with —model-name.
Enable verbose logging
Examples
List all deployments of a modelFilter output with --jq
Print just the deployment IDs
Output
Text mode (--output text): Table with columns: ID, NAME, ENVIRONMENT, STATUS, INSTANCE, REPLICAS, CREATED. When no deployments exist, prints “No deployments found.” to stderr.
JSON mode (--output json): payload type managementapi.Deployments.
logs
Options
ID of the deployment.
End of the log time range. Accepts ISO 8601; values without a timezone designator are interpreted in the local timezone. If omitted but —start is given, defaults to now. Window must be at most 7 days.
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
ID of the model.Mutually exclusive with other flags in group
model-ref.Name of the model. Use —team to disambiguate when the same name exists in multiple teams.Mutually exclusive with other flags in group
model-ref.Output formatOne of:
text, json, jsonl, noneBaseten remote URL, overrides BASETEN_REMOTE_URL (default https://app.baseten.co)
Shortcut for fetching logs from a relative time ago until now. Accepts a Go duration (e.g. ‘30m’, ‘1h30m’) or ‘
Nd’ (e.g. ‘3d’). Maximum ‘7d’. Mutually exclusive with —start and —end.Start of the log time range. Accepts ISO 8601 (e.g. ‘2026-05-14’, ‘2026-05-14T12:00:00’, ‘2026-05-14T12:00:00Z’). Values without a timezone designator are interpreted in the local timezone. If omitted but —end is given, defaults to 7 days before —end. Window must be at most 7 days.
Stream new logs as they arrive until the deployment leaves a runnable state or you interrupt with Ctrl-C. Cannot be combined with —start, —end, or —since. For machine-readable streaming, prefer —output jsonl over —output json.
Team name or ID. Only valid with —model-name.
Enable verbose logging
Examples
Print logs for a deployment over the last hourFilter output with --jq
Stream just the log messages as a JSONL stream
Output
Text mode (--output text): One line per log record: “[YYYY-MM-DD HH:MM:SS]: (replica) message”.
JSON mode (--output json): payload type managementapi.Log.