List conversation messages

curl https://api.moveworks.ai/rest/v1beta1/conversations/conv_32bt7BMLhLyVzTUjfi35N/messages \
     -H "Assistant-Name: acmecorp-conversations-rest-api" \
     -H "Authorization: Bearer <token>"

{
  "messages": [
    {
      "message_id": "msg_32bt8vagXAoRwRLIdI2Oj",
      "conversation_id": "conv_32bt7BMLhLyVzTUjfi35N",
      "response_id": "resp_32bt7rXXugeJjvE3pQzOk",
      "actor": "ASSISTANT",
      "content": {
        "type": "COMMONMARK_TEXT",
        "commonmark_text": {
          "text": "John Doe reports to Jane Smith in the Engineering department."
        }
      },
      "created_at": "2025-01-20T10:00:01Z",
      "citations": [
        {
          "location": {
            "offset": 8
          },
          "url": "https://workday.com/users/123",
          "display": {
            "title": {
              "type": "COMMONMARK_TEXT",
              "commonmark_text": {
                "text": "<https://workday.com/users/123|Jon Doe>"
              }
            },
            "body": {
              "type": "COMMONMARK_TEXT",
              "commonmark_text": {
                "text": "John Doe reports to Jane Smith in the Engineering department."
              }
            }
          }
        }
      ]
    },
    {
      "message_id": "msg_32bt8vagXAoRwRLIdI2Oj",
      "conversation_id": "conv_32bt7BMLhLyVzTUjfi35N",
      "response_id": "resp_32bt7rXXugeJjvE3pQzOk",
      "actor": "USER",
      "content": {
        "type": "PLAIN_TEXT",
        "plain_text": {
          "text": "Who does John Doe report to?"
        }
      },
      "created_at": "2025-01-20T10:00:00Z"
    },
    {
      "message_id": "msg_55bt8vagXAoRwRLIdI2Oj",
      "conversation_id": "conv_32bt7BMLhLyVzTUjfi35N",
      "response_id": "resp_32bt7rXXugeJjvE3pQzOk",
      "actor": "ASSISTANT",
      "content": {
        "type": "COMMONMARK_TEXT",
        "commonmark_text": {
          "text": "You report to John Doe"
        }
      },
      "created_at": "2025-01-20T09:00:01Z"
    },
    {
      "message_id": "msg_32bt8vagXAoRwRLIdI2Oj",
      "conversation_id": "conv_32bt7BMLhLyVzTUjfi35N",
      "response_id": "resp_77bt7rXXugeJjvE3pQz77",
      "actor": "USER",
      "content": {
        "type": "PLAIN_TEXT",
        "plain_text": {
          "text": "Who is my manager"
        }
      },
      "created_at": "2025-01-20T09:00:00Z"
    }
  ],
  "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_idstringRequired

A base-62 identifier prefixed by a short resource type

Headers

Assistant-NamestringRequired

The Moveworks assistant identifier that was configured for your organization.

Query parameters

cursorstringOptional

Opaque cursor for pagination

limitintegerOptional1-100Defaults to 20

Maximum number of messages to return (1-100)

Response headers

x-moveworks-root-uuidstring

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

Response

List of messages

messageslist of objects

Array of messages

metadataobject

Metadata (pagination)

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error