> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trytalkvalue.com/llms.txt
> Use this file to discover all available pages before exploring further.

# talkvalue auth switch

> Switch the active organization for the current profile without re-authenticating.

Move between organizations on the same profile without signing in again. The CLI uses your stored refresh token to mint a new access token scoped to the selected organization, then updates the profile record.

## Synopsis

```bash theme={null}
talkvalue auth switch [org]
```

## Arguments

| Argument | Type   | Description                                                                                    |
| -------- | ------ | ---------------------------------------------------------------------------------------------- |
| `org`    | string | Organization name or ID to switch to. When omitted, the CLI prompts you to pick from the list. |

## Examples

### 1. Pick interactively

```bash theme={null}
talkvalue auth switch
```

The CLI fetches your organizations and shows an arrow-key picker. After you confirm, output ends with `✓ Switched to Acme Inc.` on stderr and the JSON envelope on stdout.

### 2. Switch by name or ID

```bash theme={null}
talkvalue auth switch "Acme Inc."
talkvalue auth switch org_01HXXX...
```

Matches by name (case-insensitive) first, then by ID. Skips the picker entirely.

### 3. Combine with profile selection

```bash theme={null}
talkvalue auth switch "Production" --profile prod
```

Use the global `--profile` flag to switch the organization on a non-active profile without making it active first.

## Response

```jsonc theme={null}
{
  "data": {
    "orgId": "org_01HXXX...",
    "orgName": "Acme Inc.",
    "profile": "you"
  }
}
```

The new access token is stored in your system keyring and the profile record is updated with the selected `orgId` and `orgName`. Subsequent commands run against the new organization until you switch again.

If the active profile has no refresh token, the command fails and asks you to run `auth login`.

## See also

* [`talkvalue auth login`](/cli/commands/auth/login). Pick an organization during sign-in.
* [`talkvalue auth status`](/cli/commands/auth/status). Confirm which organization is active.
* [`talkvalue auth list`](/cli/commands/auth/list). See every saved profile and its organization.
* [Authentication](/cli/authentication). Multi-profile and multi-org workflow.