ReferenceIngestion
Upload a file
Accepts PDF, DOCX, XLSX, CSV, TXT, Markdown and images.
Scanned PDFs and images go through OCR automatically.
Returns immediately with status: "pending"; indexing (extract → scan →
chunk → embed → extract entities) continues in the background. Poll the
upload or subscribe to memory.ingest.completed.
x-api-key<token>
A platform key (ck_live_…) — reaches every memory in the tenant.
In: header
Query Parameters
space_id?string
Tag the file to a space and scope its chunks accordingly.
vault_id?string
Pin to a department instead of auto-classifying.
Request Body
multipart/form-data
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/api/v1/memory/uploads" \ -F file="string"{ "upload_id": "string", "filename": "string", "size_bytes": 0, "status": "pending", "vault_id": "string", "created_at": "2019-08-24T14:15:22Z"}Was this page helpful?Report an issue