Changelog

graph.episode.list_by_graph_id and graph.episode.list_by_user_id now accept episode_metadata_filters, using the same filter structure and limits as node and edge listing. Listing every episode and filtering the results yourself is no longer necessary.

Read the docs

Batch create accepts strict_ontology, the same switch graph.add and thread.add_messages already expose. Zep applies it to every item in the batch, so bulk ingestion classifies data with your ontology instead of falling back to generic entity types.

Read the docs

UserGroup create, update, delete, and membership operations now accept a project API key, so the SDK methods work without an account-admin token. Attaching and detaching policy sets still requires an account admin.

Read the docs

Bulk and batch ingestion extracted entities and edges from every turn, ignoring ignore_roles. Ignored turns are now stored and returned but skipped during extraction, matching thread.add_messages.

Read the docs

An email address and identity-provider login stayed reserved after a member was removed from their last Zep account, so signing up again with the same credentials failed. Those identifiers are now released when the last membership is removed.

The billing page offered Open Billing Portal to accounts that had never been billed, and selecting it could not open a portal. The button is now shown when the account has a billing record, including Free accounts that paid in the past, and hidden otherwise.

Answers about retrieving previous billing statements and updating a tax ID or VAT number were added to the FAQ.

Read the docs

You can now delete a draft or invalid batch from the dashboard, from either the batch list or the batch detail page. Deleting a batch removes its items and the data staged with them. Batches that have started processing cannot be deleted, and deleting is not the same as cancelling a run.

Read the docs

A member who belongs to more than one Zep account lost their sign-in everywhere when any one of those accounts was deleted. Sign-in is now removed only after the member’s last remaining account is gone.

The billing page showed a Buy More control next to the credit balance on plans that do not sell credit bundles, and selecting it opened plan checkout rather than a credit purchase. The control is now shown only on plans where credit bundles can be bought; on other plans extra credits come from automatic top-up.

Grouping related data with document_id was documented in the Adding business data, Prepare data for ingestion, and Batch ingestion guides.

Read the docs

A batch that hit an item Zep could not ingest abandoned the items behind it. Processing now continues past a failed item, retries only the part that failed, and keeps the results already produced. batch.list_items reports an error for each item that did not ingest.

Read the docs

batch.process now returns as soon as the batch is queued and prepares the batch in the background. Processing a large draft previously ran past the request timeout and left the batch unstarted.

Read the docs

Batch items are counted against your episode usage when you call batch.process, not when you add them, so a draft you delete without processing is no longer billed. Each item is counted on its own, matching graph.add, so a batch of many short items consumes more than it did before.

Read the docs

Enterprise accounts on Zep managed cloud can now move a Memory MCP connection from project-wide standalone graph access to UserGroup access control, where a user reaches a standalone graph only through an enforced policy grant. The move is one-way; open Settings ▸ MCP to review and enable it.

Read the docs

Instructions for installing the Zep Memory plugin in Claude Code and Codex were added to Use Zep in Claude / ChatGPT / Cursor.

Read the docs

You can now override your model provider configuration for one project instead of applying a single configuration to the whole account. Projects without an override continue to use the account configuration, and clearing an override returns the project to it. Open the project and select LLM Providers; Project Admins can manage their own project, while account-wide configuration stays with Owners and Admins.

Searching a graph in which nodes had been deleted could return fewer results than requested. Edges attached to a deleted node stayed in the search index and took up result slots while returning no content. Deleting a node now removes its edges from the index as well.

Read the docs

A Graph directory page covering how to list and search standalone graphs by name and description was added under Working with Graphs.

Read the docs

Instructions for installing the Zep Memory plugin in Cursor were added to Use Zep in Claude / ChatGPT / Cursor.

Read the docs