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

​
describe

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

​
-q, --jq
TEXT
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
​
-o, --output
TEXT
default:"text"
Output formatOne of: text, json, jsonl, none
​
--profile
TEXT
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
​
--user-email
TEXT
Email of the user to describe.Mutually exclusive with other flags in group user-ref.
​
--user-id
TEXT
User ID to describe. Pass ‘me’ for the authenticated user.Mutually exclusive with other flags in group user-ref.
​
-v, --verbose
BOOL
Enable verbose logging

​
Examples

Describe the authenticated user 
baseten org user describe --user-id me
Describe a user by email 
baseten org user describe --user-email <email>

​
Filter output with --jq

Print the user’s email 
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

baseten org user list [OPTIONS]
List the users in the organization.

​
Options

​
-q, --jq
TEXT
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
​
-o, --output
TEXT
default:"text"
Output formatOne of: text, json, jsonl, none
​
--profile
TEXT
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
​
-v, --verbose
BOOL
Enable verbose logging

​
Examples

List all users in the org 
baseten org user list

​
Filter output with --jq

Print just the user emails 
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.