Sign in
workers

List Worker Events

A window of this worker's merged event feed, newest-first.

Pass an empty seek object for the newest page. around_source + around_id centre the window on one event, which is what a link to a message resolves through. They are a source and an id rather than a position: the ordering key is not a stable identifier, so a link built from one would break the moment ordering changed. An anchor that cannot be reached returns the newest page with anchor_found false, never an error and never a scan. An around request addresses the unfiltered feed and ignores search.

get/worker/{worker_id}/events

Path parameters

worker_idstring required

Query parameters

before_occurred_atstring date-time nullable

Older-direction cursor timestamp

before_source'resident_agent_event' | 'transcript_summary_events' | 'chatbot_messages'

Feed-layer discriminator for which table a feed row came from.

This is a feed concept, distinct from the cursor-stream source protocol: the feed renders persisted rows (including non-streamable chatbot_messages), it does not tail cursor streams. These values are the canonical vocabulary bound into worker_feed_dao._FEED_QUERY.

before_idstring nullable

Older-direction cursor tie-break id

after_occurred_atstring date-time nullable

Newer-direction cursor timestamp

after_source'resident_agent_event' | 'transcript_summary_events' | 'chatbot_messages'

Feed-layer discriminator for which table a feed row came from.

This is a feed concept, distinct from the cursor-stream source protocol: the feed renders persisted rows (including non-streamable chatbot_messages), it does not tail cursor streams. These values are the canonical vocabulary bound into worker_feed_dao._FEED_QUERY.

after_idstring nullable

Newer-direction cursor tie-break id

around_source'resident_agent_event' | 'transcript_summary_events' | 'chatbot_messages'

Feed-layer discriminator for which table a feed row came from.

This is a feed concept, distinct from the cursor-stream source protocol: the feed renders persisted rows (including non-streamable chatbot_messages), it does not tail cursor streams. These values are the canonical vocabulary bound into worker_feed_dao._FEED_QUERY.

around_idstring nullable

Id of the event to centre the window on

limitinteger

Number of events per page

Number of events per page

searchstring nullable

Case-insensitive chat search. Free text matches message text; from:name filters by sender. Queries under 3 characters return no results. Ignored when around_source and around_id are set: an around request addresses the unfiltered feed.

Case-insensitive chat search. Free text matches message text; from:name filters by sender. Queries under 3 characters return no results. Ignored when around_source and around_id are set: an around request addresses the unfiltered feed.

Response

Successful Response

has_moreboolean required
has_more_newerboolean
anchor_foundboolean nullable
stream_cursorsobject nullable

Changes