Re-ingest an existing document

POST 
/v1/projects/:project_id/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. Background by default (202); pass ?wait=true to run synchronously (201).

Request

Responses

201

Re-ingestion completed synchronously (only when ?wait=true).

202

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

401

Unauthorized

403

Forbidden

404

Document not found

409

The project's storage_bytes quota is exceeded (QUOTA_STORAGE_EXCEEDED). Delete stored content, or raise the quota — no window reset clears a stored total, so no Retry-After is sent.

413

The file is too large to re-ingest synchronously (?wait=true). Retry in background mode.