Skip to main content
Print the auth profile, email, and organization the CLI will use for its next request. Run it whenever you need to confirm which account is active before a destructive command or a script run.

Synopsis

talkvalue auth status

Options

None. To inspect a specific profile, use the global --profile flag.

Examples

1. Confirm the active account

talkvalue auth status
The table view shows the profile, email, organization, and login state. Use this before running anything that mutates data: person delete, import create, and so on.

2. Check status as JSON

talkvalue auth status --json
The JSON envelope is the right shape for parsing in scripts. The CLI exits 0 even when not logged in, so branch on data.loggedIn instead of the exit code.

3. Use in a shell guard

if [ "$(talkvalue auth status --json | jq -r '.data.loggedIn')" != "true" ]; then
  echo "Not signed in. Run 'talkvalue auth login' first." >&2
  exit 1
fi
A common pre-flight check for CI runners and pre-commit scripts that wrap CLI calls.

Response

{
  "data": {
    "profile": "you",
    "loggedIn": true,
    "memberEmail": "you@example.com",
    "orgId": "org_01HXXX...",
    "orgName": "Acme Inc.",
    "memberFirstName": "Ada",
    "teamMemberCount": 12
  }
}
memberFirstName and teamMemberCount come from a follow-up API call and only appear when the session is valid. When you’re signed out:
{
  "data": {
    "profile": null,
    "loggedIn": false
  }
}

See also