Skip to main content
Grid commands are in pre-release and support macOS and Linux. Their arguments, flags, and output can change.

​
describe

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

​
Options

​
TEXT
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
​
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. Omit to use your only team; required when you belong to several.
​
BOOL
Enable verbose logging

​
Examples

Show your only team’s settings:

​
Filter output with --jq

Print the 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

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

​
TEXT | null
Background route ID for Claude Code or OpenCode; null clears it. Requires —harness.
​
BOOL
Clear all configured harness defaults. Cannot be combined with —harness or route flags.
​
BOOL
Clear both team spend limits. Requires organization admin. Cannot be combined with —per-member-monthly-limit-usd or —team-wide-monthly-limit-usd.
​
TEXT
Harness whose default route IDs to update.One of: claude-code, codex, opencode, pi
​
TEXT
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
​
TEXT
default:"text"
Output formatOne of: text, json, jsonl, none
​
TEXT | null
Default monthly USD limit per member; null removes it.
​
TEXT | null
Primary route ID; null clears the configured default. Requires —harness.
​
TEXT
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
​
TEXT
Team name or ID. Omit to use your only team; required when you belong to several.
​
TEXT | null
Team-wide monthly USD limit; null removes it. Requires organization admin.
​
BOOL
Enable verbose logging

​
Examples

Set the default monthly limit per member:
Set Codex’s primary route:

​
Filter output with --jq

Clear and print the team-wide 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.