API Reference

Intelligence Report

Read the themes, entities and patterns MemorySync has derived, across a recent window and the full stored set.

Endpoint and query parameters

GET/memory/intelligence

200 OK

Parameter	Type	Contract
`limit`	integer	Optional size of the recent window.
`scope`	string	Explicit scope. Nothing is inferred — omit it and you do not get it.
`project_id`	string	Optional project narrowing.

Read the report

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",
)

report = client.intelligence(scope="user", limit=200)

Dual-horizon response

meta reports the window size, the snapshot age and status, and the scope actually applied. Check snapshot_status before treating the global view as current. The SDKs return the payload unmodified.

Scope is explicit

scope is never inferred from the request. That is a deliberate contract: an intelligence report silently widening from one user to a whole tenant would leak conclusions across a boundary. If you do not name a scope, you do not get one.

Errors and next action

For 5xx or a stale snapshot_status, present the recent view alone rather than a mixed report.

Safety notes

Knowledge Stats

Counts rather than conclusions.

Memory Clusters

The groupings behind the themes.

← Previous

Resolve Decision