Authentication

The simplest way to authenticate. Opens your browser to authorize the CLI:

danube login

This displays a code like AB12-CDEF, prompts you to press Enter to open your browser, and waits for you to authorize. Once authorized, your API key is saved to ~/.danube/config.json. If you already have an API key (e.g. from the dashboard), save it directly:

danube login --api-key YOUR_API_KEY

The key is validated against the API before saving.

Environment Variable

Set DANUBE_API_KEY to skip the config file entirely. Ideal for CI/CD:

export DANUBE_API_KEY=YOUR_API_KEY
danube search "send email"

Per-Command Override

Pass --api-key on any command:

danube search "send email" --api-key YOUR_API_KEY

Config File

The CLI stores credentials in ~/.danube/config.json (permissions 600):

{
  "profiles": {
    "default": {
      "api_key": "YOUR_API_KEY"
    }
  }
}

Named Profiles

Use profiles for multiple accounts:

# Login to a named profile
danube login --profile work

# Use that profile
danube search "send email" --profile work

# Check active identity
danube whoami --profile work

# List all profiles
danube config profiles

Priority Order

API key is resolved in this order:

--api-key flag (highest)
DANUBE_API_KEY environment variable
Config file (~/.danube/config.json)

Commands

Command	Description
`danube login`	Authenticate via browser device code flow
`danube login --api-key YOUR_API_KEY`	Save an existing API key
`danube logout`	Remove stored credentials
`danube whoami`	Show current identity

Troubleshooting

'No API key found' error

Run danube login to authenticate, or set DANUBE_API_KEY environment variable.

Get Started

Organizations & Governance

Account

CLI

MCP Clients

SDKs & Integrations

Authentication

Environment Variable

Per-Command Override

Config File

Named Profiles

Priority Order

Commands

Troubleshooting

​Device Code Login

​API Key Login

​Environment Variable

​Per-Command Override

​Config File

​Named Profiles

​Priority Order

​Commands

​Troubleshooting

Device Code Login

API Key Login

Environment Variable

Per-Command Override

Config File

Named Profiles

Priority Order

Commands

Troubleshooting