Knowledge Bases

Upload document

Upload a document to a knowledge base. The document is processed through a pipeline:

  1. Upload — File is stored in S3
  2. Parse — Text is extracted from the file (PDF, DOCX, TXT, MD, CSV, JSON supported)
  3. Chunk — Text is split into ~2200 character chunks with sentence-boundary overlap
  4. Embed — Each chunk is converted to a 3072-dimension vector using Google Gemini embeddings
  5. 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

messagestring

Changes

No recorded changes to this operation across all 1 revision of this API.