Skip to main content
List and inspect the teams in the organization.

​
describe

Describe a single team. Pass exactly one of --team-id or --team-name.

​
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 ID to describe.Mutually exclusive with other flags in group team-ref.
​
TEXT
Team name to describe.Mutually exclusive with other flags in group team-ref.
​
BOOL
Enable verbose logging

​
Examples

Describe a team by ID
Describe a team by name

​
Filter output with --jq

Print the team’s name

​
Output

Text mode (--output text): Field-per-line summary of the team. JSON mode (--output json): payload type managementapi.Team.

​
list

List the teams in the organization.

​
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

List all teams in the org

​
Filter output with --jq

Print just the team names

​
Output

Text mode (--output text): Table with columns: ID, NAME, DEFAULT, CREATED. When no teams exist, prints “No teams found.” to stderr. JSON mode (--output json): payload type managementapi.Teams.