List conversation events

{
  "events": [
    {
      "event_id": "evt_019d85be-1a2b-7000-8000-000000000001",
      "conversation_id": "conv_32bt7BMLhLyVzTUjfi35N",
      "event_payload": {
        "type": "MESSAGE_EVENT",
        "message": {
          "message_id": "msg_32bt8vagXAoRwRLIdI2Oj",
          "conversation_id": "conv_32bt7BMLhLyVzTUjfi35N",
          "response_id": "resp_32bt7rXXugeJjvE3pQzOk",
          "actor": "ASSISTANT",
          "content": {
            "type": "COMMONMARK_TEXT",
            "commonmark_text": {
              "text": "Your password has been reset successfully."
            }
          },
          "created_at": "2025-01-20T10:00:01Z",
          "citations": []
        }
      }
    }
  ],
  "metadata": {
    "next_cursor": "eyJvZmZzZXQiOjIwfQ=="
  }
}

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.

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_idstringRequired

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

Query parameters

starting_afterstringOptional

Exclusive lower bound. Only events after this event ID are returned. Typically the last event ID from a previous poll. When supplied, results are returned oldest first; when omitted, results are returned newest first.

ending_atstringOptional

Inclusive upper bound. Only events up to and including this event ID are returned. Must be greater than starting_after.

cursorstringOptional

Pagination cursor from a previous response.

limitintegerOptional1-100Defaults to 20

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

Response headers

x-moveworks-root-uuidstringOptional

A unique identifier used to trace your request within the Moveworks system

Response

List of events

eventslist of objects

Array of event objects in creation order: newest first without starting_after, oldest first with starting_after.

metadataobject

Errors

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error