Visualize Live Events
Return search/improve events newer than a cursor, for the Memory tab’s live timeline.
Meant to be polled instead of re-fetching the whole GET /visualize/json payload just to refresh the timeline: pass the
previous response’s cursor back as since and only new events
come back. The filter is strict, so nothing is ever delivered twice.
Query Parameters
- dataset_id (UUID): authorization only, see above
- since (datetime, optional): cursor from a previous call
Response
{"events": [...], "cursor": <ISO datetime or null>}
Error Codes
- 403 Forbidden: Caller lacks read permission on the dataset (or it does not exist)
- 409 Conflict: Payload could not be built (generic message; full detail is server-logged, not returned, to avoid leaking internals)
Notes
- User must have read permissions on the dataset
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
UUID of the dataset this poll is for. Gates who may call this endpoint (same read-permission check as every other visualize route) — the events themselves are the caller's own, not filtered to this dataset's graph.
""
Cursor from a previous call's response. Omit on the first call to get every available event.
Response
Successful Response