ingestion
Batch ingest multiple documents
Enqueue multiple text documents for background ingestion in a single request. Each item is processed as an individual document.
Returns a job_id. Poll GET /v1/jobs/{job_id} for status.
post/v1/tables/{table_name}/ingest/batch
Path parameters
table_namestring required
Example:legal_contracts
Table name or slug
Request body
Example request
{
"items": [
{
"title": "My Research Notes",
"content": "# Introduction\n\nThis document covers...",
"tags": [
"research",
"ml"
]
}
]
}Response
Ingestion job queued
Example response
{
"job_id": "job_abc123",
"status": "queued",
"progress": "Building document tree...",
"result": {
"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
}
},
"error": "Failed to parse document",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:30:05Z"
}