Upload a File
Uploads a file for asynchronous ingestion. Supported extensions: .pdf, .docx, .txt, .md, .xlsx, .xls.
A 202 does not mean indexed. The response returns as soon as the file is stored and the job is queued; parsing, chunking, embedding and upserting happen afterwards in a worker. Poll the document status endpoint until it reports ‘completed’ before expecting search to see the content.
There is no document update endpoint. Every upload mints a new document_id, so re-uploading the same file creates a second document while the first remains. To refresh material, delete the old document and upload again.
Path Parameters
Knowledge Base ID.
Body
Response
File accepted and queued for ingestion. Not yet searchable.
Acknowledgement that a document was accepted for asynchronous ingestion.
Server-minted identifier for the submitted document. Keep it - you need it to poll the status endpoint.
Always 'processing' at submission time.
processing, completed, failed Human-readable detail, for example 'File processing started'.

