For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
DeveloperAcademyCommunityStatus
    • Overview
    • API Credentials
    • Errors
    • Legacy & Deprecated APIs
  • Events API
    • Chat Markup
    • Rate Limits
    • Message Delivery
  • (Beta) Conversations API
      • GETList conversations
      • POSTCreate conversation
      • GETGet conversation
      • PATCHUpdate conversation
      • GETList conversation events
  • Data API
    • GETList conversations
    • GETList interactions
    • GETList plugins calls
    • GETList Plugin Resources
    • GETList Users
  • Webhook Listeners
  • Content Gateway
    • Overview
    • Integration Strategies
    • Starter Code
    • Verifying Your Build
    • Connecting Your Gateway to Moveworks
    • Authentication
    • How Permissions Work
    • Common Pitfalls
    • Operational Guide
    • Errors
    • Supported MIME Types
  • Legacy Gateways
    • Authentication
    • Response Options
    • Field Types
    • Form Gateway Errors
DeveloperAcademyCommunityStatus
(Beta) Conversations APIConversations

List conversation events

||View as Markdown|
GET
https://api.moveworks.ai/rest/v1beta1/conversations/:conversation_id/events
GET
/rest/v1beta1/conversations/:conversation_id/events
$curl https://api.moveworks.ai/rest/v1beta1/conversations/-/events \
>     -H "Assistant-Name: acmecorp-conversations-rest-api" \
>     -H "Authorization: Bearer <token>"
1{
2  "events": [
3    {
4      "event_id": "evt_019d85be-1a2b-7000-8000-000000000001",
5      "conversation_id": "conv_32bt7BMLhLyVzTUjfi35N",
6      "event_payload": {
7        "type": "MESSAGE_EVENT",
8        "message": {
9          "message_id": "msg_32bt8vagXAoRwRLIdI2Oj",
10          "conversation_id": "conv_32bt7BMLhLyVzTUjfi35N",
11          "response_id": "resp_32bt7rXXugeJjvE3pQzOk",
12          "actor": "ASSISTANT",
13          "content": {
14            "type": "COMMONMARK_TEXT",
15            "commonmark_text": {
16              "text": "Your password has been reset successfully."
17            }
18          },
19          "created_at": "2025-01-20T10:00:01Z",
20          "citations": []
21        }
22      }
23    }
24  ],
25  "metadata": {
26    "next_cursor": "eyJvZmZzZXQiOjIwfQ=="
27  }
28}
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 `starting_after` and `ending_at` to define a time range based on previously seen event IDs.
Was this page helpful?
Previous

Create response

Next
Built with

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 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.

Headers

Assistant-NamestringRequired
The Moveworks assistant identifier that was configured for your organization.

Query parameters

starting_afterstringOptional
Exclusive lower bound. Only events after this event ID are returned. Typically the last event ID from a previous poll.
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-uuidstring
A unique identifier used to trace your request within the Moveworks system

Response

List of events
eventslist of objects
Array of event objects, ordered chronologically
metadataobject

Errors

401
Unauthorized Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error