conversations

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.

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.

get/conversations/{conversation_id}/events

Request

  • Base URL: https://api.moveworks.ai/assistant/v1
  • URL: https://api.moveworks.ai/assistant/v1/conversations/{conversation_id}/events
  • Auth: HTTP bearer

Path parameters

conversation_idstring required

Conversation identifier. Use "-" to read events across all conversations.

Query parameters

starting_afterstring

Exclusive lower bound. Only events after this event ID are returned. Typically the last event ID from a previous poll. A base-62 identifier prefixed by a short resource type. When supplied, results are returned oldest first; when omitted, results are returned newest first.

ending_atstring

Inclusive upper bound. Only events up to and including this event ID are returned. Must be greater than starting_after. A base-62 identifier prefixed by a short resource type.

cursorstring

Pagination cursor from a previous response.

limitinteger

Maximum number of events to return per page (1-100, default: 20).

Headers

Assistant-Namestring required

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.