Sign in
workers

List Private Chat Events

The caller's private-chat feed on this worker.

Addressed by the parent, never by the chat's own id — that row is storage. The owner comes from the session, so this cannot read anyone else's. A chat nobody has started is an empty feed with null stream_cursors, not a 404, so a client renders a composer and opens no socket without branching on existence.

Pass an empty seek object for the newest page. around_source + around_id centre the window on one event. An unreachable anchor 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}/private-chat/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