Skip to main content
All API requests require a Bearer token in the Authorization header.

Get your API key

  1. Go to dashboard.floom.dev/settings
  2. Click Create API Key
  3. Copy the key (starts with floom_)
API keys are shown once. Store it securely. If lost, revoke and create a new one.

Use the key

Add this header to every request:
Authorization: Bearer floom_YOUR_API_KEY
Example:
curl -X GET "https://dashboard.floom.dev/api/automations" \
  -H "Authorization: Bearer floom_YOUR_API_KEY"

Key storage for AI agents

The floom skill stores the key at ~/.claude/floom-config.json:
{
  "api_key": "floom_YOUR_KEY",
  "platform_url": "https://dashboard.floom.dev"
}

Error responses

StatusMeaning
401Missing or invalid API key
401API key has been revoked
403Key valid but no access to this resource