Skip to main content
POST
/
memory-stores
/
{store_id}
/
memories
from hx import Client

client = Client()

client.memory.add(
    store_id="ms-your-store-id",
    user_id="user_123",
    messages=[
        {
            "role": "user",
            "content": "My name is Alex."
        }
    ],
    metadata={
        "type": "identity",
        "field": "name",
        "confidence": "explicit"
    }
)

{
  "results": [
    {
      "id": "mem_abc123",
      "memory": "User's name is Alex",
      "event": "ADD"
    }
  ],
  "message": "Memories processed successfully"
}
Extract and store memories from conversation messages.
​
store_id
string
required
Memory Store ID
​
messages
array
required
Conversation messages to extract memories from. Each message has role (user/assistant/system) and content.
​
user_id
string
User identifier for memory scoping
​
agent_id
string
Agent identifier for memory scoping
​
run_id
string
Run/session identifier
​
metadata
object
Additional metadata to attach to memories
from hx import Client

client = Client()

client.memory.add(
    store_id="ms-your-store-id",
    user_id="user_123",
    messages=[
        {
            "role": "user",
            "content": "My name is Alex."
        }
    ],
    metadata={
        "type": "identity",
        "field": "name",
        "confidence": "explicit"
    }
)

{
  "results": [
    {
      "id": "mem_abc123",
      "memory": "User's name is Alex",
      "event": "ADD"
    }
  ],
  "message": "Memories processed successfully"
}