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

# HTTP Server

> Design and reference for cognee-http-server, the axum server mirroring the Python FastAPI surface under /api/v1/*.

Design and reference for `cognee-http-server`, the `axum` server that mirrors the
Python FastAPI surface under `/api/v1/*`. To **run or embed** it, start at
[HTTP Server Tools](/rust/tools/http-server). This page links to the detailed
upstream reference.

## Cross-cutting design

* **[Architecture](https://github.com/topoteretes/cognee-rs/blob/main/docs/http-server/architecture.md)** — crate topology, dual-surface design (library + binary), middleware stack, config lifecycle.
* **[auth.md](https://github.com/topoteretes/cognee-rs/blob/main/docs/http-server/auth.md)** — stub; the auth subsystem (JWT, fastapi-users parity, password-hash migration, bearer/cookie/api-key) lives in the closed `cognee-http-cloud` crate.
* **[pipelines.md](https://github.com/topoteretes/cognee-rs/blob/main/docs/http-server/pipelines.md)** — background job lifecycle, `PipelineRunRegistry`, status mapping, durable vs live events.
* **[websocket.md](https://github.com/topoteretes/cognee-rs/blob/main/docs/http-server/websocket.md)** — subscription model, status semantics, terminal close behavior.
* **[tenants.md](https://github.com/topoteretes/cognee-rs/blob/main/docs/http-server/tenants.md)** — stub; multi-tenant schema, permission model, and ACL resolution lives in the closed `cognee-http-cloud` crate.
* **[observability.md](https://github.com/topoteretes/cognee-rs/blob/main/docs/http-server/observability.md)** — span instrumentation and telemetry attributes for the server.

## Endpoints

* **[routers/](https://github.com/topoteretes/cognee-rs/blob/main/docs/http-server/routers/README.md)** — one reference doc per router. **20 routers live in OSS** (`crates/http-server/src/routers/`); **11 routers live in the closed `cognee-http-cloud` crate** (auth, auth-register, auth-reset-password, auth-verify, api-keys, users, users-by-email, permissions, configuration, sync, checks). The closed-router docs in `routers/` are stubs that point at the [`cognee-cloud-rs`](https://github.com/topoteretes/cognee-cloud-rs) repo.

Open design questions for these areas are tracked in
[Roadmap open questions](https://github.com/topoteretes/cognee-rs/blob/main/docs/roadmap/open-questions.md).