Skip to main content

Search shared events

GET /api/shared-events/search

Search / List events for a shared conversation. Because non-viewable events (e.g. ConversationStateUpdateEvent) are filtered out after fetching, a single backend page may yield fewer items than limit. This method transparently fetches additional backend pages until the requested limit is reached or there are no more results.

Parameters​

NameInTypeRequiredDescription
conversation_idquerystringyes—
kind__eqquery`enumnull`no
timestamp__gtequery`stringnull`no
timestamp__ltquery`stringnull`no
sort_orderqueryEventSortOrderno—
page_idquery`stringnull`no
limitqueryintegerno—

Responses​

StatusDescription
200Successful Response
422Validation Error

Response body​

FieldTypeRequiredDescription
itemsEvent-Output[]yes—
next_page_id`stringnull`no

Operation ID: search_shared_events_api_shared_events_search_get