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.
SIGNUP_DISABLEDSign-ups are currently disabled. Join the waitlist at https://getfloo.com.
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": {
    "email": "pat@example.com",
    "api_key": "floo_abc1...ef23",
    "name": "Pat"
  }
}

​
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 with an email address. An alternative to the browser-based sign-up flow. 
floo auth register you@example.com

​
JSON output

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

​
Errors

CodeMeaning
EMAIL_TAKENThis email is already registered. Use floo auth login to sign in.

​
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"
  }
}