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

# Settings and API Keys

> Manage team-scoped API access and CLI profiles.

The **Settings → API Keys** page manages API access for teams, local CLI profiles, and env-backed credentials. Settings is organized as a side navigation with General, Members, API Keys, Account, and Integrations sections — see [Teams and Members](/docs/platform/teams) for team management.

## Recommended: CLI Login

```bash theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
onyx login
```

The browser login flow lets you choose a team and creates or selects the matching local profile.

## Env-Backed Profiles

Use this path when you create or rotate a key in the app:

```bash theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
export ONYX_TEAM_API_KEY="onyx_..."
onyx profile set-api-key-env team ONYX_TEAM_API_KEY
```

The profile keeps team metadata locally but reads the secret from your environment.

## Direct Environment Overrides

Use direct overrides for scripts or CI jobs:

```bash theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
export ONYX_API_KEY="onyx_..."
export ONYX_API_URL="https://app.onyxresearch.ai"
onyx status
```

## Key Actions

| Action | Effect                                                      |
| ------ | ----------------------------------------------------------- |
| Create | Shows a one-time secret for the selected team.              |
| Rotate | Invalidates the old secret and shows a new one-time secret. |
| Revoke | Stops the key from authenticating.                          |

Store secrets in a password manager, shell secret store, or CI secret manager. Onyx only shows the secret once.
