docs(ingest): blank scans and text-free photos fail with E2002 (PRO-2456)

[adityashrivastavaa]

Part of PRO-2456. Merge only when the companion code ships: hydra-db/hydradb-application#2057 (Go Stage A, which serves POST /context/ingest documents) and hydra-db/cortex-ingestion#911.

What changes for customers

The "Supported file formats" section of ingest-context said:

A scanned page with nothing readable on it, or a photo that happens to contain no text, will index as an empty document rather than fail.

That was never quite true. LiteParse emitted an empty ```text code fence for such pages, and that fence was what got indexed. With the fence fixed, a binary file with no extractable text now ends errored with E2002. Customers see the message "No text content could be extracted from your file. Please ensure it isn't empty or image-only." It is terminal: the same file gives the same result. A multi-page scan with readable text on any page still indexes normally.

Changes

• api-reference/v2/endpoint/ingest-context.mdx: replace that sentence with the actual behaviour, linking to the error code.
• api-reference/v2/error-responses.mdx: add an E2002 row to the ingestion error-codes table (meaning, user message, terminal).

Not changed: connector and app-source docs. The other PRO-2456 work, Gemini transcription and description of connector image attachments, changes no API surface or behaviour that customers call directly.

🤖 Generated with Claude Code

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
cortex-ai	🟢 Ready	View Preview	Oct 6, 2026, 5:00 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

[github-actions]

✅ Mintlify Hygiene

No issues found.

[greptile-apps]

Confidence Score: 5/5

[Low risk] Documents error code behavior in the API reference.

The documentation changes appear safe to merge when the companion code ships, as the PR description requires.

Summary

The PR updates the ingestion documentation to say that scans and images with no extractable text end in terminal E2002, rather than indexing as empty documents.

• Adds the error’s meaning, customer-facing message, and terminal status to the ingestion error-code table.

_{Reviews (2) · Last reviewed commit: "docs(ingest): blank scans and text-free ..."}

[openhack-agent]

✅ OpenHack Summary

Security review of docs(ingest): blank scans and text-free photos fail with E2002 (PRO-2456). 2 changed files; 0 findings at or above the low reporting threshold.

0   0   0   0

Confidence Score: 5/5

No reportable security findings were detected in this scan.

Security merge-readiness rubric: 1 = critical, 2 = high, 3 = medium, 4 = low, 5 = no reportable findings. This score reflects scan findings, not a guarantee of correctness or complete coverage.

Files Needing Attention: None

Important Files Changed

• api-reference/v2/endpoint/ingest-context.mdx (modified)
• api-reference/v2/error-responses.mdx (modified)

Last reviewed commit: 4fb2032 · View review on OpenHack

---

TIP: Mention @openhack-agent in a PR comment to request a review or ask a question. Use @openhack-agent fix all for every finding, or @openhack-agent fix unresolved threads for open review threads only.

[openhack-agent]

OpenHack reviewed this commit. See the OpenHack Summary for the confidence score and fix actions.