Store memories from a conversation, like mem0's add

Store memories from a conversation, like mem0's add: an AI model extracts durable facts about the user from the messages (or, with infer=false, stores each message as is), embeds them and saves them privately under your memory_key (a secret string you generate; required). Identical facts are stored once. Needs at least one of user_id, agent_id, app_id, run_id. Memories are kept for 365 days. Returns {event_id, status, results:[{id, memory, event: ADD|NONE}]}.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

POST https://mem0-cloud.saastemly.com/v3/memories/add

Our checks, last 30 days

Example input (from the provider)

{
  "body": {
    "memory_key": "mk_7f3a9c1e5b2d48a6b0c4e9d1",
    "messages": [
      {
        "content": "I just moved to San Francisco from New York and I prefer vegetarian food.",
        "role": "user"
      },
      {
        "content": "Got it, I'll remember that.",
        "role": "assistant"
      }
    ],
    "metadata": {
      "source": "onboarding"
    },
    "user_id": "alice"
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "properties": {
            "agent_id": {
              "description": "Entity: the agent the memories belong to (1-128 characters)",
              "type": "string"
            },
            "app_id": {
              "description": "Entity: the app (1-128 characters)",
              "type": "string"
            },
            "custom_instructions": {
              "description": "Optional extra extraction instructions (with includes and excludes, up to 800 bytes together)",
              "type": "string"
            },
            "excludes": {
              "description": "Optional: what not to extract",
              "type": "string"
            },
            "expiration_date": {
              "description": "Optional YYYY-MM-DD: the memory is hidden from search and listing after that day (unless show_expired is true)",
              "type": "string"
            },
            "includes": {
              "description": "Optional: what to focus on when extracting",
              "type": "string"
            },
            "infer": {
              "description": "Default true: extract facts with the model. false: store each message verbatim (up to 10 messages of 300 characters)",
              "type": "boolean"
            },
            "memory_key": {
              "description": "Your secret: a random string of 16-256 characters that you generate once and keep (also accepted as the X-Memory-Key header). Memories are stored and searched only under its hash, so nobody who lacks it can read them, whatever user_id they send. Lose it and the memories are unreachable.",
              "type": "string"
            },
            "messages": {
              "description": "Conversation turns, each {role: user|assistant|system, content: string}; up to 6000 bytes as JSON. A plain string is also accepted (one user message).",
              "items": {
                "properties": {
                  "content": {
                    "description": "The message text",
                    "type": "string"
                  },
                  "role": {
                    "description": "user, assistant or system",
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "type": "array"
            },
            "metadata": {
              "description": "Custom key/value metadata stored with every memory (up to 2000 bytes as JSON)",
              "type": "object"
            },
            "run_id": {
              "description": "Entity: the session or run (1-128 characters)",
              "type": "string"
            },
            "user_id": {
              "description": "Entity: the user the memories are about (1-128 characters)",
              "type": "string"
            }
          },
          "required": [
            "memory_key",
            "messages"
          ]
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST",
            "PUT",
            "PATCH"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON