[{"data":1,"prerenderedAt":549},["ShallowReactive",2],{"/memos_cloud/mem_operations/delete_memory":3,"surround-/memos_cloud/mem_operations/delete_memory":535},{"id":4,"title":5,"avatar":6,"banner":6,"body":7,"category":6,"desc":528,"description":120,"extension":529,"links":6,"meta":530,"navigation":6,"path":531,"seo":532,"stem":533,"__hash__":534},"docs/en/memos_cloud/mem_operations/delete_memory.md","Delete Memory",null,{"type":8,"value":9,"toc":523},"minimark",[10,34,36,41,55,95,97,101,108,110,114,509,519],[11,12,13,29],"warning",{},[14,15,16,24,27],"p",{},[17,18,19],"strong",{},[20,21,23],"a",{"href":22},"/api_docs/core/delete_memory","Go directly to API Docs",[25,26],"br",{},[25,28],{},[14,30,31],{},[17,32,33],{},"This article focuses on functional explanation. For detailed interface fields and limits, please click the link above.",[25,35],{},[37,38,40],"h2",{"id":39},"_1-key-parameters","1. Key Parameters",[42,43,44],"ul",{},[45,46,47,54],"li",{},[17,48,49,50,53],{},"Memory ID List (memory_ids",[51,52],"span",{},")",": This parameter accepts a list of memory IDs and is used to delete one or more specific memories.",[56,57,58],"note",{},[14,59,60,63,65,67,68,72,73,76,77,80,81,83,84,86,87,90,91,94],{},[17,61,62],{},"How to obtain memory IDs for deletion",[25,64],{},[25,66],{},"\nWhen retrieving memories via ",[69,70,71],"code",{},"search/memory"," or ",[69,74,75],{},"get/memory",", each memory item in the returned result contains a unique ",[69,78,79],{},"id"," field, which serves as the unique identifier for that memory.  ",[25,82],{},"\nIf a memory is found to be expired or does not meet expectations, you can directly take this ",[69,85,79],{}," and pass it as the ",[69,88,89],{},"memory_ids[]"," parameter when calling the ",[69,92,93],{},"delete/memory"," API to delete the corresponding memory entry.",[25,96],{},[37,98,100],{"id":99},"_2-working-principle","2. Working Principle",[42,102,103],{},[45,104,105,107],{},[17,106,5],{},": Delete the memory content matching the specified users based on the provided memory IDs.",[25,109],{},[37,111,113],{"id":112},"_3-quick-start","3. Quick Start",[115,116,121],"pre",{"className":117,"code":118,"language":119,"meta":120,"style":120},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import os\nimport requests\nimport json\n\n# Replace with your MemOS API Key\nos.environ[\"MEMOS_API_KEY\"] = \"YOUR_API_KEY\"\nos.environ[\"MEMOS_BASE_URL\"] = \"https://api.memt.ai/openmem/v1\"\n\ndata = {\n    \"memory_ids\":[\"4a50618f-797d-4c3b-b914-94d7d1246c8d\"]  # Replace with real memory IDs\n  }\nheaders = {\n  \"Content-Type\": \"application/json\",\n  \"Authorization\": f\"Token {os.environ['MEMOS_API_KEY']}\"\n}\nurl = f\"{os.environ['MEMOS_BASE_URL']}/delete/memory\"\n\nres = requests.post(url=url, headers=headers, data=json.dumps(data))\n\nprint(f\"result: {res.json()}\")\n","python","",[69,122,123,135,143,151,158,165,206,235,240,252,278,284,294,318,363,369,404,409,471,476],{"__ignoreMap":120},[51,124,127,131],{"class":125,"line":126},"line",1,[51,128,130],{"class":129},"s7zQu","import",[51,132,134],{"class":133},"sTEyZ"," os\n",[51,136,138,140],{"class":125,"line":137},2,[51,139,130],{"class":129},[51,141,142],{"class":133}," requests\n",[51,144,146,148],{"class":125,"line":145},3,[51,147,130],{"class":129},[51,149,150],{"class":133}," json\n",[51,152,154],{"class":125,"line":153},4,[51,155,157],{"emptyLinePlaceholder":156},true,"\n",[51,159,161],{"class":125,"line":160},5,[51,162,164],{"class":163},"sHwdD","# Replace with your MemOS API Key\n",[51,166,168,171,175,179,182,185,189,191,194,197,200,203],{"class":125,"line":167},6,[51,169,170],{"class":133},"os",[51,172,174],{"class":173},"sMK4o",".",[51,176,178],{"class":177},"swJcz","environ",[51,180,181],{"class":173},"[",[51,183,184],{"class":173},"\"",[51,186,188],{"class":187},"sfazB","MEMOS_API_KEY",[51,190,184],{"class":173},[51,192,193],{"class":173},"]",[51,195,196],{"class":173}," =",[51,198,199],{"class":173}," \"",[51,201,202],{"class":187},"YOUR_API_KEY",[51,204,205],{"class":173},"\"\n",[51,207,209,211,213,215,217,219,222,224,226,228,230,233],{"class":125,"line":208},7,[51,210,170],{"class":133},[51,212,174],{"class":173},[51,214,178],{"class":177},[51,216,181],{"class":173},[51,218,184],{"class":173},[51,220,221],{"class":187},"MEMOS_BASE_URL",[51,223,184],{"class":173},[51,225,193],{"class":173},[51,227,196],{"class":173},[51,229,199],{"class":173},[51,231,232],{"class":187},"https://api.memt.ai/openmem/v1",[51,234,205],{"class":173},[51,236,238],{"class":125,"line":237},8,[51,239,157],{"emptyLinePlaceholder":156},[51,241,243,246,249],{"class":125,"line":242},9,[51,244,245],{"class":133},"data ",[51,247,248],{"class":173},"=",[51,250,251],{"class":173}," {\n",[51,253,255,258,261,263,266,268,271,273,275],{"class":125,"line":254},10,[51,256,257],{"class":173},"    \"",[51,259,260],{"class":187},"memory_ids",[51,262,184],{"class":173},[51,264,265],{"class":173},":[",[51,267,184],{"class":173},[51,269,270],{"class":187},"4a50618f-797d-4c3b-b914-94d7d1246c8d",[51,272,184],{"class":173},[51,274,193],{"class":173},[51,276,277],{"class":163},"  # Replace with real memory IDs\n",[51,279,281],{"class":125,"line":280},11,[51,282,283],{"class":173},"  }\n",[51,285,287,290,292],{"class":125,"line":286},12,[51,288,289],{"class":133},"headers ",[51,291,248],{"class":173},[51,293,251],{"class":173},[51,295,297,300,303,305,308,310,313,315],{"class":125,"line":296},13,[51,298,299],{"class":173},"  \"",[51,301,302],{"class":187},"Content-Type",[51,304,184],{"class":173},[51,306,307],{"class":173},":",[51,309,199],{"class":173},[51,311,312],{"class":187},"application/json",[51,314,184],{"class":173},[51,316,317],{"class":173},",\n",[51,319,321,323,326,328,330,334,337,341,343,345,347,349,352,354,356,358,361],{"class":125,"line":320},14,[51,322,299],{"class":173},[51,324,325],{"class":187},"Authorization",[51,327,184],{"class":173},[51,329,307],{"class":173},[51,331,333],{"class":332},"spNyl"," f",[51,335,336],{"class":187},"\"Token ",[51,338,340],{"class":339},"sbssI","{",[51,342,170],{"class":133},[51,344,174],{"class":173},[51,346,178],{"class":177},[51,348,181],{"class":173},[51,350,351],{"class":173},"'",[51,353,188],{"class":187},[51,355,351],{"class":173},[51,357,193],{"class":173},[51,359,360],{"class":339},"}",[51,362,205],{"class":187},[51,364,366],{"class":125,"line":365},15,[51,367,368],{"class":173},"}\n",[51,370,372,375,377,379,381,383,385,387,389,391,393,395,397,399,401],{"class":125,"line":371},16,[51,373,374],{"class":133},"url ",[51,376,248],{"class":173},[51,378,333],{"class":332},[51,380,184],{"class":187},[51,382,340],{"class":339},[51,384,170],{"class":133},[51,386,174],{"class":173},[51,388,178],{"class":177},[51,390,181],{"class":173},[51,392,351],{"class":173},[51,394,221],{"class":187},[51,396,351],{"class":173},[51,398,193],{"class":173},[51,400,360],{"class":339},[51,402,403],{"class":187},"/delete/memory\"\n",[51,405,407],{"class":125,"line":406},17,[51,408,157],{"emptyLinePlaceholder":156},[51,410,412,415,417,420,422,426,429,433,435,437,440,443,445,448,450,453,455,458,460,463,465,468],{"class":125,"line":411},18,[51,413,414],{"class":133},"res ",[51,416,248],{"class":173},[51,418,419],{"class":133}," requests",[51,421,174],{"class":173},[51,423,425],{"class":424},"s2Zo4","post",[51,427,428],{"class":173},"(",[51,430,432],{"class":431},"sHdIc","url",[51,434,248],{"class":173},[51,436,432],{"class":424},[51,438,439],{"class":173},",",[51,441,442],{"class":431}," headers",[51,444,248],{"class":173},[51,446,447],{"class":424},"headers",[51,449,439],{"class":173},[51,451,452],{"class":431}," data",[51,454,248],{"class":173},[51,456,457],{"class":424},"json",[51,459,174],{"class":173},[51,461,462],{"class":424},"dumps",[51,464,428],{"class":173},[51,466,467],{"class":424},"data",[51,469,470],{"class":173},"))\n",[51,472,474],{"class":125,"line":473},19,[51,475,157],{"emptyLinePlaceholder":156},[51,477,479,482,484,487,490,492,495,497,499,502,504,506],{"class":125,"line":478},20,[51,480,481],{"class":424},"print",[51,483,428],{"class":173},[51,485,486],{"class":332},"f",[51,488,489],{"class":187},"\"result: ",[51,491,340],{"class":339},[51,493,494],{"class":424},"res",[51,496,174],{"class":173},[51,498,457],{"class":424},[51,500,501],{"class":173},"()",[51,503,360],{"class":339},[51,505,184],{"class":187},[51,507,508],{"class":173},")\n",[56,510,511],{},[14,512,513,514,518],{}," Want to know if the deletion was successful?\nCopy the above code and run it, then ",[20,515,517],{"href":516},"/memos_cloud/mem_operations/search_memory","Search Memory"," again to see if the memory has been successfully deleted.",[520,521,522],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":120,"searchDepth":137,"depth":137,"links":524},[525,526,527],{"id":39,"depth":137,"text":40},{"id":99,"depth":137,"text":100},{"id":112,"depth":137,"text":113},"Delete memories from MemOS, supporting batch deletion of memories for multiple users.","md",{},"/en/memos_cloud/mem_operations/delete_memory",{"title":5,"description":120},"en/memos_cloud/mem_operations/delete_memory","RT_shJfZtKNPuLVdPNBGEMaGCs3RO_28u1nPmTz-bs0",[536,542],{"title":517,"path":516,"stem":537,"icon":538,"framework":6,"module":6,"class":539,"target":-1,"active":540,"defaultOpen":540,"children":-1,"description":541},"memos_cloud/mem_operations/search_memory","i-ri-search-2-line",[],false,"MemOS recalls relevant memories through semantic retrieval and filtering functions.",{"title":543,"path":544,"stem":545,"icon":546,"framework":6,"module":6,"class":547,"target":-1,"active":540,"defaultOpen":540,"children":-1,"description":548},"Memory Filters","/memos_cloud/features/basic/filters","memos_cloud/features/basic/filters","i-ri-filter-3-line",[],"Use memory filters when retrieving memories to filter by specific agents, meta information, time ranges, and other conditions.",1770372087850]