memories.get

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

UUID

required

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

Returns

A Memory object.

UUID

Unique memory identifier.

string

Memory type: fact, preference, episode, emotion, or temporal_event.

string

The extracted memory content.

number

Confidence score of the extraction, between 0.0 and 1.0.

string

High-level category assigned by the extraction pipeline.

string

More specific subcategory under category.

datetime

Timestamp of when this memory was created.

datetime

Timestamp of the last update. None if never updated.

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.

Introduction

Lifecycle

Memory ingestion

Memory management

Conversation

Conversation context

Scoped context

User profile

Real-time streaming

Cache management

Credits & billing

Reference

Limits & Pricing

Parameters

Returns

Example

Raises

See also

​Parameters

​Returns

​Example

​Raises

​See also

Parameters

Returns

Example

Raises

See also