Deliver an async converter result
POST/api/v1/documents/:document_id/ingestion-callback
Token-authed callback for a tool converter that deferred conversion by
returning { "status": "pending" } (see the Ingestion Rules module
docs). Not IAM-gated — the external converter is not a SOAT principal,
so it authenticates with the single-use token minted for this
document and ingestion attempt (delivered as callback.token /
embedded in callback.url in the original converter invocation).
Accepted only while the document is still awaiting that exact
attempt; rejected with 409 if the attempt already completed, timed
out, or was superseded by a re-ingest.
Request
Responses
- 204
- 401
- 404
- 409
- 422
Conversion completed — the document was chunked and marked ready (or failed with FILE_PARSE_FAILED if the output produced no text).
The token is missing, invalid, or does not match this document.
Document not found
The document is no longer awaiting this conversion attempt (already completed, timed out, or superseded by a re-ingest).
The output shape is unrecognized.