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

# Manage named profiles

> Store separate CLI sessions and API environments, select the active profile, and switch organization context.

A profile stores an API URL and a default organization. Browser login caches a user token for that profile. One user token can access your memberships across organizations; you do not need a separate profile for every organization.

## Create a profile

Provide an API URL when you create a non-default profile:

```bash theme={null}
tolmo auth login --profile work --api-url https://api.tolmo.com
```

Existing profiles reuse their saved URL unless you override it. For a different Tolmo environment, sign in to a separate profile using that environment's API URL. Cached user tokens are bound to the issuing API origin.

## Select a profile

```bash theme={null}
tolmo --profile work findings list
export TOLMO_PROFILE=work
tolmo auth status
```

The resolution order is `--profile`, then `TOLMO_PROFILE`, then `default`. `auth status` reports the effective values and their sources.

## Switch organizations

```bash theme={null}
tolmo org list --profile work
tolmo org switch acme --profile work
tolmo --profile work --org other-org findings list
```

`org switch` saves the organization. `--org` overrides it for one command. `TOLMO_ORG_SLUG` also overrides the saved value.

## Credential storage

Profile settings live in `~/.tolmo/config`. Cached user tokens live under `~/.tolmo/cache/sso/`.

Organization API keys are supplied through `TOLMO_API_TOKEN`, not stored in profiles. When that variable is set, the CLI bypasses profile settings and cached credentials. See [Environment variables](/configuration/environment-variables).

## Sign out of a profile

```bash theme={null}
tolmo auth logout --profile work
```

Logout attempts server-side revocation and clears the cached user credential. It retains the profile's API URL and organization. Without `--profile`, it uses `TOLMO_PROFILE` or `default`, just like other commands.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.