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, noneUse a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
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
--output json to emit the full response {config, raw_config} as JSON.
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, noneUse a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
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
--yes to skip the prompt. When stdin is not a terminal, --yes is required.
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, noneUse a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
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
--out-file or --out-dir is required. --out-file writes the raw tar bytes; --out-dir extracts the tar into the directory. Use --overwrite to replace an existing file or write into a non-empty directory.
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.
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
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
--yes to skip the prompt. When stdin is not a terminal, --yes is required.
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.
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
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
--yes to skip the prompt. When stdin is not a terminal, --yes is required.
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, noneUse a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
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.
describe
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, noneUse a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
Team name or ID. Only valid with —model-name.
Enable verbose logging
Examples
Describe 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, noneUse a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
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
--start/--end or --since to scope the window (max 7 days). Use --tail to stream live logs until the deployment leaves a runnable state or you interrupt with Ctrl-C.
For machine-readable streaming, prefer --output jsonl over --output json.
For request-ID tracing, scope, and log export, see 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, the server defaults the end to now. Window must be at most 7 days.
Case-sensitive substring; lines containing it are dropped. May be repeated.
Case-sensitive substring that must appear in the log message. May be repeated; all must match.
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
Only return logs at or above this severity level.One of:
debug, info, warning, errorID 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 a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
Only return logs emitted by this replica (5-char short ID).
Only return logs tagged with this inference request ID.
RE2 regular expression matched against the log message. Prefer —includes and —excludes for plain substring matches.
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, the server defaults the start to 30 minutes before the 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 the time-range or filter flags. 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.
metrics
--mode current for a snapshot, --mode summary to aggregate a window, or --mode series to plot values over time. Scope the window with --since or --start/--end, and select metrics with one or more --metric flags.
Options
ID of the deployment.
End of the metrics time range. Accepts ISO 8601; values without a timezone designator are interpreted in the local timezone. If omitted, the server defaults the end to now. Window must be at most 7 days.
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
Name of a metric to return; see https://docs.baseten.co/observability/export-metrics/supported-metrics for the available names. May be repeated. When omitted, a default set is returned.
Aggregation mode. ‘current’ returns an instantaneous snapshot at now; ‘summary’ aggregates the whole window into one value per metric; ‘series’ returns evenly-spaced points across the window. —start/—end/—since are only meaningful for summary and series.One of:
current, summary, seriesID 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.For —mode series, emit a per-step table instead of sparklines.
Output formatOne of:
text, json, jsonl, noneUse a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
Shortcut for a window 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 metrics 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, the server defaults the start to one hour before the end. Window must be at most 7 days.
Team name or ID. Only valid with —model-name.
Enable verbose logging
Examples
Show a current snapshot of the default metricsFilter output with --jq
Print the metric names returned
Output
Text mode (--output text): For current and summary, a table with columns METRIC, one column per label dimension (for example QUANTILE, STAT), and VALUE; summary counter values show “total (rate/s)”. For series, a sparkline per metric label set with its min-max range and end value, or a per-step table under --no-chart.
JSON mode (--output json): payload type cmd.DeploymentMetricsResult.