{"slug":"mem0-cloud-saastemly-com-v3-memories-add-bdb075","title":"Store memories from a conversation, like mem0's add","host":"mem0-cloud.saastemly.com","method":"POST","resource":"https://mem0-cloud.saastemly.com/v3/memories/add","category":"commerce","description":"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 ","price_listed":0.008,"price_asked":0.008,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":372,"reported_calls_30d":0,"reported_payers_30d":0,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"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"},"output_schema":{"$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"},"history":[{"day":"2026-10-03","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.008,"price_match":true,"latency_ms":372,"error":null}],"description_full":"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}]}.","last_updated":"2026-10-03T14:37:38.437Z","schemes":["exact"]}