Batch Get Messages - MemoryLake AI

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/conversations/conv_7d2e3f4a5b6c7d8e/messages/batch-get' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "entry_ids": [
      "msg_3f4a5b6c7d8e9f0a",
      "msg_9e4b2c3d5f6a7b8c"
    ]
  }'

{
  "success": true,
  "data": [
    {
      "id": "msg_3f4a5b6c7d8e9f0a",
      "content": [
        {
          "block_type": "TEXT",
          "text": "Can you summarize last quarter's revenue numbers?"
        }
      ],
      "metadata": {},
      "timestamp": "2025-06-01T14:10:00Z",
      "conversation_id": "conv_7d2e3f4a5b6c7d8e",
      "sequence_no": 3,
      "actor_id": "actor_user_jane",
      "created_at": "2025-06-01T14:10:05Z"
    },
    {
      "id": "msg_9e4b2c3d5f6a7b8c",
      "content": [
        {
          "block_type": "TEXT",
          "text": "Q1 revenue was $12.5M, up 15% from the previous quarter."
        }
      ],
      "metadata": {},
      "timestamp": "2025-06-01T14:10:30Z",
      "conversation_id": "conv_7d2e3f4a5b6c7d8e",
      "sequence_no": 4,
      "actor_id": "actor_assistant_v2",
      "created_at": "2025-06-01T14:10:32Z"
    }
  ]
}

POST /openapi/memorylake/api/v3/conversations/{conversationId}/messages/batch-get

Retrieves multiple messages from a conversation in a single request. Pass a list of message entry IDs and receive the corresponding messages. This is more efficient than calling Get Message individually when you need several specific messages.

Permission required: project:conv_read

Path Parameters

string

required

Conversation identifier

Request Body

array

required

List of message entry IDs to retrieve. Maximum 100 entries per request.

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/conversations/conv_7d2e3f4a5b6c7d8e/messages/batch-get' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "entry_ids": [
      "msg_3f4a5b6c7d8e9f0a",
      "msg_9e4b2c3d5f6a7b8c"
    ]
  }'

Response

array

Array of message objects matching the requested entry IDs

Show Message object

string

Unique message identifier

array

Array of content blocks

Show Content block

string

Block type: TEXT, FILE, IMAGE, THINKING, TOOL_USE, TOOL_RESULT

string

Text content (present when block_type is TEXT)

string

Drive resource URI (present when block_type is IMAGE)

string

MIME type (present when block_type is IMAGE)

object

Arbitrary key-value metadata attached to the message

string

Caller-provided timestamp (ISO 8601)

string

ID of the conversation this message belongs to

integer

Position of this message within the conversation

string

ID of the actor who sent this message

string

Type of the actor: HUMAN or ASSISTANT

string

Creation timestamp

{
  "success": true,
  "data": [
    {
      "id": "msg_3f4a5b6c7d8e9f0a",
      "content": [
        {
          "block_type": "TEXT",
          "text": "Can you summarize last quarter's revenue numbers?"
        }
      ],
      "metadata": {},
      "timestamp": "2025-06-01T14:10:00Z",
      "conversation_id": "conv_7d2e3f4a5b6c7d8e",
      "sequence_no": 3,
      "actor_id": "actor_user_jane",
      "created_at": "2025-06-01T14:10:05Z"
    },
    {
      "id": "msg_9e4b2c3d5f6a7b8c",
      "content": [
        {
          "block_type": "TEXT",
          "text": "Q1 revenue was $12.5M, up 15% from the previous quarter."
        }
      ],
      "metadata": {},
      "timestamp": "2025-06-01T14:10:30Z",
      "conversation_id": "conv_7d2e3f4a5b6c7d8e",
      "sequence_no": 4,
      "actor_id": "actor_assistant_v2",
      "created_at": "2025-06-01T14:10:32Z"
    }
  ]
}

​Path Parameters

​Request Body

​Response

Path Parameters

Request Body

Response