Append Conversation Message

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/conversations/conv_7d2e3f4a5b6c7d8e/messages' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "content": [
      {
        "block_type": "TEXT",
        "text": "Can you summarize last quarter'\''s revenue numbers?"
      }
    ],
    "actor_id": "actor_user_jane",
    "timestamp": "2025-06-01T14:10:00Z",
    "metadata": {
      "source": "web-app"
    }
  }'

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/conversations/conv_7d2e3f4a5b6c7d8e/messages' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "content": [
      {
        "block_type": "TEXT",
        "text": "Here is the chart for your review."
      },
      {
        "block_type": "IMAGE",
        "uri": "drive://items/item_abc123/chart.png",
        "mime_type": "image/png"
      }
    ],
    "actor_id": "actor_assistant_v2",
    "timestamp": "2025-06-01T14:10:30Z"
  }'

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/conversations/conv_7d2e3f4a5b6c7d8e/messages' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "content": [
      {
        "block_type": "TEXT",
        "text": "Good point — I'\''ve updated the figures in the attached version."
      }
    ],
    "actor_id": "actor_user_jane",
    "parent_message_id": "msg_9e4b2c3d5f6a7b8c"
  }'

{
  "success": true,
  "data": {
    "id": "msg_3f4a5b6c7d8e9f0a",
    "content": [
      {
        "block_type": "TEXT",
        "text": "Can you summarize last quarter's revenue numbers?"
      }
    ],
    "metadata": {
      "source": "web-app"
    },
    "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"
  }
}

POST /openapi/memorylake/api/v3/conversations/{conversationId}/messages

Appends a new message to a conversation. Each message contains one or more content blocks (text, file, or both) and is attributed to an actor. MemoryLake automatically processes new messages to extract structured facts.

Permission required: project:conv_append

Path Parameters

conversationId

string

required

Conversation identifier

Request Body

content

array

required

Array of content blocks that make up the message body. Each block must include a block_type field.Accepted block_type values: TEXT, FILE, IMAGE, THINKING, TOOL_USE, TOOL_RESULT.Text block: { "block_type": "TEXT", "text": "message content" }Image block: { "block_type": "IMAGE", "uri": "drive://...", "mime_type": "image/png" }

actor_id

string

required

ID of the actor sending this message. Should reference an actor participating in the conversation.

timestamp

string

ISO 8601 timestamp for when the message originally occurred. Use this when ingesting historical conversations so MemoryLake preserves the original timeline.

metadata

object

Arbitrary key-value metadata to attach to the message

custom_id

string

required

Caller-defined unique identifier for the message within the conversation

parent_message_id

string

ID of the parent message, for threaded conversations. When set, this message is treated as a reply to the specified parent.

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/conversations/conv_7d2e3f4a5b6c7d8e/messages' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "content": [
      {
        "block_type": "TEXT",
        "text": "Can you summarize last quarter'\''s revenue numbers?"
      }
    ],
    "actor_id": "actor_user_jane",
    "timestamp": "2025-06-01T14:10:00Z",
    "metadata": {
      "source": "web-app"
    }
  }'

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/conversations/conv_7d2e3f4a5b6c7d8e/messages' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "content": [
      {
        "block_type": "TEXT",
        "text": "Here is the chart for your review."
      },
      {
        "block_type": "IMAGE",
        "uri": "drive://items/item_abc123/chart.png",
        "mime_type": "image/png"
      }
    ],
    "actor_id": "actor_assistant_v2",
    "timestamp": "2025-06-01T14:10:30Z"
  }'

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/conversations/conv_7d2e3f4a5b6c7d8e/messages' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "content": [
      {
        "block_type": "TEXT",
        "text": "Good point — I'\''ve updated the figures in the attached version."
      }
    ],
    "actor_id": "actor_user_jane",
    "parent_message_id": "msg_9e4b2c3d5f6a7b8c"
  }'

Response

data

object

Show Message object

string

Unique message identifier

content

array

Array of content blocks that make up the message body

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 of the image (present when block_type is IMAGE)

metadata

object

Arbitrary key-value metadata attached to the message

timestamp

string

Caller-provided timestamp for when the message originally occurred (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": {
      "source": "web-app"
    },
    "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"
  }
}

Import Documents Search Memories

​Path Parameters

​Request Body

​Response

Path Parameters

Request Body

Response