caveauAI API
Programmatic Access to Document Intelligence
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.
Technical Details
- RESTful JSON API with OpenAPI 3.0 specification
- Bearer token authentication with per-tenant rate limiting
- Webhook callbacks for async document processing
- An MCP server for agent hosts (@bluenotelogic/mcp on npm); the REST API works from any HTTP client
- Documents, retrieval and embeddings run on servers Blue Note Logic operates, with EU or regional hosting available — query answers are generated through our model gateway, which routes to external model providers
Services for caveauAI API
Document Intelligence Consulting
We help organisations design, deploy, and optimise caveauAI implementations — from corpus architecture to embedding strategy to production deployment.
Learn more
AI Systems Integration
We design and implement the integration layer between caveauAI and your existing systems — ERPs, CRMs, document management platforms, and custom applications.
Learn moreRelated Products
caveauAI
Turn the documents your team relies on into a private, citation-backed AI. Every answer quotes the exact passage it came from, your corpus stays isolated per tenant, and model routing is yours to control — from small language models to frontier — with EU or regional hosting available.
Learn more
AI Integration
Embed caveauAI intelligence directly into ERPs, CRMs, document management systems, and custom applications through pre-built connectors and middleware.
Learn more
Synthetic Data Studio
Create statistically faithful synthetic datasets for model training, testing, and compliance — without ever exposing production data to development environments.
Learn moreReady to Put This to Work?
Bring the documents, the workflow, or the integration question. We will tell you whether caveauAI API is enough on its own or needs a broader Blue Note Logic rollout.
Get in Touch