Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.maximem.ai/llms.txt

Use this file to discover all available pages before exploring further.

await sdk.memories.get(memory_id)
Retrieve a single memory by its identifier. Returns the structured Memory object including content, confidence, and source-document metadata.

​
Parameters

​
memory_id
UUID
required
The memory ID. Typically obtained from memories.status (memory_ids) or from a recall result.

​
Returns

A Memory object.
​
memory_id
UUID
Unique memory identifier.
​
memory_type
string
Memory type: fact, preference, episode, emotion, or temporal_event.
​
content
string
The extracted memory content.
​
confidence
number
Confidence score of the extraction, between 0.0 and 1.0.
​
category
string
High-level category assigned by the extraction pipeline.
​
subcategory
string
More specific subcategory under category.
​
created_at
datetime
Timestamp of when this memory was created.
​
updated_at
datetime
Timestamp of the last update. None if never updated.
​
source_document_id
string
Identifier of the document this memory was extracted from.

​
Example

from maximem_synap import MaximemSynapSDK
from uuid import UUID

sdk = MaximemSynapSDK(api_key="synap_your_key_here")
await sdk.initialize()

memory = await sdk.memories.get(UUID("a1b2c3d4-e5f6-7890-abcd-ef0123456789"))
print(memory.memory_type)   # "preference"
print(memory.content)       # "Prefers light roast coffee, especially pour-over"
print(memory.confidence)    # 0.92

​
Raises

  • SynapAuthError — when the API key is missing or invalid.
  • SynapNotFoundError — when the memory_id does not exist or is outside the caller’s scope.

​
See also