> ## 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.

# baseten model environment

> Manage environments of a model

## activate

```sh theme={"system"}
baseten model environment activate [OPTIONS]
```

Activate the deployment associated with an environment.

### Options

<ParamField body="--environment" type="TEXT" required>
  Name of the environment (e.g. production). Run 'baseten model environment list' to see a model's environments.
</ParamField>

<ParamField body="-q, --jq" type="TEXT">
  Filter JSON output with a jq expression; implies --output json (or jsonl for streamed commands)
</ParamField>

<ParamField body="--model-id" type="TEXT">
  ID of the model.

  Mutually exclusive with other flags in group `model-ref`.
</ParamField>

<ParamField body="--model-name" type="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`.
</ParamField>

<ParamField body="-o, --output" type="TEXT" default="text">
  Output format

  One of: `text`, `json`, `jsonl`, `none`
</ParamField>

<ParamField body="--profile" type="TEXT">
  Use a specific stored profile for this command, overriding BASETEN\_PROFILE and the current profile
</ParamField>

<ParamField body="--team" type="TEXT">
  Team name or ID. Only valid with --model-name.
</ParamField>

<ParamField body="-v, --verbose" type="BOOL">
  Enable verbose logging
</ParamField>

### Examples

Activate the deployment associated with an environment

```sh theme={"system"}
baseten model environment activate --model-id <model-id> --environment production
```

### Filter output with `--jq`

Print just the success flag

```sh theme={"system"}
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

```sh theme={"system"}
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

<ParamField body="--environment" type="TEXT" required>
  Name of the environment (e.g. production). Run 'baseten model environment list' to see a model's environments.
</ParamField>

<ParamField body="-q, --jq" type="TEXT">
  Filter JSON output with a jq expression; implies --output json (or jsonl for streamed commands)
</ParamField>

<ParamField body="--model-id" type="TEXT">
  ID of the model.

  Mutually exclusive with other flags in group `model-ref`.
</ParamField>

<ParamField body="--model-name" type="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`.
</ParamField>

<ParamField body="-o, --output" type="TEXT" default="text">
  Output format

  One of: `text`, `json`, `jsonl`, `none`
</ParamField>

<ParamField body="--profile" type="TEXT">
  Use a specific stored profile for this command, overriding BASETEN\_PROFILE and the current profile
</ParamField>

<ParamField body="--team" type="TEXT">
  Team name or ID. Only valid with --model-name.
</ParamField>

<ParamField body="--yes" type="BOOL">
  Skip the interactive confirmation prompt. Required when stdin is not a terminal.
</ParamField>

<ParamField body="-v, --verbose" type="BOOL">
  Enable verbose logging
</ParamField>

### Examples

Deactivate an environment without the confirmation prompt

```sh theme={"system"}
baseten model environment deactivate --model-id <model-id> --environment production --yes
```

### Filter output with `--jq`

Print just the success flag

```sh theme={"system"}
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

```sh theme={"system"}
baseten model environment describe [OPTIONS]
```

Describe a model environment by name.

### Options

<ParamField body="--environment" type="TEXT" required>
  Name of the environment (e.g. production). Run 'baseten model environment list' to see a model's environments.
</ParamField>

<ParamField body="-q, --jq" type="TEXT">
  Filter JSON output with a jq expression; implies --output json (or jsonl for streamed commands)
</ParamField>

<ParamField body="--model-id" type="TEXT">
  ID of the model.

  Mutually exclusive with other flags in group `model-ref`.
</ParamField>

<ParamField body="--model-name" type="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`.
</ParamField>

<ParamField body="-o, --output" type="TEXT" default="text">
  Output format

  One of: `text`, `json`, `jsonl`, `none`
</ParamField>

<ParamField body="--profile" type="TEXT">
  Use a specific stored profile for this command, overriding BASETEN\_PROFILE and the current profile
</ParamField>

<ParamField body="--team" type="TEXT">
  Team name or ID. Only valid with --model-name.
</ParamField>

<ParamField body="-v, --verbose" type="BOOL">
  Enable verbose logging
</ParamField>

### Examples

Describe the production environment of a model

```sh theme={"system"}
baseten model environment describe --model-id <model-id> --environment production
```

### Filter output with `--jq`

Print the current deployment ID

```sh theme={"system"}
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

```sh theme={"system"}
baseten model environment list [OPTIONS]
```

List all environments of a model.

### Options

<ParamField body="-q, --jq" type="TEXT">
  Filter JSON output with a jq expression; implies --output json (or jsonl for streamed commands)
</ParamField>

<ParamField body="--model-id" type="TEXT">
  ID of the model.

  Mutually exclusive with other flags in group `model-ref`.
</ParamField>

<ParamField body="--model-name" type="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`.
</ParamField>

<ParamField body="-o, --output" type="TEXT" default="text">
  Output format

  One of: `text`, `json`, `jsonl`, `none`
</ParamField>

<ParamField body="--profile" type="TEXT">
  Use a specific stored profile for this command, overriding BASETEN\_PROFILE and the current profile
</ParamField>

<ParamField body="--team" type="TEXT">
  Team name or ID. Only valid with --model-name.
</ParamField>

<ParamField body="-v, --verbose" type="BOOL">
  Enable verbose logging
</ParamField>

### Examples

List all environments of a model

```sh theme={"system"}
baseten model environment list --model-id <model-id>
```

### Filter output with `--jq`

Print just the environment names

```sh theme={"system"}
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

```sh theme={"system"}
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](/observability/logs).

### Options

<ParamField body="--end" type="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.
</ParamField>

<ParamField body="--environment" type="TEXT" required>
  Name of the environment (e.g. production). Run 'baseten model environment list' to see a model's environments.
</ParamField>

<ParamField body="--excludes" type="TEXT (repeatable)">
  Case-sensitive substring; lines containing it are dropped. May be repeated.
</ParamField>

<ParamField body="--includes" type="TEXT (repeatable)">
  Case-sensitive substring that must appear in the log message. May be repeated; all must match.
</ParamField>

<ParamField body="-q, --jq" type="TEXT">
  Filter JSON output with a jq expression; implies --output json (or jsonl for streamed commands)
</ParamField>

<ParamField body="--limit" type="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.
</ParamField>

<ParamField body="--min-level" type="TEXT">
  Only return logs at or above this severity level.

  One of: `debug`, `info`, `warning`, `error`
</ParamField>

<ParamField body="--model-id" type="TEXT">
  ID of the model.

  Mutually exclusive with other flags in group `model-ref`.
</ParamField>

<ParamField body="--model-name" type="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`.
</ParamField>

<ParamField body="-o, --output" type="TEXT" default="text">
  Output format

  One of: `text`, `json`, `jsonl`, `none`
</ParamField>

<ParamField body="--profile" type="TEXT">
  Use a specific stored profile for this command, overriding BASETEN\_PROFILE and the current profile
</ParamField>

<ParamField body="--replica" type="TEXT">
  Only return logs emitted by this replica (5-char short ID).
</ParamField>

<ParamField body="--request-id" type="TEXT">
  Only return logs tagged with this inference request ID.
</ParamField>

<ParamField body="--search-pattern" type="TEXT">
  RE2 regular expression matched against the log message. Prefer --includes and --excludes for plain substring matches.
</ParamField>

<ParamField body="--since" type="TEXT">
  Shortcut for fetching logs from a relative time ago until now. Accepts a duration (e.g. '30m', '1h30m') or '`N`d' (e.g. '3d'). Maximum '7d'. Mutually exclusive with --start and --end.
</ParamField>

<ParamField body="--start" type="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.
</ParamField>

<ParamField body="--tail" type="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.
</ParamField>

<ParamField body="--team" type="TEXT">
  Team name or ID. Only valid with --model-name.
</ParamField>

<ParamField body="-v, --verbose" type="BOOL">
  Enable verbose logging
</ParamField>

### Examples

Print logs for the production environment over the last hour

```sh theme={"system"}
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

```sh theme={"system"}
baseten model environment logs --model-id <model-id> --environment production --tail
```

### Filter output with `--jq`

Stream just the log messages as a JSONL stream

```sh theme={"system"}
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

```sh theme={"system"}
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

<ParamField body="--end" type="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.
</ParamField>

<ParamField body="--environment" type="TEXT" required>
  Name of the environment (e.g. production). Run 'baseten model environment list' to see a model's environments.
</ParamField>

<ParamField body="-q, --jq" type="TEXT">
  Filter JSON output with a jq expression; implies --output json (or jsonl for streamed commands)
</ParamField>

<ParamField body="--metric" type="TEXT (repeatable)">
  Name of a metric to return; see [https://docs.baseten.co/observability/export-metrics/supported-metrics](https://docs.baseten.co/observability/export-metrics/supported-metrics) for the available names. May be repeated. When omitted, a default set is returned.
</ParamField>

<ParamField body="--mode" type="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`
</ParamField>

<ParamField body="--model-id" type="TEXT">
  ID of the model.

  Mutually exclusive with other flags in group `model-ref`.
</ParamField>

<ParamField body="--model-name" type="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`.
</ParamField>

<ParamField body="--no-chart" type="BOOL">
  For --mode series, emit a per-step table instead of sparklines.
</ParamField>

<ParamField body="-o, --output" type="TEXT" default="text">
  Output format

  One of: `text`, `json`, `jsonl`, `none`
</ParamField>

<ParamField body="--profile" type="TEXT">
  Use a specific stored profile for this command, overriding BASETEN\_PROFILE and the current profile
</ParamField>

<ParamField body="--since" type="TEXT">
  Shortcut for a window from a relative time ago until now. Accepts a duration (e.g. '30m', '1h30m') or '`N`d' (e.g. '3d'). Maximum '7d'. Mutually exclusive with --start and --end.
</ParamField>

<ParamField body="--start" type="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.
</ParamField>

<ParamField body="--team" type="TEXT">
  Team name or ID. Only valid with --model-name.
</ParamField>

<ParamField body="-v, --verbose" type="BOOL">
  Enable verbose logging
</ParamField>

### Examples

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

```sh theme={"system"}
baseten model environment metrics --model-id <model-id> --environment production
```

Summarize request volume and latency over the last hour

```sh theme={"system"}
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

```sh theme={"system"}
baseten model environment metrics --model-id <model-id> --environment production --mode series --since 6h
```

### Filter output with `--jq`

Print the metric names returned

```sh theme={"system"}
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

```sh theme={"system"}
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

<ParamField body="--autoscaling-window" type="INTEGER">
  Timeframe of traffic considered for autoscaling decisions, in seconds.
</ParamField>

<ParamField body="--concurrency-target" type="INTEGER">
  Number of requests per replica before scaling up.
</ParamField>

<ParamField body="--environment" type="TEXT" required>
  Name of the environment (e.g. production). Run 'baseten model environment list' to see a model's environments.
</ParamField>

<ParamField body="-q, --jq" type="TEXT">
  Filter JSON output with a jq expression; implies --output json (or jsonl for streamed commands)
</ParamField>

<ParamField body="--max-replica" type="INTEGER">
  Maximum number of replicas.
</ParamField>

<ParamField body="--max-scale-down-rate" type="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.
</ParamField>

<ParamField body="--min-replica" type="INTEGER">
  Minimum number of replicas.
</ParamField>

<ParamField body="--model-id" type="TEXT">
  ID of the model.

  Mutually exclusive with other flags in group `model-ref`.
</ParamField>

<ParamField body="--model-name" type="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`.
</ParamField>

<ParamField body="-o, --output" type="TEXT" default="text">
  Output format

  One of: `text`, `json`, `jsonl`, `none`
</ParamField>

<ParamField body="--profile" type="TEXT">
  Use a specific stored profile for this command, overriding BASETEN\_PROFILE and the current profile
</ParamField>

<ParamField body="--scale-down-delay" type="INTEGER">
  Waiting period before scaling down any active replica, in seconds.
</ParamField>

<ParamField body="--target-in-flight-tokens" type="INTEGER">
  Target number of in-flight tokens for autoscaling decisions. Early access only.
</ParamField>

<ParamField body="--target-utilization-percentage" type="INTEGER">
  Target utilization percentage for scaling up and down.
</ParamField>

<ParamField body="--team" type="TEXT">
  Team name or ID. Only valid with --model-name.
</ParamField>

<ParamField body="-v, --verbose" type="BOOL">
  Enable verbose logging
</ParamField>

### Examples

Raise the production environment's replica bounds

```sh theme={"system"}
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

```sh theme={"system"}
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

```sh theme={"system"}
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

<ParamField body="--environment" type="TEXT" required>
  Name of the environment (e.g. production). Run 'baseten model environment list' to see a model's environments.
</ParamField>

<ParamField body="-q, --jq" type="TEXT">
  Filter JSON output with a jq expression; implies --output json (or jsonl for streamed commands)
</ParamField>

<ParamField body="--max-surge-percent" type="INTEGER">
  The maximum surge percentage for rolling deploys.
</ParamField>

<ParamField body="--max-unavailable-percent" type="INTEGER">
  The maximum unavailable percentage for rolling deploys.
</ParamField>

<ParamField body="--model-id" type="TEXT">
  ID of the model.

  Mutually exclusive with other flags in group `model-ref`.
</ParamField>

<ParamField body="--model-name" type="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`.
</ParamField>

<ParamField body="-o, --output" type="TEXT" default="text">
  Output format

  One of: `text`, `json`, `jsonl`, `none`
</ParamField>

<ParamField body="--profile" type="TEXT">
  Use a specific stored profile for this command, overriding BASETEN\_PROFILE and the current profile
</ParamField>

<ParamField body="--promotion-cleanup-strategy" type="TEXT">
  The cleanup strategy to use after a promotion completes.

  One of: `keep`, `scale-to-zero`, `deactivate`
</ParamField>

<ParamField body="--ramp-up-duration-seconds" type="INTEGER">
  Duration of the ramp up, in seconds.
</ParamField>

<ParamField body="--ramp-up-while-promoting" type="BOOL" deprecated>
  Deprecated for models: model environments reject `true`. Use `--rolling-deploy true` for a gradual promotion.
</ParamField>

<ParamField body="--redeploy-on-promotion" type="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.
</ParamField>

<ParamField body="--replica-overhead-percent" type="INTEGER">
  The replica overhead percentage for rolling deploys.
</ParamField>

<ParamField body="--rolling-deploy" type="BOOL">
  Whether the environment should rely on rolling deploy orchestration. Pass `true` or `false` explicitly; omit the flag to leave this setting unchanged.
</ParamField>

<ParamField body="--rolling-deploy-strategy" type="TEXT">
  The rolling deploy strategy to use for promotions.

  One of: `replica`
</ParamField>

<ParamField body="--stabilization-time-seconds" type="INTEGER">
  The stabilization time for rolling deploys, in seconds.
</ParamField>

<ParamField body="--team" type="TEXT">
  Team name or ID. Only valid with --model-name.
</ParamField>

<ParamField body="-v, --verbose" type="BOOL">
  Enable verbose logging
</ParamField>

### Examples

Turn on rolling deploys and scale the outgoing deployment to zero

```sh theme={"system"}
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

```sh theme={"system"}
baseten model environment update-promotion --model-id <model-id> --environment production --max-surge-percent 10
```

### Filter output with `--jq`

Print the resulting cleanup strategy

```sh theme={"system"}
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

```sh theme={"system"}
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

<ParamField body="--environment" type="TEXT" required>
  Name of the environment (e.g. production). Run 'baseten model environment list' to see a model's environments.
</ParamField>

<ParamField body="-q, --jq" type="TEXT">
  Filter JSON output with a jq expression; implies --output json (or jsonl for streamed commands)
</ParamField>

<ParamField body="--model-id" type="TEXT">
  ID of the model.

  Mutually exclusive with other flags in group `model-ref`.
</ParamField>

<ParamField body="--model-name" type="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`.
</ParamField>

<ParamField body="-o, --output" type="TEXT" default="text">
  Output format

  One of: `text`, `json`, `jsonl`, `none`
</ParamField>

<ParamField body="--policy" type="TEXT | null" required>
  Backpressure policy to apply. Pass null to clear an existing policy.

  One of: `queue-on-full`, `reject-on-full`, `null`
</ParamField>

<ParamField body="--profile" type="TEXT">
  Use a specific stored profile for this command, overriding BASETEN\_PROFILE and the current profile
</ParamField>

<ParamField body="--team" type="TEXT">
  Team name or ID. Only valid with --model-name.
</ParamField>

<ParamField body="-v, --verbose" type="BOOL">
  Enable verbose logging
</ParamField>

### Examples

Reject requests once the queue is full

```sh theme={"system"}
baseten model environment update-request-backpressure --model-id <model-id> --environment production --policy reject-on-full
```

Clear the policy

```sh theme={"system"}
baseten model environment update-request-backpressure --model-id <model-id> --environment production --policy null
```

### Filter output with `--jq`

Print the resulting policy

```sh theme={"system"}
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`.