baseten model environment

activate

baseten model environment activate [OPTIONS]

Activate the deployment associated with an environment.

Options

TEXT

required

Name of the environment (e.g. production).

TEXT

Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)

TEXT

ID of the model.Mutually exclusive with other flags in group model-ref.

TEXT

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.

TEXT

default:"text"

Output formatOne of: text, json, jsonl, none

TEXT

Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile

TEXT

Team name or ID. Only valid with —model-name.

BOOL

Enable verbose logging

Examples

Activate the deployment associated with an environment

baseten model environment activate --model-id <model-id> --environment production

Filter output with `--jq`

Print just the success flag

baseten model environment activate --model-id <model-id> --environment production --jq '.success'

Output

Text mode (--output text): On success, prints “Activated environment name” to stderr; no stdout output. JSON mode (--output json): payload type managementapi.ActivateResponse.

deactivate

baseten model environment deactivate [OPTIONS]

Deactivate the deployment associated with an environment. Prompts for yes/no confirmation. Pass --yes to skip the prompt. When stdin is not a terminal, --yes is required.

Options

TEXT

required

Name of the environment (e.g. production).

TEXT

Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)

TEXT

ID of the model.Mutually exclusive with other flags in group model-ref.

TEXT

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.

TEXT

default:"text"

Output formatOne of: text, json, jsonl, none

TEXT

Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile

TEXT

Team name or ID. Only valid with —model-name.

BOOL

Skip the interactive confirmation prompt. Required when stdin is not a terminal.

BOOL

Enable verbose logging

Examples

Deactivate an environment without the confirmation prompt

baseten model environment deactivate --model-id <model-id> --environment production --yes

Filter output with `--jq`

Print just the success flag

baseten model environment deactivate --model-id <model-id> --environment production --yes --jq '.success'

Output

Text mode (--output text): On success, prints “Deactivated environment name” to stderr; no stdout output. JSON mode (--output json): payload type managementapi.DeactivateResponse.

describe

baseten model environment describe [OPTIONS]

Describe a model environment by name.

Options

TEXT

required

Name of the environment (e.g. production).

TEXT

Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)

TEXT

ID of the model.Mutually exclusive with other flags in group model-ref.

TEXT

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.

TEXT

default:"text"

Output formatOne of: text, json, jsonl, none

TEXT

Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile

TEXT

Team name or ID. Only valid with —model-name.

BOOL

Enable verbose logging

Examples

Describe the production environment of a model

baseten model environment describe --model-id <model-id> --environment production

Filter output with `--jq`

Print the current deployment ID

baseten model environment describe --model-id <model-id> --environment production --jq '.current_deployment.id'

Output

Text mode (--output text): Field-per-line summary: Name, Model, Current Deployment, Status, Candidate Deployment (optional), Created. JSON mode (--output json): payload type managementapi.Environment.

list

baseten model environment list [OPTIONS]

List all environments of a model.

Options

TEXT

Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)

TEXT

ID of the model.Mutually exclusive with other flags in group model-ref.

TEXT

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.

TEXT

default:"text"

Output formatOne of: text, json, jsonl, none

TEXT

Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile

TEXT

Team name or ID. Only valid with —model-name.

BOOL

Enable verbose logging

Examples

List all environments of a model

baseten model environment list --model-id <model-id>

Filter output with `--jq`

Print just the environment names

baseten model environment list --model-id <model-id> --jq '.environments[].name'

Output

Text mode (--output text): Table with columns: NAME, CURRENT DEPLOYMENT, STATUS. When no environments exist, prints “No environments found.” to stderr. JSON mode (--output json): payload type managementapi.Environments.

logs

baseten model environment logs [OPTIONS]

Fetch logs for a model environment, spanning every deployment that was active on the environment across the time range. By default returns up to --limit lines from the last 30 minutes, newest first, and prints a note to stderr when --limit trims older lines. Use --start/--end or --since to scope the window (max 7 days). Use --tail to stream live logs until the environment’s current 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

TEXT

End of the log time range. Accepts ISO 8601; values without a timezone designator are interpreted in the local timezone. Default is now. Window must be at most 7 days.

TEXT

required

Name of the environment (e.g. production).

TEXT (repeatable)

Case-sensitive substring; lines containing it are dropped. May be repeated.

TEXT (repeatable)

Case-sensitive substring that must appear in the log message. May be repeated; all must match.

TEXT

Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)

INTEGER

default:"5000"

Maximum number of log lines to return, paging backward from the end of the window. Use 0 for no limit (every log line in the window). Not applicable with —tail.

TEXT

Only return logs at or above this severity level.One of: debug, info, warning, error

TEXT

ID of the model.Mutually exclusive with other flags in group model-ref.

TEXT

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.

TEXT

default:"text"

Output formatOne of: text, json, jsonl, none

TEXT

Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile

TEXT

Only return logs emitted by this replica (5-char short ID).

TEXT

Only return logs tagged with this inference request ID.

TEXT

RE2 regular expression matched against the log message. Prefer —includes and —excludes for plain substring matches.

TEXT

Shortcut for fetching logs from a relative time ago until now. Accepts a duration (e.g. ‘30m’, ‘1h30m’) or ‘Nd’ (e.g. ‘3d’). Maximum ‘7d’. Mutually exclusive with —start and —end.

TEXT

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. Default is 30 minutes before the end. Window must be at most 7 days.

BOOL

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.

TEXT

Team name or ID. Only valid with —model-name.

BOOL

Enable verbose logging

Examples

Print logs for the production environment over the last hour

baseten model environment logs --model-id <model-id> --environment production --since 1h

Tail live logs until the environment’s current deployment leaves a runnable state

baseten model environment logs --model-id <model-id> --environment production --tail

Filter output with `--jq`

Stream just the log messages as a JSONL stream

baseten model environment logs --model-id <model-id> --environment production --output jsonl --jq '.message'

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

baseten model environment metrics [OPTIONS]

Fetch metrics aggregated across every deployment that was active on the environment over the time range. Use --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 (max 7 days; only applies to summary and series), and select metrics with one or more --metric flags. In series mode the window is split at each promotion so every point reflects the deployment(s) serving the environment at that time.

Options

TEXT

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.

TEXT

required

Name of the environment (e.g. production).

TEXT

Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)

TEXT (repeatable)

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.

TEXT

default:"current"

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, series

TEXT

ID of the model.Mutually exclusive with other flags in group model-ref.

TEXT

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.

BOOL

For —mode series, emit a per-step table instead of sparklines.

TEXT

default:"text"

Output formatOne of: text, json, jsonl, none

TEXT

Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile

TEXT

Shortcut for a window from a relative time ago until now. Accepts a duration (e.g. ‘30m’, ‘1h30m’) or ‘Nd’ (e.g. ‘3d’). Maximum ‘7d’. Mutually exclusive with —start and —end.

TEXT

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.

TEXT

Team name or ID. Only valid with —model-name.

BOOL

Enable verbose logging

Examples

Show a current snapshot of the default metrics for the production environment

baseten model environment metrics --model-id <model-id> --environment production

Summarize request volume and latency over the last hour

baseten model environment metrics --model-id <model-id> --environment production --mode summary --since 1h --metric baseten_inference_requests_total --metric baseten_end_to_end_response_time_seconds

Plot a series over the last 6 hours

baseten model environment metrics --model-id <model-id> --environment production --mode series --since 6h

Filter output with `--jq`

Print the metric names returned

baseten model environment metrics --model-id <model-id> --environment production --jq '.metric_descriptors[].name'

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 managementapi.GetModelMetricsResponse. The metrics response: metric_descriptors, index-mapped metric_values, the resolved mode, and the returned window.

update-autoscaling

baseten model environment update-autoscaling [OPTIONS]

Update an environment’s autoscaling settings, which apply to whichever deployment currently serves it. Only the flags you pass are changed; every other setting is left alone. Run baseten model environment describe to see the current values.

Options

INTEGER

Timeframe of traffic considered for autoscaling decisions, in seconds.

INTEGER

Number of requests per replica before scaling up.

TEXT

required

Name of the environment (e.g. production).

TEXT

Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)

INTEGER

Maximum number of replicas.

INTEGER

Maximum percentage of replicas that can be removed per autoscaling window (1-50). For example, 20 means at most 20% of replicas are removed per window.

INTEGER

Minimum number of replicas.

TEXT

ID of the model.Mutually exclusive with other flags in group model-ref.

TEXT

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.

TEXT

default:"text"

Output formatOne of: text, json, jsonl, none

TEXT

Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile

INTEGER

Waiting period before scaling down any active replica, in seconds.

INTEGER

Target number of in-flight tokens for autoscaling decisions. Early access only.

INTEGER

Target utilization percentage for scaling up and down.

TEXT

Team name or ID. Only valid with —model-name.

BOOL

Enable verbose logging

Examples

Raise the production environment’s replica bounds

baseten model environment update-autoscaling --model-id <model-id> --environment production --min-replica 2 --max-replica 10

Filter output with `--jq`

Print the environment’s resulting minimum replica count

baseten model environment update-autoscaling --model-id <model-id> --environment production --min-replica 2 --jq '.environment.autoscaling_settings.min_replica'

Output

Text mode (--output text): On success, prints “Updated autoscaling settings for environment name” to stderr; no stdout output. JSON mode (--output json): payload type managementapi.UpdateEnvironmentResponse.

update-promotion

baseten model environment update-promotion [OPTIONS]

Update how deployments are promoted into an environment: whether to redeploy, whether to roll out gradually and with what rolling deploy config, what to do with the outgoing deployment, and whether to ramp up traffic. Only the flags you pass are changed; every other setting is left alone. Run baseten model environment describe to see the current values.

Options

TEXT

required

Name of the environment (e.g. production).

TEXT

Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)

INTEGER

The maximum surge percentage for rolling deploys.

INTEGER

The maximum unavailable percentage for rolling deploys.

TEXT

ID of the model.Mutually exclusive with other flags in group model-ref.

TEXT

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.

TEXT

default:"text"

Output formatOne of: text, json, jsonl, none

TEXT

Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile

TEXT

The cleanup strategy to use after a promotion completes.One of: keep, scale-to-zero, deactivate

INTEGER

Duration of the ramp up, in seconds.

BOOL

Whether to ramp up traffic while promoting. Pass true or false explicitly; omit the flag to leave this setting unchanged.

BOOL

Whether to deploy on all promotions. Enabling this allows model code to safely handle environment-specific logic: when a deployment is promoted, a new deployment is created with a copy of the image. Pass true or false explicitly; omit the flag to leave this setting unchanged.

INTEGER

The replica overhead percentage for rolling deploys.

BOOL

Whether the environment should rely on rolling deploy orchestration. Pass true or false explicitly; omit the flag to leave this setting unchanged.

TEXT

The rolling deploy strategy to use for promotions.One of: replica

INTEGER

The stabilization time for rolling deploys, in seconds.

TEXT

Team name or ID. Only valid with —model-name.

BOOL

Enable verbose logging

Examples

Turn on rolling deploys and scale the outgoing deployment to zero

baseten model environment update-promotion --model-id <model-id> --environment production --rolling-deploy true --promotion-cleanup-strategy scale-to-zero

Slow the rollout by lowering the surge percentage

baseten model environment update-promotion --model-id <model-id> --environment production --max-surge-percent 10

Filter output with `--jq`

Print the resulting cleanup strategy

baseten model environment update-promotion --model-id <model-id> --environment production --rolling-deploy true --jq '.environment.promotion_settings.promotion_cleanup_strategy'

Output

Text mode (--output text): On success, prints “Updated promotion settings for environment name” to stderr; no stdout output. JSON mode (--output json): payload type managementapi.UpdateEnvironmentResponse.

update-request-backpressure

baseten model environment update-request-backpressure [OPTIONS]

Set the policy applied when the environment’s request queue is full. Pass --policy null to clear an existing policy and fall back to the default. Run baseten model environment describe to see the current values.

Options

TEXT

required

Name of the environment (e.g. production).

TEXT

Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)

TEXT

ID of the model.Mutually exclusive with other flags in group model-ref.

TEXT

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.

TEXT

default:"text"

Output formatOne of: text, json, jsonl, none

TEXT

required

Backpressure policy to apply. Pass null to clear an existing policy.One of: queue-on-full, reject-on-full

TEXT

Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile

TEXT

Team name or ID. Only valid with —model-name.

BOOL

Enable verbose logging

Examples

Reject requests once the queue is full

baseten model environment update-request-backpressure --model-id <model-id> --environment production --policy reject-on-full

Clear the policy

baseten model environment update-request-backpressure --model-id <model-id> --environment production --policy null

Filter output with `--jq`

Print the resulting policy

baseten model environment update-request-backpressure --model-id <model-id> --environment production --policy reject-on-full --jq '.environment.request_backpressure_settings.policy'

Output

Text mode (--output text): The resulting policy, or “none” when no policy is set. JSON mode (--output json): payload type managementapi.UpdateEnvironmentResponse.

​activate

​Options

​Examples

​Filter output with --jq

​Output

​deactivate

​Options

​Examples

​Filter output with --jq

​Output

​describe

​Options

​Examples

​Filter output with --jq

​Output

​list

​Options

​Examples

​Filter output with --jq

​Output

​logs

​Options

​Examples

​Filter output with --jq

​Output

​metrics

​Options

​Examples

​Filter output with --jq

​Output

​update-autoscaling

​Options

​Examples

​Filter output with --jq

​Output

​update-promotion

​Options

​Examples

​Filter output with --jq

​Output

​update-request-backpressure

​Options

​Examples

​Filter output with --jq

​Output

activate

Options

Examples

Filter output with `--jq`

Output

deactivate

Options

Examples

Filter output with `--jq`

Output

describe

Options

Examples

Filter output with `--jq`

Output

list

Options

Examples

Filter output with `--jq`

Output

logs

Options

Examples

Filter output with `--jq`

Output

metrics

Options

Examples

Filter output with `--jq`

Output

update-autoscaling

Options

Examples

Filter output with `--jq`

Output

update-promotion

Options

Examples

Filter output with `--jq`

Output

update-request-backpressure

Options

Examples

Filter output with `--jq`

Output