Endpoints
Ingest documents
Seed documents directly into the brain, bypassing the crawler — a thin seam for demos and tests.
POST/v1/ingest
Writes documents straight into the brain — chunk, embed, upsert — without the
crawler. It's the thin ingest seam: the durable ingestion plane (connectors
→ raw append-only log → derivation) is a separate workstream, but this endpoint
lets the brain be seeded and demoed today. Requires an internal_agent key.
Request body
Prop
Type
Each document:
Prop
Type
{
"documents": [
{
"docId": "handbook/refunds",
"text": "Refunds are processed within 5 business days…",
"classification": "internal",
"sourceSystem": "handbook"
},
{
"docId": "booking/5591",
"text": "Customer 5591 booked the Pro plan on 2026-06-02…",
"classification": "confidential",
"subjectId": "5591",
"sourceSystem": "billing"
}
]
}Response
Prop
Type
{ "ingested": 2, "namespaces": ["t_serviceagent"], "snapshotSeq": 10422 }Try it
POST http://localhost:8080/v1/ingest
The ACL tokens are computed from classification + subjectId at ingest — you
don't set them directly. A confidential doc with subjectId: "5591" becomes
visible to internal agents and to customer 5591, never to anonymous callers.
See Core concepts.