Give a Dyva specialized knowledge by uploading documents. Files are chunked, embedded, and used for RAG during conversations.
Every route and HTTP method below was checked directly against the live ts-api source on August 13, 2026. Response bodies are illustrative examples, never captured responses.
Base URL
https://api.dyva.ai/v1/v1/knowledge/:dyva_id/uploadUpload a document you own the Dyva for. Rejects binary content (including PDF) with a 415: plain text only. This page previously documented this path as /v1/knowledge/:dyva_id/documents; the live route is /upload, not nested under /documents.
Route and method verified directly against the live ts-api source on August 13, 2026.
Path and query parameters (1)
dyva_idstringRequiredRequest body (1)
filefileRequiredResponse
Illustrative example, not a captured response{
"id": "doc_EXAMPLE00001",
"dyva_id": "dyva_00000001",
"filename": "product-faq.txt",
"file_size": 8192,
"chunk_count": 5,
"status": "ready",
"created_at": "2026-03-09T14:22:08.000Z"
}Examples (2)
curl -X POST https://api.dyva.ai/v1/knowledge/dyva_00000001/upload \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-F "[email protected]"/v1/knowledge/:dyva_idList knowledge base documents for a Dyva you own. Returns a plain array; there is no pagination on this endpoint. This page previously documented this path with a trailing /documents segment, which does not exist.
Route and method verified directly against the live ts-api source on August 13, 2026.
Path and query parameters (1)
dyva_idstringRequiredResponse
Illustrative example, not a captured response[
{
"id": "doc_EXAMPLE00001",
"dyva_id": "dyva_00000001",
"filename": "product-faq.txt",
"file_size": 8192,
"chunk_count": 5,
"status": "ready",
"created_at": "2026-03-09T14:22:08.000Z"
},
{
"id": "doc_EXAMPLE00002",
"dyva_id": "dyva_00000001",
"filename": "return-policy.md",
"file_size": 2048,
"chunk_count": null,
"status": "processing",
"created_at": "2026-03-08T09:15:33.000Z"
}
]/v1/knowledge/:dyva_id/:doc_idDelete a document and its embeddings. Cannot be undone. This page previously nested this path under /documents/; the live route has the document id directly after the Dyva id.
Route and method verified directly against the live ts-api source on August 13, 2026.
Path and query parameters (2)
dyva_idstringRequireddoc_idstringRequiredResponse
Illustrative example, not a captured responseHTTP/1.1 204 No Content