CaveauAI API

The CaveauAI API exposes the full power of the document intelligence platform through clean, RESTful endpoints. Everything you can do in the CaveauAI web interface — upload documents, create corpora, run queries, retrieve citations — is available programmatically.

API Architecture

The API follows REST conventions with JSON request/response bodies, bearer token authentication, and predictable resource-oriented URLs. Rate limiting is per-tenant, not per-endpoint, so you can burst queries during processing windows without hitting artificial ceilings.

Core Endpoints

• POST /corpora — Create a new corpus with metadata and access controls
• POST /corpora/{id}/documents — Upload documents for indexing
• POST /corpora/{id}/query — Ask questions and receive citation-backed answers
• GET /corpora/{id}/search — Semantic search across embedded documents
• GET /corpora/{id}/citations — Retrieve citation chains for audit trails

Integration Patterns

The API supports synchronous queries for real-time applications and webhook callbacks for batch processing. Most integrations start with the query endpoint and expand to document management as the use case matures.