List conversation events
Returns system-initiated messages (async responses and proactive notifications) for a conversation. Only final messages are returned, not transient or reasoning messages.
Use `conversation_id = "-"` to query across all conversations. This is useful for reconciliation after receiving a webhook event, to fetch the full set of messages that may have been missed.
Results are ordered chronologically. Use `start_event_id` and `last_event_id` to define a time range based on previously seen event IDs.
Authentication
AuthorizationBearer
JWT bearer token authentication. Obtain an access token from the Moveworks auth endpoint and include it in the Authorization header as ‘Bearer <token>’.
Path parameters
conversation_id
Conversation identifier. Use ”-” to read events across all conversations.
Headers
Assistant-Name
The Moveworks assistant identifier that was configured for your organization.
Query parameters
start_event_id
Exclusive lower bound. Only events after this event ID are returned. Typically the last_event_id from a previous poll.
last_event_id
Inclusive upper bound. Only events up to and including this event ID are returned. Must be greater than start_event_id.
cursor
Pagination cursor from a previous response.
limit
Maximum number of events to return per page (1-100, default: 20).
Response headers
x-moveworks-root-uuid
A unique identifier used to trace your request within the Moveworks system
Response
List of events
events
Array of event objects, ordered chronologically
metadata
Errors
401
Unauthorized Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error