Zep Feature Retirements: May 2025
Several features will be retired after May 31, 2025. Read this post for important information on migrating to alternatives.
Now that we've moved to Zep's new graph memory, we'll be retiring several Zep features on May 31, 2025.
What’s Changing
Below is a quick overview of the features being retired, along with their recommended alternatives to help you transition smoothly:
| Function | SDK Method | Recommended Alternative |
|---|---|---|
| Search memory | memory.search | graph.search |
| Search sessions for query | memory.search_sessions | graph.search |
| Update a session | memory.update_session | |
| End a session | memory.end_session | |
| End sessions | memory.end_sessions | |
| Session summaries | memory.get_summaries | memory.get.context |
| Update message metadata | memory.update_message_metadata | |
| Synthesize a question | memory.synthesize_question | |
| Retrieve fact by UUID | memory.get_fact | graph.edge.fact |
| Delete fact by UUID | memory.delete_fact | graph.edge.delete |
| Return facts for session | memory.get_session_facts | memory.get.relevant_facts |
| Add facts to a session | memory.add_session_facts | graph.add_fact_triple |
| Retrieve user facts | user.get_facts | graph.edge.get_by_user_id |
| Retrieve group facts | group.get_facts | graph.edge.get_by_group_id |
| Document Collections | all |
With the retirement of memory.search and memory.session_search, searching for chat messages will no longer be supported. We recommend using node summaries instead, as they provide a richer and more accurate context for agents.
Facts and Fact Ratings Changes
We're removing several session-level memory attributes. The fact_rating_instruction, facts, and fact_instruction attributes will no longer be supported when creating sessions. Fact Ratings may now be applied when creating Users and Groups.
Timestamp values
The updated_at attribute is being removed from input values—developers should use created_at for ordering instead.
Session Summaries and Summary Instructions
Session Summaries are now deprecated, and so too is the ability to set a summary_instruction.
Please search for node summaries as an alternative.
Session Search and min_score
Users now have a user-level graph and facts instead of session-level facts. As a result, search_sessions and search are deprecated.
Zep's graph search now runs through a multi-stage pipeline with preset minimum scores at each stage, making the min_score attribute obsolete.
Metadata
Metadata for User, Session, and Message entities is now deprecated and will soon be replaced with new functionality. We'll share more details on this in late Q1 2025.
Document Collections
With the availability of many high-quality RAG services, we're deprecating Zep's Document Collections functionality. If needed, you can add document chunks to User or Group graphs using graph.add with type = text.
How to Migrate
- Upgrade to SDK v2.5+ – Ensure you’re using the latest Python or TypeScript SDK.
- Update Your Code – Replace deprecated features with the alternatives listed above.
- Test Before May 31, 2025 – Verify that your integration works smoothly before the cutoff.
Need Help?
- Updated Documentation – Check the latest SDK examples.
- API Guide – Additional details.
- Join Our Discord – Connect with our team and developer community.