Get Feed Events
Read immutable Timeline events with bounded pagination and filters. Set review_only with unresolved_only to project the pending Memory Review Inbox; membership is determined by event type rather than presentation severity. Each pending review advertises allowed_actions, the conservative recommended_action for explicit approval, automatic_resolution=expired_no_change, and its absolute expires_at timestamp.
Query Parameters
Maximum events returned on this page.
int641 <= value <= 100050Zero-based result offset.
int640 <= value0Filter by presentation severity.
Filter by one exact event type.
Return only events that have not been resolved.
falseProject only actionable Timeline review families. Event type, not presentation severity, defines membership (Cloud/local parity).
falseNumber of recent date partitions to scan when no explicit range is supplied.
int641 <= value <= 36590Start of date range (YYYY-MM-DD). Overrides last_n_days lower bound.
End of date range (YYYY-MM-DD, inclusive). Defaults to today.
Filter by metadata.source value (e.g. 'library:source_id').
Filter by memory space. Feed storage stays global; matching is based on event metadata or related memories.
Return an exact total count. Set false for faster first-page loading when only page data and has_more are needed.
trueClient IANA timezone so date_from/date_to (local day strings from the
calendar/timeline) compare against each event's LOCAL day, not its UTC day.
Absent/unknown → UTC (prior behavior).
Response Body
application/json
application/json
curl -X GET "https://example.com/agent/feed/events"{ "events": [ null ], "has_more": true, "limit": 0, "offset": 0, "total": 0}{ "detail": [ { "loc": [ "string" ], "msg": "string", "type": "string", "input": null, "ctx": {} } ]}