> ## 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 org team

> View teams

List and inspect the teams in the organization.

## describe

```sh theme={"system"}
baseten org team describe [OPTIONS]
```

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

### Options

{/* Do not hand-edit. Update OVERRIDES / NOTES / HIDDEN_FLAGS in the generator. */}

<ParamField body="-q, --jq" type="TEXT">
  Filter JSON output with a jq expression; implies --output json (or jsonl for streamed commands)
</ParamField>

<ParamField body="-o, --output" type="TEXT" default="text">
  Output format

  One of: `text`, `json`, `jsonl`, `none`
</ParamField>

<ParamField body="--profile" type="TEXT">
  Use a specific stored profile for this command, overriding BASETEN\_PROFILE and the current profile
</ParamField>

<ParamField body="--team-id" type="TEXT">
  Team ID to describe.

  Mutually exclusive with other flags in group `team-ref`.
</ParamField>

<ParamField body="--team-name" type="TEXT">
  Team name to describe.

  Mutually exclusive with other flags in group `team-ref`.
</ParamField>

<ParamField body="-v, --verbose" type="BOOL">
  Enable verbose logging
</ParamField>

### Examples

Describe a team by ID

```sh theme={"system"}
baseten org team describe --team-id <team-id>
```

Describe a team by name

```sh theme={"system"}
baseten org team describe --team-name <team-name>
```

### Filter output with `--jq`

Print the team's name

```sh theme={"system"}
baseten org team describe --team-id <team-id> --jq '.name'
```

### Output

**Text mode (`--output text`):** Field-per-line summary of the team.

**JSON mode (`--output json`):** payload type `managementapi.Team`.

## list

```sh theme={"system"}
baseten org team list [OPTIONS]
```

List the teams in the organization.

### Options

{/* Do not hand-edit. Update OVERRIDES / NOTES / HIDDEN_FLAGS in the generator. */}

<ParamField body="-q, --jq" type="TEXT">
  Filter JSON output with a jq expression; implies --output json (or jsonl for streamed commands)
</ParamField>

<ParamField body="-o, --output" type="TEXT" default="text">
  Output format

  One of: `text`, `json`, `jsonl`, `none`
</ParamField>

<ParamField body="--profile" type="TEXT">
  Use a specific stored profile for this command, overriding BASETEN\_PROFILE and the current profile
</ParamField>

<ParamField body="-v, --verbose" type="BOOL">
  Enable verbose logging
</ParamField>

### Examples

List all teams in the org

```sh theme={"system"}
baseten org team list
```

### Filter output with `--jq`

Print just the team names

```sh theme={"system"}
baseten org team list --jq '.teams[].name'
```

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