Skip to main content

​
describe

Describe the organization’s training GPU limits and current usage, per GPU type. Per-team limits are listed below the organization totals when any are set.

​
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
​
BOOL
Enable verbose logging

​
Examples

Describe training GPU capacity

​
Filter output with --jq

Print the organization’s H100 limit

​
Output

Text mode (--output text): An organization table with columns: GPU TYPE, IN USE, LIMIT, BASELINE, then a per-team table with a leading TEAM column when teams have limits set. JSON mode (--output json): payload type managementapi.GetTrainingGpuCapacityResponse.

​
update

Update the maximum concurrent GPUs of one type that a team may use. The limit is per GPU type, so raising H100 leaves other types alone.

​
Options

​
TEXT
required
GPU type the limit applies to (for example H100).
​
TEXT
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
​
INTEGER
required
Maximum concurrent GPUs of this type the team may use.
​
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
required
Team name or ID whose limit changes.
​
BOOL
Enable verbose logging

​
Examples

Raise a team’s H100 limit

​
Filter output with --jq

Print the applied limit

​
Output

Text mode (--output text): On success, prints the team, GPU type, and new limit to stderr; no stdout output. JSON mode (--output json): payload type managementapi.PatchTeamTrainingGpuCapacityResponse.