Captures

Push a chat turn

Submit a single chat turn for worthiness classification. The service decides whether the turn contains durable knowledge and only captures it if so, which keeps conversational filler out of the brain.

Authentication

x-api-keystring

Your Living Brain API key. Create one from the dashboard; keys are scoped to an organization and carry the role of the member they were issued to.

Path parameters

brainIdstringRequired
Brain id

Headers

x-subject-idstringRequired
Identifies the end user the request is made on behalf of. Brains are owned by a subject, so this determines which brains the caller can see.

Request

This endpoint expects an object.
textstringRequired
Raw chat turn text
senderenumRequired
Who produced the turn
agentNamestringOptional
Agent display name for classifier context
originRefstring or nullOptional

Idempotency key for the turn (e.g. chat:<id>:<ts>)

sourceobjectOptional
Opaque provenance

Response

worthyboolean
Whether the turn was deemed worth capturing
reasonstring

Classifier reasoning (or drop reason)

sourceIdstringOptional
Created ingest source id when worthy

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
429
Too Many Requests Error