Grid commands are in pre-release and support macOS and Linux. Their arguments, flags, and output can change.
list
--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
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, noneTEXT
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
TEXT
Team name or ID. Omit to list across all accessible teams.
BOOL
Enable verbose logging
Examples
List members’ settings in a team:Filter output with --jq
Print each member’s limits:
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
--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
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, noneTEXT
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
default:"me"
User ID, or me for yourself.
BOOL
Enable verbose logging
Examples
Show your own settings:Filter output with --jq
Print your effective monthly limit:
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
--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
TEXT
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
TEXT | null
USD limit for the current UTC month; null removes the override.
TEXT
default:"text"
Output formatOne of:
text, json, jsonl, noneTEXT
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
default:"me"
User ID, or me for yourself.
TEXT | null
Standing monthly USD limit for this user in the team; null removes it.
BOOL
Enable verbose logging
Examples
Set a member’s standing monthly limit:Filter output with --jq
Clear and print your current-month override:
Output
Text mode (--output text): The updated user settings, in the same format as describe.
JSON mode (--output json): Returns the updated member settings.