List conversation messages

import requests
url = "https://api.moveworks.ai/rest/v1beta1/conversations/conv_01ARZ3NDEKTSV4RRFFQ69G5FAV/messages"
headers = {
    "Assistant-Name": "acmecorp-conversations-rest-api",
    "Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.json())

{
  "messages": [
    {
      "message_id": "msg_01ARZ3NDEKTSV4RRFFQ69G5FAV",
      "conversation_id": "conv_01ARZ3NDEKTSV4RRFFQ69G5FAV",
      "response_id": "resp_01ARZ3NDEKTSV4RRFFQ69G5FAV",
      "actor": "ASSISTANT",
      "content": {
        "commonmark_text": {
          "text": "John Doe reports to Jane Smith in the Engineering department.",
          "fallback_text": "John Doe reports to Jane Smith in the Engineering department."
        }
      },
      "citations": [
        {
          "id": "user_123",
          "type": "person",
          "mention": "John Doe",
          "location": {
            "start": 0,
            "end": 8
          },
          "url": "https://workday.com/users/123"
        }
      ],
      "created_at": "2025-01-20T10:00:01Z"
    }
  ],
  "metadata": {
    "next_cursor": "eyJvZmZzZXQiOjIwfQ=="
  }
}

Retrieves all messages (both user and assistant) in a conversation in descending order by creation time (most recent first).

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_idstringRequiredformat: "^conv_[0-9A-HJKMNP-TV-Z]{26}$"

Unique conversation identifier (format: conv_<ulid>)

Headers

Assistant-NamestringRequired

The Moveworks assistant identifier that was configured for your organization.

Query parameters

cursorstringOptional

Opaque cursor for pagination

limitintegerOptional1-100Defaults to 50

Maximum number of messages to return (1-100)

Response

List of messages

messageslist of objects

metadataobject or null

Authentication

Path parameters

Headers

Query parameters

Response

Errors