TRtraversal
workers

List Worker Events

Changed on

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

Request

  • Base URL
    https://api.traversal.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.traversal.com/worker/{worker_id}/events
  • Auth
    none declared

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

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.

thread_idstring nullable

Scope the window to one chat thread (origin + replies). Off-window origins are attached as presentation=thread_origin.

Response

Successful Response

has_moreboolean required
has_more_newerboolean
anchor_foundboolean nullable
stream_cursorsobject nullable

Changes

  • 31e1a8b7cf89Revision changes
    • breaking

      added to the /// response property oneOf list for the response status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added usage_budget_updated discriminator mapping keys to the /// response property for the response status

  • 4fa2a4911e01Revision changes
    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status