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

# Authentication

> How to authenticate with the floom API.

All API requests require a Bearer token in the `Authorization` header.

## Get your API key

1. Go to [dashboard.floom.dev/settings](https://dashboard.floom.dev/settings)
2. Click **Create API Key**
3. Copy the key (starts with `floom_`)

<Warning>
  API keys are shown once. Store it securely. If lost, revoke and create a new one.
</Warning>

## Use the key

Add this header to every request:

```bash theme={null}
Authorization: Bearer floom_YOUR_API_KEY
```

Example:

```bash theme={null}
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`:

```json theme={null}
{
  "api_key": "floom_YOUR_KEY",
  "platform_url": "https://dashboard.floom.dev"
}
```

## Error responses

| Status | Meaning                                  |
| ------ | ---------------------------------------- |
| `401`  | Missing or invalid API key               |
| `401`  | API key has been revoked                 |
| `403`  | Key valid but no access to this resource |