# API

ELS Compass exposes a FastAPI service under `/api/aibs/`. The reference below
covers the base surface, the identity boundary, request and response shapes, the
shared response models, and the error payload format.

| Page | What it covers |
| --- | --- |
| [HTTP API reference](http-api.md) | Base surface, identity boundary, documented endpoints, response models, error codes and contract boundaries. |

```{warning}
The reference is not yet complete. It documents 36 routes, while the service
currently exposes 54. Undocumented areas include notices, workspace and system
statistics, system health, upload batches, cleanup jobs, source-projection
consistency, chat cancellation, conversation drafts and conversation source
binding. Treat the service itself as authoritative until these are written up.
```

```{toctree}
:maxdepth: 2
:hidden:

http-api
```