Messages

List conversation messages

Changed on

Returns messages in a conversation. Requires messages:read and access to the conversation.

get/conversations/{conversationId}/messages

Request

  • Base URL
    https://api.ando.so/v1
  • URL
    https://api.ando.so/v1/conversations/{conversationId}/messages
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

Path parameters

conversationIdstring required

Conversation identifier.

Query parameters

limitinteger

Maximum number of records to return.

beforestring

Cursor or ISO timestamp before which results should be returned.

Response

Conversation messages.

conversation_idstring required

Conversation identifier.

conversation_namestring nullable required

Conversation name.

Example response

{
  "conversation_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
  "data": {
    "conversation_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
    "items": [
      {
        "authorWorkspaceMembershipId": "01jzn7e61x3a7v9h2r7t2m3q4p",
        "author_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
        "conversation_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
        "created_at": "2026-05-14T08:00:00.000Z",
        "id": "01jzn7e61x3a7v9h2r7t2m3q4p",
        "attachments": [
          {
            "file_id": "01jzn7e61x3a7v9h2r7t2m3q4p"
          }
        ],
        "forward_source": {
          "source_created_at": "2026-05-14T08:00:00.000Z"
        },
        "replied_to": {
          "message_id": "01jzn7e61x3a7v9h2r7t2m3q4p"
        }
      }
    ]
  },
  "items": [
    {
      "authorWorkspaceMembershipId": "01jzn7e61x3a7v9h2r7t2m3q4p",
      "author_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
      "conversation_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
      "created_at": "2026-05-14T08:00:00.000Z",
      "id": "01jzn7e61x3a7v9h2r7t2m3q4p",
      "attachments": [
        {
          "file_id": "01jzn7e61x3a7v9h2r7t2m3q4p"
        }
      ],
      "forward_source": {
        "source_created_at": "2026-05-14T08:00:00.000Z"
      },
      "replied_to": {
        "message_id": "01jzn7e61x3a7v9h2r7t2m3q4p"
      }
    }
  ]
}

Changes

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property // to the response with the status