Documentation Index
Fetch the complete documentation index at: https://docs.gildea.ai/llms.txt
Use this file to discover all available pages before exploring further.
Base URL
Authentication
All endpoints (except health check) require an X-API-Key header. See Authentication.
Endpoints
Signals
| Method | Endpoint | Description |
|---|
| GET | /v1/signals | List signals — paginated, filtered |
| GET | /v1/signals/{signal_id} | Get signal — full decomposition |
Entities
| Method | Endpoint | Description |
|---|
| GET | /v1/entities | List entities — paginated, with composable filters |
| GET | /v1/entities/{name_or_id} | Get entity — full profile |
Themes
| Method | Endpoint | Description |
|---|
| GET | /v1/themes | List themes — all themes |
| GET | /v1/themes/{axis}/{label} | Get theme — detail with co-occurrences |
Search
| Method | Endpoint | Description |
|---|
| GET | /v1/search | Search — hybrid dense + sparse with rerank |
Embed
| Method | Endpoint | Description |
|---|
| POST | /v1/embed | Embed text — user text into Gildea’s vector space |
System
| Method | Endpoint | Description |
|---|
| GET | /v1/health | Health check — no auth required |
Common patterns
- Pagination: Cursor-based — see Pagination guide
- Filtering: Most list endpoints accept
entity, theme, and q filters
- Progressive disclosure: Use
include=evidence, include=embeddings, and verification_detail=full for more data
- Error format: Consistent
{"error": {"code", "message", "status"}} envelope
