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

conversationId

string

required

Conversation identifier

Request Body

entry_ids

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

data

array

Array of message objects matching the requested entry IDs

Show Message object

string

Unique message identifier

content

array

Array of content blocks

Show Content block

block_type

string

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

text

string

Text content (present when block_type is TEXT)

uri

string

Drive resource URI (present when block_type is IMAGE)

mime_type

string

MIME type (present when block_type is IMAGE)

metadata

object

Arbitrary key-value metadata attached to the message

timestamp

string

Caller-provided timestamp (ISO 8601)

conversation_id

string

ID of the conversation this message belongs to

sequence_no

integer

Position of this message within the conversation

actor_id

string

ID of the actor who sent this message

actor_type

string

Type of the actor: HUMAN or ASSISTANT

created_at

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"
    }
  ]
}

List Messages Overview

​Path Parameters

​Request Body

​Response

Path Parameters

Request Body

Response