v1

latestOpenAPI 3.0.3MIT OR Apache-2.02026-07-17203670.3 KB
ingestion

Ingest a file (multipart upload)

Upload a document file for ingestion. Supports PDF, Word, Excel, PowerPoint, images (with OCR), audio files (with transcription), HTML, and more via MarkItDown.

The multipart body only needs the file field.

post/v1/tables/{table_name}/ingest/file

Path parameters

table_namestring required
Example:legal_contracts

Table name or slug

Response

File ingested successfully

document_idstring

Unique document ID

titlestring

Document title

total_nodesinteger

Total number of nodes in the tree

max_depthinteger

Maximum depth of the tree

Example response

{
  "document_id": "doc_abc123",
  "title": "Machine Learning Fundamentals",
  "total_nodes": 42,
  "max_depth": 4,
  "stats": {
    "chars_extracted": 50000,
    "chunks_created": 25,
    "nodes_created": 42,
    "summaries_generated": 42,
    "total_time_ms": 5230
  }
}