Skip to main content
Semantic memory is the durable, compounding layer of Brain: immutable episodes plus derived entities, claims, and relations. Reads prefer the GBrain semantic engine and fall back to the Postgres spine when it’s unavailable or mid-deletion.

​
Remember

POST /v1/brain/remember — write a durable memory episode; facts/entities/relations are extracted with provenance.
​
string
required
The memory content to record.
​
string
Optional title.
​
string
document | note | conversation | observation | maintenance.
​
string
Provenance tag.
​
number
0–1 confidence.
​
string
Target KB.

​
Recall

POST /v1/brain/recall — recall structured facts/entities/episodes.
​
string
required
The memory query.
​
string
Filter to one entity/subject.
​
string
ISO-8601 lower bound.
​
number
Max memories (1–50).
​
string
Target KB.

​
Think

POST /v1/brain/think — synthesize from semantic memory plus grounded document context, with gap notes. Extends recall with an optional session_id. Cost: 10 credits (runs an internal grounded query).

​
Graph

POST /v1/brain/graph — the entity/relation knowledge graph.
​
string
Center the graph on one entity.
​
number
Max nodes/edges (1–50).
​
string
Target KB.

​
Timeline

POST /v1/brain/timeline — memory events/facts in chronological order. Same parameters as graph.
recall, graph, timeline, and remember are free (plan quota still applies). think costs 10 credits.