Skip to main content
Nowledge MemNowledge Mem

Get Feed Events

GET
/agent/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

limit?Limit

Maximum events returned on this page.

Formatint64
Range1 <= value <= 1000
Default50
offset?Offset

Zero-based result offset.

Formatint64
Range0 <= value
Default0
severity?|

Filter by presentation severity.

event_type?|

Filter by one exact event type.

unresolved_only?Unresolved Only

Return only events that have not been resolved.

Defaultfalse
review_only?boolean

Project only actionable Timeline review families. Event type, not presentation severity, defines membership (Cloud/local parity).

Defaultfalse
last_n_days?Last N Days

Number of recent date partitions to scan when no explicit range is supplied.

Formatint64
Range1 <= value <= 365
Default90
date_from?|

Start of date range (YYYY-MM-DD). Overrides last_n_days lower bound.

date_to?|

End of date range (YYYY-MM-DD, inclusive). Defaults to today.

source?|

Filter by metadata.source value (e.g. 'library:source_id').

space_id?|

Filter by memory space. Feed storage stays global; matching is based on event metadata or related memories.

include_total?Include Total

Return an exact total count. Set false for faster first-page loading when only page data and has_more are needed.

Defaulttrue
tz?string

Client 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,  "journal_incomplete": true,  "limit": 0,  "offset": 0,  "total": 0}