> ## Content Index
> Fetch the complete content index at: https://blog.getzep.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# Zep Feature Retirements: May 2025
- URL: https://blog.getzep.com/zep-feature-retirements-may-2025/
- Published: 2025-03-08T19:22:44.000Z
- Updated: 2025-03-08T19:22:44.000Z
- Description: Several features will be retired after May 31, 2025. Read this post for important information on migrating to alternatives.
- Author: Daniel Chalef
- Tags: #scarlett

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:

Python TypeScript 

| Function                  | SDK Method                   | Recommended Alternative                                                                                         |
| ------------------------- | ---------------------------- | --------------------------------------------------------------------------------------------------------------- |
| Search memory             | memory.searchSessions        | [graph.search](https://help.getzep.com/api-reference/graph/search?ref=blog.getzep.com)                          |
| Search sessions for query | memory.searchSessions        | [graph.search](https://help.getzep.com/api-reference/graph/search?ref=blog.getzep.com)                          |
| 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?ref=blog.getzep.com)                      |
| 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?ref=blog.getzep.com)                     |
| Delete fact by UUID       | memory.deleteFact            | [graph.edge.delete](https://help.getzep.com/api-reference/graph/edge/delete?ref=blog.getzep.com)                |
| 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?ref=blog.getzep.com)          |
| Retrieve user facts       | user.getFacts                | [graph.edge.getByUserId](https://help.getzep.com/api-reference/graph/edge/get-by-user-id?ref=blog.getzep.com)   |
| Retrieve group facts      | group.getFacts               | [graph.edge.getByGroupId](https://help.getzep.com/api-reference/graph/edge/get-by-group-id?ref=blog.getzep.com) |
| Document Collections      | all                          |                                                                                                                 |

| Function                  | SDK Method                       | Recommended Alternative                                                                                               |
| ------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| Search memory             | memory.search                    | [graph.search](https://help.getzep.com/api-reference/graph/search?ref=blog.getzep.com)                                |
| Search sessions for query | memory.search\_sessions          | [graph.search](https://help.getzep.com/api-reference/graph/search?ref=blog.getzep.com)                                |
| 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?ref=blog.getzep.com)                            |
| 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?ref=blog.getzep.com)                           |
| Delete fact by UUID       | memory.delete\_fact              | [graph.edge.delete](https://help.getzep.com/api-reference/graph/edge/delete?ref=blog.getzep.com)                      |
| Return facts for session  | memory.get\_session\_facts       | [memory.get.relevant\_facts](https://help.getzep.com/api-reference/memory/get?ref=blog.getzep.com)                    |
| Add facts to a session    | memory.add\_session\_facts       | [graph.add\_fact\_triple](https://help.getzep.com/api-reference/graph/add-fact-triple?ref=blog.getzep.com)            |
| Retrieve user facts       | user.get\_facts                  | [graph.edge.get\_by\_user\_id](https://help.getzep.com/api-reference/graph/edge/get-by-user-id?ref=blog.getzep.com)   |
| Retrieve group facts      | group.get\_facts                 | [graph.edge.get\_by\_group\_id](https://help.getzep.com/api-reference/graph/edge/get-by-group-id?ref=blog.getzep.com) |
| 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?ref=blog.getzep.com) 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?ref=blog.getzep.com) 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?ref=blog.getzep.com) – Check the latest SDK examples.
- [**API Guide**](https://help.getzep.com/api-reference/memory/add-session?ref=blog.getzep.com) – Additional details.
- [**Join Our Discord**](https://discord.gg/2JbGZQZT?ref=blog.getzep.com) – Connect with our team and developer community.