Documentation /docs/changelog/2026-06-29-docs-contract-corrections

2026-06-29: Docs Contract Corrections

This release corrects public documentation drift against the generated customer OpenAPI contract.

Corrected contracts

  • Upload examples now use repeated multipart field files and read files[0].file_id.
  • Parse examples now show the public doc_id, version, markdown, pages, regions, chunks, and metadata response shape.
  • Extract examples now use Schema V2 with doc_class, fields[], and tables[].
  • Extract result examples now show the ExtractionResult envelope with schema, result, grounding_mode, and page_count.
  • Async job examples now use pending, processing, completed, and failed; queued is not a public status.
  • Agent tool discovery is documented as GET /v1/agents/tools.
  • Ask is documented as POST /api/v1/ask.
  • Compare and Synthesize are now covered in workflow docs and API navigation.

Added guides

  • Limits & Quotas
  • Files & Page Images
  • OCR & Layout
  • Tables
  • Classify & Split
  • Charts & Equations
  • Compare & Synthesize
  • Agents