Mem0 Cloud

{'type': 'object', 'required': ['memory_key', 'messages'], 'properties': {'infer': {'type': 'boolean', 'description': 'Default true: extract facts with the model. false: store each message verbatim (up to 10 messages of 300 characters)'}, 'app_id': {'type': 'string', 'description': 'Entity: the app (1-128 characters)'}, 'run_id': {'type': 'string', 'description': 'Entity: the session or run (1-128 characters)'}, 'user_id': {'type': 'string', 'description': 'Entity: the user the memories are about (1-128 characters)'}, 'agent_id': {'type': 'string', 'description': 'Entity: the agent the memories belong to (1-128 characters)'}, 'excludes': {'type': 'string', 'description': 'Optional: what not to extract'}, 'includes': {'type': 'string', 'description': 'Optional: what to focus on when extracting'}, 'messages': {'type': 'array', 'items': {'type': 'object', 'properties': {'role': {'type': 'string', 'description': 'user, assistant or system'}, 'content': {'type': 'string', 'description': 'The message text'}}}, '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).'}, 'metadata': {'type': 'object', 'description': 'Custom key/value metadata stored with every memory (up to 2000 bytes as JSON)'}, 'memory_key': {'type': 'string', '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.'}, 'expiration_date': {'type': 'string', 'description': 'Optional YYYY-MM-DD: the memory is hidden from search and listing after that day (unless show_expired is true)'}, 'custom_instructions': {'type': 'string', 'description': 'Optional extra extraction instructions (with includes and excludes, up to 800 bytes together)'}}}

{'type': 'object', 'required': ['memory_key'], 'properties': {'app_id': {'type': 'string', 'description': 'Entity: the app (1-128 characters)'}, 'run_id': {'type': 'string', 'description': 'Entity: the session or run (1-128 characters)'}, 'user_id': {'type': 'string', 'description': 'Entity: the user the memories are about (1-128 characters)'}, 'agent_id': {'type': 'string', 'description': 'Entity: the agent the memories belong to (1-128 characters)'}, 'memory_id': {'type': 'string', 'description': 'UUID of one memory to delete; leave out to delete by entity instead'}, 'memory_key': {'type': 'string', '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': 'object', 'required': ['memory_key'], 'properties': {'page': {'type': 'integer', 'description': 'Page number, from 1 (default 1)'}, 'app_id': {'type': 'string', 'description': 'Entity: the app (1-128 characters)'}, 'run_id': {'type': 'string', 'description': 'Entity: the session or run (1-128 characters)'}, 'user_id': {'type': 'string', 'description': 'Entity: the user the memories are about (1-128 characters)'}, 'agent_id': {'type': 'string', 'description': 'Entity: the agent the memories belong to (1-128 characters)'}, 'memory_id': {'type': 'string', 'description': 'UUID of one memory to fetch; leave out to list memories instead'}, 'page_size': {'type': 'integer', 'description': 'Memories per page, 1-100 (default 50)'}, 'memory_key': {'type': 'string', '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.'}, 'show_expired': {'type': 'boolean', 'description': 'Include memories whose expiration_date has passed (default false)'}}}

{'type': 'object', 'required': ['memory_key', 'query', 'filters'], 'properties': {'query': {'type': 'string', 'description': 'What to look for, in natural language (up to 500 characters)'}, 'top_k': {'type': 'integer', 'description': 'How many memories to return, 1-100 (default 10)'}, 'filters': {'type': 'object', 'description': 'mem0 filters: at least one of user_id, agent_id, app_id, run_id, each a string, "*" or {"in": [up to 20 strings]}; AND lists of those. OR and NOT are not supported.'}, 'threshold': {'type': 'number', 'description': 'Minimum relevance score, 0-1 (default 0.1; 0 disables)'}, 'memory_key': {'type': 'string', '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.'}, 'show_expired': {'type': 'boolean', 'description': 'Include memories whose expiration_date has passed (default false)'}}}