Skip to main content
Authenticate with the floo API and manage your account.

​
login

Authenticate with the floo API. Opens your browser for device code OAuth by default. 
floo auth login
The CLI displays a one-time code, opens your browser, and waits for you to complete authentication. Your API key is stored at ~/.floo/config.json.

​
Flags

FlagDescription
--api-key KEYUse an existing API key instead of browser auth (for scripts and agents)
--forceSkip existing key validation and force re-authentication

​
Examples

# Interactive (opens browser)
floo auth login

# Non-interactive (for scripts and CI)
floo auth login --api-key floo_abc123...

# Force re-authenticate even if already logged in
floo auth login --force

​
JSON output

{
  "success": true,
  "data": {
    "email": "you@example.com"
  }
}

​
Errors

CodeMeaning
DEVICE_CODE_EXPIREDThe device code expired before authentication completed. Run floo auth login again.
DEVICE_AUTH_DENIEDAuthorization was denied in the browser.
WAITLISTEDYour account is on the waitlist. You’ll be notified when access is granted.
CONFIG_ERRORFailed to save credentials. Check ~/.floo/config.json permissions.

​
logout

Clear stored credentials from ~/.floo/config.json. 
floo auth logout

​
JSON output

{
  "success": true,
  "data": null
}

​
whoami

Show the currently authenticated user, including email, masked API key, and display name. 
floo auth whoami

✓ Logged in as Pat (pat@example.com, key: floo_abc1...ef23)

​
JSON output

{
  "success": true,
  "data": {
    "user_id": "u1a2b3c4-...",
    "email": "pat@example.com",
    "name": "Pat",
    "effective_scope": "full"
  }
}

​
Errors

CodeMeaning
NOT_AUTHENTICATEDNo stored credentials. Run floo auth login.

​
token

Print the raw API key to stdout. Useful for piping into other tools. 
floo auth token
In human mode, prints the raw key to stdout (no formatting). In --json mode: 
{
  "success": true,
  "data": {
    "api_key": "floo_abc123..."
  }
}

​
Errors

CodeMeaning
NOT_AUTHENTICATEDNo stored credentials. Run floo auth login.

​
register

Create a new floo account for the given email address. Used by floo auth login in the signup path; can also be called directly. 
floo auth register you@example.com

​
JSON output

{
  "success": true,
  "data": {
    "email": "you@example.com"
  }
}

​
update-profile

Update your display name. 
floo auth update-profile --name "Pat"

​
Flags

FlagDescription
--name NAMENew display name

​
JSON output

{
  "success": true,
  "data": {
    "name": "Pat"
  }
}