> ## 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 user

> View users

List and inspect the users in the organization.

## describe

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

Describe a single user. Pass exactly one of `--user-id` or `--user-email`. Pass `--user-id me` for the authenticated user.

### 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="--user-email" type="TEXT">
  Email of the user to describe.

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

<ParamField body="--user-id" type="TEXT">
  User ID to describe. Pass 'me' for the authenticated user.

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

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

### Examples

Describe the authenticated user

```sh theme={"system"}
baseten org user describe --user-id me
```

Describe a user by email

```sh theme={"system"}
baseten org user describe --user-email <email>
```

### Filter output with `--jq`

Print the user's email

```sh theme={"system"}
baseten org user describe --user-id me --jq '.email'
```

### Output

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

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

## list

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

List the users 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 users in the org

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

### Filter output with `--jq`

Print just the user emails

```sh theme={"system"}
baseten org user list --jq '.items[].email'
```

### Output

**Text mode (`--output text`):** Table with columns: USER ID, EMAIL, NAME. When no users exist, prints "No users found." to stderr.

**JSON mode (`--output json`):** payload type `cmd.OrgUserList`.