MYmyaltimate
Knowledge Bases V2

Upload With Kb Creation

Create a new knowledge base with either file upload or markdown content.

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 and uploads content to S3
  2. Creates a new knowledge base
  3. Creates a document record (version 1)
  4. Returns KB and document info for async processing

The document processing (chunking, vectorization) happens asynchronously via Celery.

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

post/knowledge_bases/v2/upload

Request

  • Base URL
    https://api.myaltimate.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.myaltimate.com/knowledge_bases/v2/upload
  • Auth
    • HTTP bearer
    • or HTTP bearer

Request body multipart/form-data

namestring required
filestring binary nullable
markdown_contentstring nullable
descriptionstring nullable
privacy'public' | 'private'
chunking_strategystring nullable
iconstring nullable

Response

Successful Response

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

Changes

No recorded changes to this operation across all 149 revisions of this API.