latestOpenAPI 3.1.02026-08-223321,1001.6 MB

2134ebffd1ef

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.

get/worker/{worker_id}/private-chat/events

Path parameters

worker_idstring required

Query parameters

limitinteger

Number of events per page

Number of events per page

before_occurred_atstring date-time nullable

Cursor timestamp

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.

Cursor source

before_idstring nullable

Cursor tie-break id

Cursor tie-break id

searchstring nullable

Case-insensitive substring search over chat message text

Case-insensitive substring search over chat message text

Response

Successful Response

has_moreboolean required
stream_cursorsobject nullable