Skip to main content
Sign in through the browser, exchange the code for an access token, pick an organization, and save a profile. Run this once per machine before any other command.

​
Synopsis

talkvalue auth login [--org <name-or-id>]

​
Options

FlagTypeDescription
--org <name-or-id>stringOrganization name or ID. Skip the interactive picker when you already know which workspace you want.

​
Examples

​
1. Interactive sign-in

talkvalue auth login
The CLI prints a one-time code, opens your default browser to the verification page, and waits for you to approve. After approval it polls for the token, lists your organizations, and prompts you to pick one. Output ends with ✓ Logged in as you@example.com (Acme Inc.).

​
2. Pre-select an organization

talkvalue auth login --org "Acme Inc."
talkvalue auth login --org org_01HXXX...
Matches by name (case-insensitive) or by ID. The picker is skipped entirely, which is useful for scripts that need to re-bind a profile to a known organization.

​
3. CI environments

For CI you typically skip auth login and use an API token instead: 
export TALKVALUE_TOKEN=<your-token>
talkvalue path person list --json
A token in the environment takes precedence over any saved profile. See Authentication for the precedence table.

​
Response

{
  "data": {
    "email": "you@example.com",
    "loggedIn": true,
    "orgId": "org_01HXXX...",
    "orgName": "Acme Inc.",
    "profile": "you"
  }
}
The access token is stored in your system keyring (Keychain on macOS, libsecret on Linux, Credential Manager on Windows). The profile record on disk holds the organization ID, organization name, your email, and the auth method, never the token itself.

​
See also