Knowledge Bases
Upload document
Upload a document to a knowledge base. The document is processed through a pipeline:
- Upload — File is stored in S3
- Parse — Text is extracted from the file (PDF, DOCX, TXT, MD, CSV, JSON supported)
- Chunk — Text is split into ~2200 character chunks with sentence-boundary overlap
- Embed — Each chunk is converted to a 3072-dimension vector using Google Gemini embeddings
- Index — Vectors are upserted into the Qdrant collection for semantic search
The endpoint returns the document record immediately after processing completes. If parsing or embedding fails, the document is marked as FAILED with an error message.
Supported file types: PDF, DOCX, TXT, MD, CSV, JSON
Maximum file size: 50 MB
post/knowledge-bases/{id}/documents
Request
- Base URL: https://api.telvana.com
- URL: https://api.telvana.com/knowledge-bases/{id}/documents
- Auth: API key in header x-api-key
Path parameters
idstring required
Example:kb_abc123
Knowledge base ID
Response
Document uploaded and processed successfully
Changes
No recorded changes to this operation across all 1 revision of this API.