v5

latestOpenAPI 3.1.02026-08-081,0211,3082.1 MB
Knowledge Bases V2

Upload To Existing Kb

Upload a new document version to an existing knowledge base.

This endpoint supports two modes:

  1. File Upload: Provide 'file' parameter with document (PDF, DOCX, MD, TXT)
  2. Markdown Content: Provide 'markdown_content' parameter with markdown text

Process:

  1. Validates knowledge base exists and user has access
  2. Creates document record (gets version number)
  3. Uploads content to S3 with kb_id/version path
  4. Updates document with S3 path
  5. Returns document info for async processing

The new version will become active only after processing completes successfully. The previous version remains active until the new one is ready.

Note: You must provide either 'file' OR 'markdown_content', but not both.

post/knowledge_bases/v2/{kb_id}/upload

Path parameters

kb_idinteger required

Response

Successful Response

successboolean required
document_idinteger required
document_public_idstring required
knowledge_base_idinteger required
versioninteger required
processing_statusstring required
celery_task_idstring nullable
messagestring nullable