> This page is for version v3 (default).
> For other versions, use one of these documentation indexes:
> - v3 (default): https://help.getzep.com/v3/llms.txt
> - v2: https://help.getzep.com/v2/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://help.getzep.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://help.getzep.com/_mcp/server.

# Changelog

> **Note**
>
> Some features listed below may be pending rollout and not immediately available yet.

## October 6, 2026

## Node summaries can have up to 5,000 characters

You can now send a node summary of up to 5,000 characters to `graph.node.update`. Before, the limit was 500 characters, and you could not write back a summary that Zep generated.

Read the docs

## More than one Account Owner

An account can now have more than one Account Owner. When an Account Owner gives the Account Owner role to a member, the current Account Owners keep their role. You cannot remove the last Account Owner of an account.

Read the docs

## Credit usage for all Zep Cloud accounts

The dashboard now shows credit usage to all Zep Cloud accounts. The Billing page in the EU region also shows credit usage.

## Plan changes during an Enterprise trial

During an Enterprise trial, you can now select a self-serve plan on the **Billing** page of the dashboard.

Read the docs

## Auto search reranks large candidate sets

Auto search now uses the reranker when a search has more than 128 candidates. The reranker scores up to 200 candidates. Before, such a search used reciprocal rank fusion (RRF) order and did not use the reranker.

Read the docs

## October 5, 2026

## Build an Agent with Zep guide

A guide to build an agent that uses Zep through tools was added in the Build an Agent with Zep section.

Read the docs

## October 4, 2026

## Deprecated batch methods create Batch API batches

Each call to the deprecated `graph.add_batch` and `thread.add_messages_batch` methods now creates a Batch API batch. The batch shows in `batch.list` and in the dashboard. Zep sends the `ingest.batch.completed` webhook for these batches on the same batch outcomes as other Batch API batches. The task status that the call returns follows the batch status.

Read the docs

## Entity summaries update sooner

The minimum interval between two summary updates for one entity is now 15 minutes. Before, the interval was 30 minutes.

## October 2, 2026

## Graph visualization edge labels are easier to read

In the dashboard graph visualization, each edge label now has an opaque background with a border in the edge color. The labels are clear in dark mode and in light mode. A label longer than 32 characters is shortened.

## October 1, 2026

## Extraction uses the most recent episodes in large graphs

This change applies to a graph with more than 1,000 episodes. When Zep extracts facts from a new episode, Zep now uses the most recent episodes as context. Before, Zep could use older episodes as context.

Read the docs

## Edge types accept up to 100 source-target pairs

Each custom edge type can now have up to 100 source-target pairs. The previous limit was 10.

Read the docs

## Batch ingestion detects reversed duplicate facts

Two facts in a batch can have the same edge type and connect the same entities in the opposite order. Batch ingestion now detects these facts as duplicates. Before, both facts could stay in the graph.

Read the docs

## The dashboard shows user and graph UUIDs

The user list and the graph list in the dashboard now show the UUID of each user and graph. Click a row to open the detail page. A user or graph that has no developer-assigned ID now opens and works on its detail page.

## September 30, 2026

## Dashboard visual design update

The dashboard has a new visual design. The dashboard copy now uses the word context in place of memory on these pages:

* The sign-in page
* The onboarding wizard
* The dashboard tour
* The Playground

## Batch extraction reads skipped messages as context

A batch can have thread messages with an ignored role between other messages. Zep now uses these skipped messages as context during extraction. Zep reads the messages in their original order. Before, extraction did not read these messages.

Read the docs

## A user ID cannot equal the UUID of an existing user

When you create or clone a user, the `user_id` cannot equal the UUID of an existing user in the project. The API returns a `400` error for this request.

Read the docs

## September 29, 2026

## Webhook payloads include graph and user UUIDs

Every webhook payload that identifies a graph now includes `graph_uuid`. A payload for a user graph also includes `user_uuid`. The existing payload fields do not change.

Read the docs

## September 28, 2026

## Account members list updates after a change

The **Account** > **Members** page in the dashboard now shows an added or removed member immediately. Before, the change appeared only after you reloaded the page.

Read the docs

## Inactive free-plan accounts are deleted

Zep now deletes free-plan accounts that have no API or dashboard activity for 90 days. The Account Owner receives warning emails before the deletion, starting after 60 days of inactivity. The deletion applies only to free-plan accounts that are hosted in the Zep Cloud US region. Accounts in other Zep Cloud regions, paid accounts, enterprise accounts, and BYOC accounts are not affected.

## SDK reference names the replacement methods

The SDK reference descriptions of the deprecated `graph.episode.get_nodes_and_edges` and `graph.node.get_edges` methods now name the replacement SDK methods.

Read the docs

## September 25, 2026

## Agent Skills appear only for eligible accounts

The memory MCP server now lists Agent Skills only when Agent Memory is enabled for the account. Accounts without access no longer see methods they cannot use.

## Custom edge types match their declared entity types

Zep now checks the source and target entity types before it assigns a custom edge type. If the types do not match, strict ontology omits the edge; otherwise, Zep keeps it as a general relationship.

Read the docs

## Open an episode from a graph edge

In the dashboard graph visualizer, you can now select a loaded episode from an edge's details to focus its node on the canvas. The visualizer shows the episode first if episode nodes are hidden.

## September 24, 2026

## Order node lists by degree

You can now pass `order_by: "degree"` to the node list methods to rank the entities in a graph by how connected they are. Each returned node then carries a `degree` field with the count of live entity edges that touch the node. The v3 SDKs 3.30.0 and later include the parameter.

Read the docs

## The User entity type stays active when the default ontology is disabled

Zep now keeps the `User` entity type on a user graph when `disable_default_ontology` is set. Before this fix, the speaker in a conversation could become a second unlabeled node instead of the user node.

Read the docs

## Entity summaries rebuild once after multiple episode deletions

When you delete several episodes from one graph in a short time, Zep now rebuilds the affected entity summaries in one pass. The rebuild starts about one minute after the last deletion. Before this change, each deletion started a separate rebuild, and many concurrent rebuilds on one graph could reject other requests.

## The memory MCP server accepts a resource list request with null parameters

The memory MCP server no longer fails when an MCP client sends a `resources/list` request with `"params": null`. Before this fix, the request could interrupt other in-flight requests.

Read the docs

## Documents documentation

The Documents page and related guides now state that `document_id` and the document methods are available in the v3 SDKs 3.29.0 and later.

Read the docs

## September 23, 2026

## Entity nodes list their source episodes

Every entity node now reports the episodes that mention it in the `episodes` field (`episode_uuids` in the v4 API). When a node has 100 or fewer mention episodes, the list is complete and newest first. When a node has more, the list holds the newest 100 and `episodes_truncated` (v4: `episode_uuids_truncated`) is `true`. Read the full set with an episode list call filtered by `mentioned_node_uuids`.

Read the docs

## GPT-6 Luna is a verified BYOM model

You can now select GPT-6 Luna as a Bring Your Own LLM (BYOM) model for OpenAI and Azure OpenAI providers.

Read the docs

## Episode list filters accept episode UUIDs

The `mentioned_node_uuids` filter on the episode list APIs now documents that the list can also contain episode UUIDs. An episode UUID matches that episode, so one request can return a known set of episodes.

Read the docs

## Context Lake documentation

A Context Lake page was added to the documentation.

Read the docs

## Source traceability documentation

A Source traceability page was added to the Governance section.

Read the docs

## September 19, 2026

## Rate limit documentation for status polling and webhooks

A section about status polling and completion webhooks was added to the Rate
limits page.

Read the docs

## September 18, 2026

## Grant Zep Support read-only access to your account

You can now give Zep Support read-only access to your account for 72 hours. The
access ends automatically, and you can extend it or revoke it at any time. In
the dashboard, go to **Account** > **Members** and find the **Invite Zep
Support** card.

Read the docs

## Thread message list returns the total count on an empty page

A page after the last page of a thread message list now returns the total
message count of the thread. Before this change, an empty page returned a
total count of 0.

Read the docs

## September 17, 2026

## Enter a custom model ID for a bring-your-own LLM provider

The model dropdown for a bring-your-own LLM provider now has an **Other**
option. Select it to enter a model ID that is not in the list of verified
models, for example a model that a gateway exposes. Before this change, a
provider with verified models accepted only the models in the list. In the
dashboard, go to **Settings** > **LLM Providers**.

Read the docs

## September 16, 2026

## The graph visualizer assistant resolves follow-up questions

A follow-up question that referred to an earlier answer, such as "when did
she move there?", was searched as written and often returned results that
did not match the conversation. The assistant now rewrites a follow-up
question into a standalone question before it searches the graph. The panel
shows this rewrite as the first step of the turn.

Read the docs

## September 15, 2026

## BYOM webhooks name the provider that rejected your credential

A `byom.request_failed` webhook event reported the primary provider and model
for every failure, also when the fallback provider ran. The event now names the
provider and model that produced the failure, and a rejected credential now
reports `BYOM_CREDENTIALS_INVALID`. Ingestion no longer retries a request that
a provider rejected because of the credential, so the failure reaches you on the
first attempt.

Read the docs

## September 14, 2026

## Episode lists show the client-set message time

An episode list showed the ingestion time for a message that was added with its
own `created_at`. The list now shows the time you set.

Read the docs

## September 11, 2026

## User summaries update after fact triples, node adds, and batch ingestion

A user summary stayed at its initial text when the user graph changed through
fact triples, node adds, or batch ingestion. Zep now rebuilds the summary with
the episodes added since the last update.

Read the docs

## Batched thread messages ingest with the thread user

A thread message ingested through the Batch API did not carry the speaker and
the user identity that `thread.add_messages` adds during extraction, so the
same conversation produced a different graph. Both paths now produce the same
graph. Reads return the content you sent, and usage is metered on that content.

Read the docs

## Connect Gemini Enterprise to the MCP server

Enterprise accounts can create pre-registered OAuth clients for Gemini
Enterprise from the **MCP Server** page. The page shows the client secret once
and lists and deletes existing clients. Listing and deletion stay available on
every plan.

## September 8, 2026

## Ask questions about a graph in the visualizer

The graph visualizer in the dashboard has an assistant that answers read-only
questions about the graph you are viewing. It shows each retrieval step and
cites the facts and entities behind the answer. The assistant is in limited
rollout, so **Ask graph** is shown only when it is enabled for your account.

Read the docs

## Gemini 3.8 Flash is available for bring your own model

You can now select `gemini-3.8-flash` for Vertex AI and Gemini in **LLM
Providers**.

Read the docs

## Fact triple edge attributes are kept

Custom edge attributes on a fact triple were cleared on every triple after the
first one added to a graph. The attributes are now kept.

Read the docs

## September 2, 2026

## Thread message metadata is episode metadata

Metadata on a thread message now behaves the same as metadata added through
`graph.add`. Zep projects it onto the facts, entities, and summaries derived
from the message, graph search filters on it, and source-based access control
evaluates it. Message metadata accepts at most 10 keys with scalar or
array-of-scalar values. On an update, a key set to `null` is removed.

Read the docs

## Batch ingestion honors the default ontology setting

Batch ingestion ignored the setting that disables the default ontology, so the
same content could receive different entity and edge types when it entered
through a batch. Batch ingestion now applies the setting in the same way as
`graph.add` and `thread.add_messages`.

Read the docs

## Self-referencing facts are kept

Extraction dropped a fact whose source and target are the same entity, which
lost personal states and routines. Those facts are now kept in the graph.

## Ingestion Traces replace reasoning traces

The debug mode **Reasoning** tab is now **Ingestion Traces**. A trace explains
why each traced ingestion stage produced its decision. Tracing does not change
the stage output or the graph. Zep retains traces for 30 days.

Read the docs

_Showing the 20 most recent of 60 entries. Append `/llms.txt` to the changelog URL for the complete index._