Memories

List Episodes

List the caller's consolidated conversation episodes.

An episode is its CURRENT EPISODE_SUMMARY (one per consolidated episode window; superseded versions are skipped). Raw EPISODE_EVENT nodes are turns, not episodes, and are never listed here (paging past the summaries used to fall through to them). Episodes still in the active tier (not yet consolidated) are not listed yet. POST /ingestion/episode (episodes.store) stores its messages as remembered turns, so a stored episode is listed here once it is consolidated.

Cost and ordering: one request is ONE engine page of limit summaries at offset — never a walk of the tenant's data (GET /nodes scans the shard per call). The engine can neither order nor filter by time, so results come in engine order, and since filters WITHIN the page: a page may hold fewer than limit episodes while has_more (the engine returned a full page) is still true. Keep paging until has_more is false. Global newest-first ordering and an engine-side since need an engine query (label + owner + time range, sorted) — see the Package D report.

get/memories/episodes

Request

Query parameters

limitinteger
offsetinteger
sincestring nullable

Only episodes that ended at or after this time: ISO 8601 (e.g. 2026-01-01T09:30:00Z) or epoch seconds/milliseconds

Response

Successful Response

episodesobject[]
countinteger

Number of episodes returned

next_offsetinteger

Offset for next page

has_moreboolean

Whether a further page exists

Changes

No recorded changes to this operation across all 1 revision of this API.