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.
Request
- Base URLhttps://api.getmetacognition.com (the document declares no server; this is the origin it was published from)
- AuthHTTP bearer
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
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
Changes
No recorded changes to this operation across all 1 revision of this API.