Re-ingest an existing document

POST 
/api/v1/documents/:document_id/ingest

Re-runs ingestion for an existing document against its already-stored source file. Existing chunks are discarded and the document is reset to status=pending before re-processing. Use this to recover a document stuck in processing/failed or to re-chunk with a different strategy without re-uploading the file. Async by default (202); pass ?async=false to run synchronously (201).

Request

Responses

201

Re-ingestion completed synchronously (only when ?async=false).

202

Re-ingestion accepted. The document was reset to status=pending and processing runs in the background. Poll GET /api/v1/documents/{document_id}/status.

401

Unauthorized

403

Forbidden

404

Document not found

413

The file is too large to re-ingest synchronously (?async=false). Retry in async mode.