v1

latestOpenAPI 3.1.0Apache-2.02026-07-17586455.2 KB
Documents

Mark the document as index-failed.

Service-owned status transition. The index_text_too_large code on a extraction_status='pending' row atomically advances extraction to 'complete' AND writes semantic_index_status='failed' so the durable row reflects the upload-pipeline sequence. Idempotent on retry; 409 on invalid source state.

post/v1/documents/{id}/index-failure

Path parameters

idstring uuid required

Request body

error_code'index_text_too_large' | 'extraction_empty' | 'unknown' required

Bounded semantic-index-layer failure code. index_text_too_large is the upload-pipeline shortcut for the case where extracted text exceeded the index byte cap before reaching POST /:id/index.

error_messagestring required
user_idstring required

Required. user_id.

Response

Marker write acknowledgement; durable row echoed.

idempotentboolean required