brain_memory_get

Tool

brain_memory_get

Get one memory by id (product+agent scoped)

Behavior

HTTP: GET /brain/memory/:memory_id

Arguments

Name	Type	Required	Description
memory_id	string	•	Engine memory id

Response

Field	Type	Always	Description
tags	array	•	Engine tags on this memory; empty when it carries none
layer	string	•	Engine memory layer (l0_basic_info…l7_intention)
custom	object	•	Free-form metadata, verbatim as the writer passed brain_memory_add's `metadata`; keys are the caller's
source	string	•	Which store answered the read — 'vdb' the vector store, 'graph' the memory graph. Diagnostic; the content is the same either way.
status	string	•	Engine lifecycle status of the row — 'active' for a memory in use
content	string	•	The memory text itself
user_id	string	•	Engine user namespace the memory was written under
agent_id	string	•	Engine agent namespace the memory was written under
is_latest	boolean	•	True when this is the current version of the memory; false when a newer one has replaced it
memory_at	number	•	When the remembered EVENT happened, epoch milliseconds; null when the writer stated no time
memory_id	string	•	Engine id of this memory — the id that was asked for
speculate	string	•	The engine's own inference about this memory, or null when it recorded none
confidence	number	•	The engine's confidence in this memory, 0..1
elapsed_ms	number	•	How long the engine took to answer, milliseconds
request_id	string	•	Engine request id for this call — quote it when reporting a problem
supersedes	array	•	Ids of the memories this one replaced; null when it replaced none
gmt_created	number	•	When this memory row was written, epoch milliseconds
superseded_by	array	•	Ids of the memories that replaced this one; null while it is still current
source_authority	string	•	Source authority (highest→lowest): policy > official > team > informal
source_raw_memory_id	string	•	Id of the l1_raw memory this one was derived from; null when it was written directly

Try it

Get one memory by id (product+agent scoped).

When to use

Get one memory by id (product+agent scoped)

Example

Ask your agent something like this:

Get one memory by id (product+agent scoped).

The agent will invoke brain_memory_get with these arguments:

{
  "memory_id": "<memory_id>"
}