​
Format catalog

GET /v1/ingest/formats — public.
​
max_bytes
integer
Maximum upload size.
​
formats
object[]
Each: extensions, MIME types, unit kind, and parser availability.

​
Ingest a document

POST /v1/ingest — multipart/form-data, requires auth.
​
file
file
required
The binary document (PDF, Excel, Word, CSV, JSON, Markdown, text).
​
title
string
default:"\"\""
Returns a report of what happened: how much text was read, how many pieces were stored, claims found (or still processing), how long it took, and any warnings. 
curl -X POST https://host/v1/ingest \
  -H "Authorization: Bearer $JWT" \
  -F "file=@paper.pdf" \
  -F "title=My paper"
Errors
StatusMeaning
400Empty file
413File exceeds formats.MAX_BYTES
415Unsupported format
PDF/Excel/Word need the ingest extra. Markdown, CSV, JSON, and text work with the core install. Missing parsers degrade gracefully.