> ## 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 user-settings

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

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

## `list`

```sh theme={"system"}
baseten grid user-settings list [OPTIONS]
```

List members across teams you administer. Use `--team` to select one team. In scripts that expect results from one team, always pass `--team`. This command requires team admin or organization admin.

### 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 list across all accessible teams.

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

Enable verbose logging

### Examples

List members' settings in a team:

```sh theme={"system"}
baseten grid user-settings list --team <id>
```

### Filter output with `--jq`

Print each member's limits:

```sh theme={"system"}
baseten grid user-settings list --jq '.items[].spend_limit'
```

### Output

**Text mode (`--output text`):** Table with USER, EMAIL, TEAM ID, TEAM NAME, MONTH SPEND, EFFECTIVE LIMIT, and BLOCKED BY columns. Lists all pages; empty results print a message to stderr.

**JSON mode (`--output json`):** Returns an `items` array of member settings.

## `describe`

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

By default, this command shows your settings (`--user-id me`). Reading another user's settings requires team admin or organization admin. If you belong to one team, `--team` is optional. If you belong to several, specify a team.

The current-month override takes precedence over the member's standing limit. Without either, the team's per-member limit applies. The team-wide limit is independent: when the team reaches it, Baseten blocks every member even if they haven't reached their individual effective limit. `blocked_by` reports `member` or `team` so you can tell which limit stopped requests.

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

**--user-id** `TEXT` (default: me)

User ID, or me for yourself.

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

Enable verbose logging

### Examples

Show your own settings:

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

### Filter output with `--jq`

Print your effective monthly limit:

```sh theme={"system"}
baseten grid user-settings describe --jq '.spend_limit.effective'
```

### Output

**Text mode (`--output text`):** User and team identifiers, monthly spend, standing and override limits, effective limit, and blocked status.

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

## `update`

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

By default, this command updates your settings (`--user-id me`). Updating any member's limits, including your own, requires team admin or organization admin.

Only the limits you provide change. Pass `null` to clear a limit, and provide dollar amounts as exact decimal values. A current-month override supersedes the standing limit until the UTC month ends or you clear the override. 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)

**--month-override-usd** `TEXT | null`

USD limit for the current UTC month; null removes the override.

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

**--user-id** `TEXT` (default: me)

User ID, or me for yourself.

**--user-monthly-limit-usd** `TEXT | null`

Standing monthly USD limit for this user in the team; null removes it.

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

Enable verbose logging

### Examples

Set a member's standing monthly limit:

```sh theme={"system"}
baseten grid user-settings update --team <id> --user-id <id> --user-monthly-limit-usd 100
```

### Filter output with `--jq`

Clear and print your current-month override:

```sh theme={"system"}
baseten grid user-settings update --month-override-usd null --jq '.spend_limit'
```

### Output

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

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