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

# Authentication

> How API authentication works.

## Bearer token

Include your API key in every request:

```bash theme={null}
curl -H "Authorization: Bearer sk_live_abc123..." \
  https://app.alana.shopping/api/workspace/{workspaceId}/brands
```

## Error responses

| Status             | Description                                                                  |
| ------------------ | ---------------------------------------------------------------------------- |
| `401 Unauthorized` | Missing or invalid API key                                                   |
| `403 Forbidden`    | Valid key but insufficient permissions for the requested workspace or action |

```json theme={null}
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or expired API key"
  }
}
```