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. A live agent's replies arrive here as well, as MESSAGE_EVENT events whose message has actor LIVE_AGENT; there is no separate event type for them.
Pass a conversation_id to list the events of that conversation only, or use conversation_id = "-" to query across all of the user's conversations. Querying across all conversations is useful for reconciliation after receiving a webhook event, to fetch the full set of messages that may have been missed. Listing a single conversation is eventually consistent: an event may appear shortly after it is created. Querying with "-" returns every event as soon as it is created.
Without starting_after, events are returned newest first (descending creation order). With starting_after, events are returned oldest first (ascending creation order). ending_at limits the range but does not change the order. Use starting_after and ending_at to define a time range based on previously seen event IDs. When listing a single conversation, both events must belong to that conversation.
Request
- Base URL: https://api.moveworks.ai/rest/v1
- URL: https://api.moveworks.ai/rest/v1/conversations/{conversation_id}/events
- Auth: HTTP bearer
Path parameters
Conversation identifier, to list the events of that conversation only. Use "-" to read events across all conversations.
Query parameters
Exclusive lower bound. Only events after this event ID are returned. Typically the last event ID from a previous poll. When listing a single conversation, the event must belong to that conversation. A base-62 identifier prefixed by a short resource type. When supplied, results are returned oldest first; when omitted, results are returned newest first.
Inclusive upper bound. Only events up to and including this event ID are returned. Must be an event created after starting_after. When listing a single conversation, the event must belong to that conversation. A base-62 identifier prefixed by a short resource type.
Pagination cursor from a previous response.
Maximum number of events to return per page (1-100, default: 20).
Headers
The Moveworks assistant identifier that was configured for your organization.
Response
List of events
Changes
No recorded changes to this operation across all 1 revision of this API.