List response messages

import requests
url = "https://api.moveworks.ai/rest/v1beta1/conversations/conv_01ARZ3NDEKTSV4RRFFQ69G5FAV/responses/resp_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"
    }
  ]
}

Retrieves all messages associated with a specific response (both the user’s input message and all assistant reply messages).

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

response_idstringRequiredformat: "^resp_[0-9A-HJKMNP-TV-Z]{26}$"

Unique response identifier (format: resp_<ulid>)

Headers

Assistant-NamestringRequired

The Moveworks assistant identifier that was configured for your organization.

Response

List of messages for this response

messageslist of objects

Authentication

Path parameters

Headers

Response

Errors