knowledge-base

Ingest documents (text, files, or mixed)

Unified document ingestion endpoint.

Accepts a multipart form with:

  • manifest (required): JSON array describing each item
  • files (optional): one or more file uploads, referenced by file_index in the manifest

Manifest format (JSON array):

[
  {"type": "file", "file_index": 0, "title": "Report"},
  {"type": "text", "title": "FAQ", "content": "What is..."},
  {"type": "file", "file_index": 1, "title": "Old Report", "document_id": "uuid"}
]
post/v1/knowledge-base/knowledge-bases/{kb_id}/ingest

Path parameters

kb_idstring uuid required

Response

Successful Response

ingestion_job_idstring uuid required

Changes

Changed in 1 of the 3 revisions of this API.6

    • added the optional property retry_after to the response with the 400 status

      response-optional-property-added

    • added the optional property retry_after to the response with the 401 status

      response-optional-property-added

    • added the optional property retry_after to the response with the 404 status

      response-optional-property-added

    • added the optional property retryable to the response with the 400 status

      response-optional-property-added

    • added the optional property retryable to the response with the 401 status

      response-optional-property-added

    • added the optional property retryable to the response with the 404 status

      response-optional-property-added

    This revision also has 40 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog