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

# Authentication

> Authenticate API requests with an organization-scoped API key.

Include your API key in every request:

```http theme={null}
X-API-Key: <your-api-key>
```

Keys are scoped to your organization — all data is automatically filtered to that org.

<Info>
  API keys are created and managed exclusively through the BuildingSwell UI (Organization settings → API keys) — there is no public API for managing keys. The secret is shown exactly once at creation time and cannot be retrieved again, so store it immediately.
</Info>