The Memory Layer for AI Agents - Drop-in memory infrastructure for AI agents and apps. Context that persists. Built for production.
Python agentic-memoryagentic-memory-systemagentsaiai-agentschatgptgenaillmlong-term-memorymemorymemory-managementpythonragstate-management
feat(sdk): add delete_linked option to MemoryClient.delete (Python + TS) (#5270)
Chaithanya Kumar75a37ec93db7
diff --git a/docs/changelog/sdk.mdx b/docs/changelog/sdk.mdxindex feebc74ca..566ce2415 100644--- a/docs/changelog/sdk.mdx+++ b/docs/changelog/sdk.mdx@@ -7,6 +7,13 @@ mode: "wide"<Tabs><Tab title="Python">+<Update label="2026-05-27" description="v2.0.4">++**New Features:**+- **Client:** `delete()` and async `delete()` accept `delete_linked` (default `False`). When `True`, deleting a memory also removes the older memories it superseded (the v3 `linked_memory_ids` chain), transitively — the delete-side counterpart of `latest_only`, so a superseded memory does not resurface after the current one is deleted ([#5270](https://github.com/mem0ai/mem0/pull/5270))++</Update>+<Update label="2026-05-26" description="v2.0.3">**Bug Fixes:**@@ -932,6 +939,13 @@ See the [OSS v1 to v2 migration guide](https://docs.mem0.ai/migration/oss-v1-to-</Tab><Tab title="TypeScript">+<Update label="2026-05-27" description="v3.0.5">++**New Features:**+- **Client:** `delete()` accepts an options object with `deleteLinked` (serialized as `delete_linked`, default `false`). When `true`, deleting a memory also removes the older memories it superseded (the v3 linked chain), transitively — the delete-side counterpart of `latestOnly`, so a superseded memory does not resurface after the current one is deleted ([#5270](https://github.com/mem0ai/mem0/pull/5270))++</Update>+<Update label="2026-05-26" description="v3.0.4">**Bug Fixes:**diff --git a/mem0-ts/package.json b/mem0-ts/package.jsonindex ebec11c32..cc24d72ca 100644--- a/mem0-ts/package.json+++ b/mem0-ts/package.json@@ -1,6 +1,6 @@{"name": "mem0ai",- "version": "3.0.4",+ "version": "3.0.5","description": "The Memory Layer For Your AI Apps","main": "./dist/index.js","module": "./dist/index.mjs",diff --git a/mem0-ts/src/client/mem0.ts b/mem0-ts/src/client/mem0.tsindex cac2fe36c..89fe45cef 100644--- a/mem0-ts/src/client/mem0.ts+++ b/mem0-ts/src/client/mem0.ts@@ -9,6 +9,7 @@ import {SearchMemoryOptions,GetAllMemoryOptions,DeleteAllMemoryOptions,+ DeleteMemoryOptions,MemoryUpdateBody,ProjectResponse,PromptUpdatePayload,@@ -377,11 +378,17 @@ export default class MemoryClient {return response;}- async delete(memoryId: string): Promise<{ message: string }> {+ async delete(+ memoryId: string,+ options: DeleteMemoryOptions = {},+ ): Promise<{ message: string }> {if (this.telemetryId === "") await this.ping();- this._captureEvent("delete", []);+ this._captureEvent("delete", [Object.keys(options || {})]);+ const snakeOptions = camelToSnakeKeys(this._prepareParams(options));+ // @ts-ignore+ const query = new URLSearchParams(snakeOptions).toString();return this._fetchWithErrorHandling(- `${this.host}/v1/memories/${memoryId}/`,+ `${this.host}/v1/memories/${memoryId}/${query ? `?${query}` : ""}`,{method: "DELETE",headers: this.headers,diff --git a/mem0-ts/src/client/mem0.types.ts b/mem0-ts/src/client/mem0.types.tsindex 0c5c1c93f..185b1dbea 100644--- a/mem0-ts/src/client/mem0.types.ts+++ b/mem0-ts/src/client/mem0.types.ts@@ -39,6 +39,15 @@ export interface GetAllMemoryOptions {export interface DeleteAllMemoryOptions extends EntityOptions {}+export interface DeleteMemoryOptions {+ /**+ * When `true`, also delete the older memories this one superseded (the v3+ * linked chain), transitively — the delete-side counterpart of `latestOnly`.+ * Off by default. Serialized as `delete_linked`.+ */+ deleteLinked?: boolean;+}+// ─── Project Options ────────────────────────────────────────export interface ProjectOptions {fields?: string[];diff --git a/mem0-ts/src/client/tests/memoryClient.crud.test.ts b/mem0-ts/src/client/tests/memoryClient.crud.test.tsindex 80bdcfa01..39e3f1733 100644--- a/mem0-ts/src/client/tests/memoryClient.crud.test.ts+++ b/mem0-ts/src/client/tests/memoryClient.crud.test.ts@@ -200,9 +200,26 @@ describe("MemoryClient - delete()", () => {const client = new MemoryClient({ apiKey: TEST_API_KEY });await client.delete("mem_123");- expect(- findFetchCall(mock, "/v1/memories/mem_123/", "DELETE"),- ).toBeDefined();+ const call = findFetchCall(mock, "/v1/memories/mem_123/", "DELETE");+ expect(call).toBeDefined();+ // Default: no cascade query param, URL byte-identical to before.+ expect(call![0]).not.toContain("delete_linked");+ });++ test("serializes deleteLinked as delete_linked query param", async () => {+ const extra = new Map<string, { status: number; body: unknown }>();+ extra.set("/v1/memories/mem_123/", {+ status: 200,+ body: { message: "Memory deleted successfully", cascade_count: 1 },+ });+ const mock = setupMockFetch(extra);++ const client = new MemoryClient({ apiKey: TEST_API_KEY });+ await client.delete("mem_123", { deleteLinked: true });++ const call = findFetchCall(mock, "/v1/memories/mem_123/", "DELETE");+ expect(call).toBeDefined();+ expect(call![0]).toContain("delete_linked=true");});});diff --git a/mem0/client/main.py b/mem0/client/main.pyindex 69ff77bd8..d4633709f 100644--- a/mem0/client/main.py+++ b/mem0/client/main.py@@ -360,11 +360,16 @@ class MemoryClient:return response.json()@api_error_handler- def delete(self, memory_id: str) -> Dict[str, Any]:+ def delete(self, memory_id: str, delete_linked: bool = False) -> Dict[str, Any]:"""Delete a specific memory by ID.Args:memory_id: The ID of the memory to delete.+ delete_linked: When True, also delete the older memories this one+ superseded (the v3 ``linked_memory_ids`` chain), transitively.+ This is the delete-side counterpart of ``latest_only`` — it+ stops a superseded memory from resurfacing after you delete the+ current one. Defaults to False (only the given memory is deleted).Returns:A dictionary containing the API response.@@ -377,10 +382,12 @@ class MemoryClient:NetworkError: If network connectivity issues occur.MemoryNotFoundError: If the memory doesn't exist (for updates/deletes)."""- params = self._prepare_params()+ params = self._prepare_params({"delete_linked": delete_linked or None})response = self.client.delete(f"/v1/memories/{memory_id}/", params=params)response.raise_for_status()- capture_client_event("client.delete", self, {"memory_id": memory_id, "sync_type": "sync"})+ capture_client_event(+ "client.delete", self, {"memory_id": memory_id, "delete_linked": delete_linked, "sync_type": "sync"}+ )return response.json()@api_error_handler@@ -1268,11 +1275,16 @@ class AsyncMemoryClient:return response.json()@api_error_handler- async def delete(self, memory_id: str) -> Dict[str, Any]:+ async def delete(self, memory_id: str, delete_linked: bool = False) -> Dict[str, Any]:"""Delete a specific memory by ID.Args:memory_id: The ID of the memory to delete.+ delete_linked: When True, also delete the older memories this one+ superseded (the v3 ``linked_memory_ids`` chain), transitively.+ This is the delete-side counterpart of ``latest_only`` — it+ stops a superseded memory from resurfacing after you delete the+ current one. Defaults to False (only the given memory is deleted).Returns:A dictionary containing the API response.@@ -1285,10 +1297,12 @@ class AsyncMemoryClient:NetworkError: If network connectivity issues occur.MemoryNotFoundError: If the memory doesn't exist (for updates/deletes)."""- params = self._prepare_params()+ params = self._prepare_params({"delete_linked": delete_linked or None})response = await self.async_client.delete(f"/v1/memories/{memory_id}/", params=params)response.raise_for_status()- capture_client_event("client.delete", self, {"memory_id": memory_id, "sync_type": "async"})+ capture_client_event(+ "client.delete", self, {"memory_id": memory_id, "delete_linked": delete_linked, "sync_type": "async"}+ )return response.json()@api_error_handlerdiff --git a/pyproject.toml b/pyproject.tomlindex 300d88a6a..13eb2fac6 100644--- a/pyproject.toml+++ b/pyproject.toml@@ -4,7 +4,7 @@ build-backend = "hatchling.build"[project]name = "mem0ai"-version = "2.0.3"+version = "2.0.4"description = "Long-term memory for AI Agents"authors = [{ name = "Mem0", email = "[email protected]" }diff --git a/tests/test_client.py b/tests/test_client.pyindex fb685c02a..66d01a4c0 100644--- a/tests/test_client.py+++ b/tests/test_client.py@@ -147,3 +147,41 @@ class TestFilterOperatorPassthrough:call_args = mock_memory_client.client.post.call_argspayload = call_args.kwargs.get("json", call_args.args[1] if len(call_args.args) > 1 else {})assert payload["filters"] == complex_filter+++class TestDeleteLinked:+ """delete() should forward the opt-in delete_linked flag as a query param."""++ def _setup_delete(self, client):+ client.client.delete.return_value = MagicMock(+ json=lambda: {"message": "Memory deleted successfully!"},+ raise_for_status=lambda: None,+ )++ def test_delete_default_omits_delete_linked(self, mock_memory_client):+ """Default delete sends no delete_linked param — byte-identical to before."""+ self._setup_delete(mock_memory_client)++ mock_memory_client.delete("mem_123")++ call_args = mock_memory_client.client.delete.call_args+ assert call_args.args[0] == "/v1/memories/mem_123/"+ assert "delete_linked" not in call_args.kwargs.get("params", {})++ def test_delete_linked_true_sets_param(self, mock_memory_client):+ """delete_linked=True forwards delete_linked into the request params."""+ self._setup_delete(mock_memory_client)++ mock_memory_client.delete("mem_123", delete_linked=True)++ call_args = mock_memory_client.client.delete.call_args+ assert call_args.kwargs.get("params", {}).get("delete_linked") is True++ def test_delete_linked_false_omits_param(self, mock_memory_client):+ """delete_linked=False is stripped, so the default path is untouched."""+ self._setup_delete(mock_memory_client)++ mock_memory_client.delete("mem_123", delete_linked=False)++ call_args = mock_memory_client.client.delete.call_args+ assert "delete_linked" not in call_args.kwargs.get("params", {})