API Reference

Memory Clusters

Read the semantic clusters MemorySync maintains over this end user's memories.

Endpoint and query parameters

GET/memory/clusters

200 OK

Parameter	Type	Contract
`limit`	integer	Optional cluster ceiling.

Read clusters

import os
from memorysync import MemorySyncClient

client = MemorySyncClient(
    api_key=os.environ["MEMORYSYNC_API_KEY"],
    base_url="https://api.memorysync.io",
    project_id=os.environ["MEMORYSYNC_PROJECT_ID"],
    end_user_id="usr_7f3a9c2e",
)

clusters = client.clusters(limit=25)

Result handling

Each cluster carries its type, an optional label and its members. Clusters are keyed by classification and subject, so they follow the organization vocabulary. The SDKs return the payload unmodified.

Errors and next action

An end user with too few memories to cluster returns an empty set, which is a valid result.

Safety notes

Memory Graph

See explicit edges instead of groupings.

Summarize Memory

Persist a summary of a cluster.

← Previous