What this family does
Each organization gets its own model trained over its knowledge graph.POST /v1/brain/query runs one forward pass and returns the glass-box result: the focal nodes the model settled on, a cosine top-K head to compare against, gate confidence, drift rate and the propagation tier.
GET /v1/brain/info reports what is loaded and the state of the most recent train. POST /v1/brain/answer generates a voice-conditioned written answer. POST /v1/brain/train enqueues a retrain and requires admin.
Routes
Headers that apply here
Neither header is declared as an OpenAPI parameter, so neither appears in the generated schema tables.X-Exo-Subjectis refused on the routes here that scope by the key owner. Sending it returns 400subject_not_supportedrather than reading the wrong partition.
The shape of a call
Check what is loaded.Traps
The whole family refusesX-Exo-Subject. These routes read the key owner’s own content. An explicit selector returns 400 subject_not_supported rather than being silently ignored, which would read the wrong partition.
Query needs a trained brain. No artifact yet is 404. An artifact that has just been published and is still being picked up is 409.
One train per organization at a time. A second request while one is queued or running is 409. A train that fails its numerical parity gate is not published, so the previous brain keeps serving.
Related
API reference
Base URL, authentication, and the conventions every route shares.
Errors
The problem envelope and the full code catalogue.