> ## 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 grid team-settings

> Read and manage team Grid settings (PRE-RELEASE)

> [!NOTE]
>
> Grid commands are in pre-release and support macOS and Linux. Their arguments, flags, and output can change.

## `describe`

```sh theme={"system"}
baseten grid team-settings describe [OPTIONS]
```

If you belong to one team, `--team` is optional. If you belong to several, specify a team.

### Options

**-q, --jq** `TEXT`

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

**-o, --output** `TEXT` (default: text)

Output format

One of: `text`, `json`, `jsonl`, `none`

**--profile** `TEXT`

Use a specific stored profile for this command, overriding BASETEN\_PROFILE and the current profile

**--team** `TEXT`

Team name or ID. Omit to use your only team; required when you belong to several.

**-v, --verbose** `BOOL`

Enable verbose logging

### Examples

Show your only team's settings:

```sh theme={"system"}
baseten grid team-settings describe
```

### Filter output with `--jq`

Print the harness defaults:

```sh theme={"system"}
baseten grid team-settings describe --jq '.harness_defaults'
```

### Output

**Text mode (`--output text`):** Team ID and name, monthly spend limits, and a table of harness default routes and their sources.

**JSON mode (`--output json`):** Returns the team's Grid settings.

## `update`

```sh theme={"system"}
baseten grid team-settings update [OPTIONS]
```

Only the fields you provide change. To configure a harness route, combine `--harness` with `--primary-route-id` or `--background-route-id`. Pass `null` to clear that route. `--clear-harness-defaults` clears the configured defaults for every harness.

Spend limits are exact dollar amounts. The per-member limit applies to members who don't have an individual limit. The team-wide limit covers all members' combined Grid spend; when the team reaches it, Baseten rejects every member's Grid requests in that team. Pass `null` to remove one limit, or use `--clear-spend-limit` to remove both. Updating settings requires team admin. Changing the team-wide limit requires organization admin.

If you belong to one team, `--team` is optional. If you belong to several, specify a team.

### Options

**--background-route-id** `TEXT | null`

Background route ID for Claude Code or OpenCode; null clears it. Requires --harness.

**--clear-harness-defaults** `BOOL`

Clear all configured harness defaults. Cannot be combined with --harness or route flags.

**--clear-spend-limit** `BOOL`

Clear both team spend limits. Requires organization admin. Cannot be combined with --per-member-monthly-limit-usd or --team-wide-monthly-limit-usd.

**--harness** `TEXT`

Harness whose default route IDs to update.

One of: `claude-code`, `codex`, `opencode`, `pi`

**-q, --jq** `TEXT`

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

**-o, --output** `TEXT` (default: text)

Output format

One of: `text`, `json`, `jsonl`, `none`

**--per-member-monthly-limit-usd** `TEXT | null`

Default monthly USD limit per member; null removes it.

**--primary-route-id** `TEXT | null`

Primary route ID; null clears the configured default. Requires --harness.

**--profile** `TEXT`

Use a specific stored profile for this command, overriding BASETEN\_PROFILE and the current profile

**--team** `TEXT`

Team name or ID. Omit to use your only team; required when you belong to several.

**--team-wide-monthly-limit-usd** `TEXT | null`

Team-wide monthly USD limit; null removes it. Requires organization admin.

**-v, --verbose** `BOOL`

Enable verbose logging

### Examples

Set the default monthly limit per member:

```sh theme={"system"}
baseten grid team-settings update --per-member-monthly-limit-usd 100
```

Set Codex's primary route:

```sh theme={"system"}
baseten grid team-settings update --harness codex --primary-route-id <route-id>
```

### Filter output with `--jq`

Clear and print the team-wide limit:

```sh theme={"system"}
baseten grid team-settings update --team-wide-monthly-limit-usd null --jq '.spend_limit'
```

### Output

**Text mode (`--output text`):** The updated team settings, in the same format as describe.

**JSON mode (`--output json`):** Returns the updated team settings.