Skip to content

armgit / mem0

Public Imported from GitHub
0

The Memory Layer for AI Agents - Drop-in memory infrastructure for AI agents and apps. Context that persists. Built for production.

Updated `deleteUsers` to use `V2` API Endpoints (#2624)

Saket Aryan725a1aa114ad
diff --git a/docs/changelog.mdx b/docs/changelog.mdx
index 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.mdx
index 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.json
index 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.ts
index 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> {