Skip to content

[Feature Request] Add APIs for Deleting/Resetting Memories to Support Chat Editing and Context Clearing #14

@BaiMoHan

Description

@BaiMoHan

I am currently integrating EverMemOS into a production LLM chat application (similar to ChatGPT) and noticed a critical gap in the V3 API capabilities.

Currently, the V3 API only supports:

  • Adding memories (/api/v3/agentic/memorize)
  • Retrieving memories (/api/v3/agentic/retrieve_lightweight)
  • Updating group metadata

However, there are no endpoints available to delete specific memories, rollback conversation history, or reset a group's memory entirely.

Use Cases & Pain Points

I have two specific scenarios where this functionality is blocking development:

1. Chat Message Editing (Memory Rollback)

  • Scenario: In a conversation, a user sends messages 1 through 8. Then, the user decides to edit message #3 and resends it.
  • Expectation: The frontend updates the UI. The backend should invalidate or delete all memories generated from the original message #3 and subsequent messages (#4-#8), as the context has changed.
  • Current Limit: Since there is no API to delete memories associated with a specific message_id or delete memories created after a specific timestamp, the agent retains "stale" memories from the old conversation branch, causing hallucinations or context conflict.

2. Clearing Conversation Context (Group Reset)

  • Scenario: A user wants to "restart" a conversation within a specific group (e.g., "New Chat" button or "Clear Context").
  • Expectation: We need to wipe all memory data associated with group_id.
  • Current Limit: There is no API to hard-delete or reset memories for a specific group.

Proposed Solution

I suggest adding the following endpoints to the V3 API:

A. Delete Specific Memory Allow deleting a memory entry by its source message ID.

HTTP

DELETE /api/v3/agentic/memory/message/{message_id}

B. Delete/Reset Group Memory Allow clearing all memories for a specific group.

HTTP

DELETE /api/v3/agentic/memory/group/{group_id}

C. (Optional but Advanced) Rollback Memory Allow deleting all memories created in a group after a specific timestamp (useful for the "Edit Message" scenario).

HTTP

POST /api/v3/agentic/memory/rollback
{
  "group_id": "group_001",
  "rollback_to_timestamp": "2023-10-27T10:00:00Z"
}

Additional Context

The current lack of deletion/reset APIs makes it difficult to manage the lifecycle of memories in interactive chat applications where context is mutable. Adding these would significantly improve EverMemOS's usability for real-world agentic workflows.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions