# Zep Feature Retirements: May 2025

By Daniel Chalef · Mar 08, 2025 · https://www.getzep.com/blog/zep-feature-retirements-may-2025/ · Tags: Product updates

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:

**TypeScript**

| Function | SDK Method | Recommended Alternative |
| --- | --- | --- |
| Search memory | `memory.searchSessions` | [graph.search](https://help.getzep.com/api-reference/graph/search) |
| Search sessions for query | `memory.searchSessions` | [graph.search](https://help.getzep.com/api-reference/graph/search) |
| Update a session | `memory.updateSession` |  |
| End a session | `memory.endSession` |  |
| End sessions | `memory.endSessions` |  |
| Session summaries | `memory.getSummaries` | [memory.get.context](https://help.getzep.com/api-reference/memory/get) |
| Update message metadata | `memory.updateMessageMetadata` |  |
| Synthesize a question | `memory.synthesizeQuestion` |  |
| Retrieve fact by UUID | `memory.getFact` | [graph.edge.fact](https://help.getzep.com/api-reference/graph/edge/get) |
| Delete fact by UUID | `memory.deleteFact` | [graph.edge.delete](https://help.getzep.com/api-reference/graph/edge/delete) |
| Return facts for session | `memory.getSessionFacts` | [memory.get.relevantFacts](https://help.getzep.com/api-reference/memory/get) |
| Add facts to a session | `memory.addSessionFacts` | [graph.addFactTriple](https://help.getzep.com/api-reference/graph/add-fact-triple) |
| Retrieve user facts | `user.getFacts` | [graph.edge.getByUserId](https://help.getzep.com/api-reference/graph/edge/get-by-user-id) |
| Retrieve group facts | `group.getFacts` | [graph.edge.getByGroupId](https://help.getzep.com/api-reference/graph/edge/get-by-group-id) |
| Document Collections | `all` |  |

**Python**

| Function | SDK Method | Recommended Alternative |
| --- | --- | --- |
| Search memory | `memory.search` | [graph.search](https://help.getzep.com/api-reference/graph/search) |
| Search sessions for query | `memory.search_sessions` | [graph.search](https://help.getzep.com/api-reference/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](https://help.getzep.com/api-reference/memory/get) |
| Update message metadata | `memory.update_message_metadata` |  |
| Synthesize a question | `memory.synthesize_question` |  |
| Retrieve fact by UUID | `memory.get_fact` | [graph.edge.fact](https://help.getzep.com/api-reference/graph/edge/get) |
| Delete fact by UUID | `memory.delete_fact` | [graph.edge.delete](https://help.getzep.com/api-reference/graph/edge/delete) |
| Return facts for session | `memory.get_session_facts` | [memory.get.relevant_facts](https://help.getzep.com/api-reference/memory/get) |
| Add facts to a session | `memory.add_session_facts` | [graph.add_fact_triple](https://help.getzep.com/api-reference/graph/add-fact-triple) |
| Retrieve user facts | `user.get_facts` | [graph.edge.get_by_user_id](https://help.getzep.com/api-reference/graph/edge/get-by-user-id) |
| Retrieve group facts | `group.get_facts` | [graph.edge.get_by_group_id](https://help.getzep.com/api-reference/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](https://help.getzep.com/searching-the-graph) 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](https://help.getzep.com/adding-data-to-the-graph) to User or Group graphs using `graph.add` with `type = text`.

## How to Migrate

1. **Upgrade to SDK v2.5+** – Ensure you’re using the latest Python or TypeScript SDK.
2. **Update Your Code** – Replace deprecated features with the alternatives listed above.
3. **Test Before May 31, 2025** – Verify that your integration works smoothly before the cutoff.

## Need Help?

- [**Updated Documentation**](https://help.getzep.com/concepts) – Check the latest SDK examples.
- [**API Guide**](https://help.getzep.com/api-reference/memory/add-session) – Additional details.
- [**Join Our Discord**](https://discord.gg/2JbGZQZT) – Connect with our team and developer community.