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
Updated `deleteUsers` to use `V2` API Endpoints (#2624)
Saket Aryan725a1aa114ad
diff --git a/docs/changelog.mdx b/docs/changelog.mdxindex 3c7a3cf06..0309c68b2 100644--- a/docs/changelog.mdx+++ b/docs/changelog.mdx@@ -209,6 +209,12 @@ mode: "wide"<Tab title="TypeScript">+<Update label="2025-05-05" description="v2.1.23">+**New Features:**+- **Client:** Updated `deleteUsers` to use `v2` API.+- **Client:** Deprecated `deleteUser` and added deprecation warning.+</Update>+<Update label="2025-05-02" description="v2.1.22">**New Features:**- **Client:** Updated `deleteUser` to use `entity_id` and `entity_type`diff --git a/docs/platform/quickstart.mdx b/docs/platform/quickstart.mdxindex 7a2326f83..89bca87d7 100644--- a/docs/platform/quickstart.mdx+++ b/docs/platform/quickstart.mdx@@ -1513,7 +1513,7 @@ client.delete_users({ user_id: "alex" })``````bash cURL-curl -X DELETE "https://api.mem0.ai/v1/entities/?user_id=alex" \+curl -X DELETE "https://api.mem0.ai/v2/entities/user/alex" \-H "Authorization: Token your-api-key"```@@ -1531,12 +1531,6 @@ curl -X DELETE "https://api.mem0.ai/v1/entities/?user_id=alex" \client.reset()```-```javascript JavaScript-client.reset()- .then(result => console.log(result))- .catch(error => console.error(error));-```-```json Output{'message': 'Client reset successful. All users and memories deleted.'}```diff --git a/mem0-ts/package.json b/mem0-ts/package.jsonindex aa387ff66..2a726b3b9 100644--- a/mem0-ts/package.json+++ b/mem0-ts/package.json@@ -1,6 +1,6 @@{"name": "mem0ai",- "version": "2.1.22",+ "version": "2.1.23","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 958f80193..ec0ed541e 100644--- a/mem0-ts/src/client/mem0.ts+++ b/mem0-ts/src/client/mem0.ts@@ -431,6 +431,9 @@ export default class MemoryClient {return response;}+ /**+ * @deprecated The method should not be used, use `deleteUsers` instead. This will be removed in version 2.2.0.+ */async deleteUser(data: {entity_id: number;entity_type: string;@@ -450,31 +453,86 @@ export default class MemoryClient {return response;}- async deleteUsers(): Promise<{ message: string }> {+ async deleteUsers(+ params: {+ user_id?: string;+ agent_id?: string;+ app_id?: string;+ run_id?: string;+ } = {},+ ): Promise<{ message: string }> {if (this.telemetryId === "") await this.ping();this._validateOrgProject();- this._captureEvent("delete_users", []);- const entities = await this.users();-- for (const entity of entities.results) {- let options: MemoryOptions = {};- if (this.organizationName != null && this.projectName != null) {- options.org_name = this.organizationName;- options.project_name = this.projectName;- }- if (this.organizationId != null && this.projectId != null) {- options.org_id = this.organizationId;- options.project_id = this.projectId;+ let to_delete: Array<{ type: string; name: string }> = [];+ const { user_id, agent_id, app_id, run_id } = params;++ if (user_id) {+ to_delete = [{ type: "user", name: user_id }];+ } else if (agent_id) {+ to_delete = [{ type: "agent", name: agent_id }];+ } else if (app_id) {+ to_delete = [{ type: "app", name: app_id }];+ } else if (run_id) {+ to_delete = [{ type: "run", name: run_id }];+ } else {+ const entities = await this.users();+ to_delete = entities.results.map((entity) => ({+ type: entity.type,+ name: entity.name,+ }));+ }++ if (to_delete.length === 0) {+ throw new Error("No entities to delete");+ }++ const requestOptions: MemoryOptions = {};+ if (this.organizationName != null && this.projectName != null) {+ requestOptions.org_name = this.organizationName;+ requestOptions.project_name = this.projectName;+ }++ if (this.organizationId != null && this.projectId != null) {+ requestOptions.org_id = this.organizationId;+ requestOptions.project_id = this.projectId;++ if (requestOptions.org_name) delete requestOptions.org_name;+ if (requestOptions.project_name) delete requestOptions.project_name;+ }- if (options.org_name) delete options.org_name;- if (options.project_name) delete options.project_name;+ // Delete each entity and handle errors+ for (const entity of to_delete) {+ try {+ await this.client.delete(+ `/v2/entities/${entity.type}/${entity.name}/`,+ {+ params: requestOptions,+ },+ );+ } catch (error: any) {+ throw new APIError(+ `Failed to delete ${entity.type} ${entity.name}: ${error.message}`,+ );}- await this.client.delete(`/v1/entities/${entity.type}/${entity.id}/`, {- params: options,- });}- return { message: "All users, agents, and sessions deleted." };++ this._captureEvent("delete_users", [+ {+ user_id: user_id,+ agent_id: agent_id,+ app_id: app_id,+ run_id: run_id,+ sync_type: "sync",+ },+ ]);++ return {+ message:+ user_id || agent_id || app_id || run_id+ ? "Entity deleted successfully."+ : "All users, agents, apps and runs deleted.",+ };}async batchUpdate(memories: Array<MemoryUpdateBody>): Promise<string> {