Skip to navigation

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

Episodes during a model capacity shortage

Zep no longer fails a valid episode when model capacity is temporarily not available. Zep delays the episode and processes it later. Before, a long capacity shortage caused some valid episodes to fail.

Read the docs
graphbatchbug-fixdocs

Wait status and expiry of episodes

You can now see why an episode waits when Zep has not processed it after 24 hours. The wait_status field has the value account_rate_limit_reached, waiting_for_earlier_episodes, or processing_delayed. When an episode waits for more than 7 days, Zep stops its processing and sets the expired_at field. To process an expired episode, add the episode again.

graphbatchbug-fixdocs

Expiry of batch items

Zep now stops the processing of a batch 7 days after you start the processing of the batch. At that time, each unprocessed item fails with the expired error code. The processed items stay in the graph. Before, an item failed after a fixed number of processing waits.

Read the docs
graphbatchbug-fixdocs

Shutdown date of the v3 API

The Migrating from v3 guide and the v3 documentation now state that the v3 API will stop working on April 13, 2027.

Read the docs
graphbatchbug-fixdocs

Eve guide

The Eve guide in the Ecosystem section was updated for eve memory providers.

Read the docs
graphbatchbug-fixdocs

Clear a project description

You can now clear the description of a project in the dashboard. Before, Zep kept the old description when you removed the text and saved the project.

The Project Description field is on the Project Settings page.

dashboardbug-fix

General availability of type hierarchies

Entity type hierarchies and edge type hierarchies are now generally available. You can now set entity_type_hierarchy and edge_type_hierarchy in a project ontology or a graph ontology without a request for access. Before, the hierarchies were in closed beta, and Zep enabled them only for select accounts.

Read the docs
graphbug-fix

Entities of custom types with properties

Zep now keeps an extracted entity of a custom entity type with properties when the episode has no facts about the entity. Zep stores the extracted property values on the entity node. Before, Zep dropped an entity with no facts, and its property values were lost.

Read the docs
graphbug-fix

Processing rate of Flex Plus accounts

Flex Plus accounts now have a higher processing rate for ingestion. The sustained processing rate is 1.5 times the default rate. Before, Flex Plus accounts had the default rate.

graph

Errors of failed v4 batch items

You can now see why an item of a v4 batch failed. A failed item has an error object with a code and a message. The message explains the failure and the action to take. Before, a failed item did not show a reason.

Read the docs
batchbug-fixdocsagent-skills

Batch items at the processing rate limit

When your account reaches its processing rate limit, Zep now waits and then processes the batch item again. The wait does not use one of the processing attempts of the item. If the rate limit continues for a long time, the item fails. A failed item of a v4 batch then has the rate_limited error code. Before, each rate-limited attempt counted toward the attempt limit, and an item failed after fewer waits.

batchbug-fixdocsagent-skills

Agent Skills examples

Documentation for the runnable Agent Skills examples was added to the Agent Skills section.

Read the docs
batchbug-fixdocsagent-skills

Agent Skills general availability

Zep Agent Skills is now generally available.

Read the docs
agent-skillsmcpsecuritybug-fix

Context MCP Server group restrictions with an Okta org authorization server

The allowed groups setting of a Custom OIDC connection to the Context MCP Server now works with an Okta org authorization server. Before, the ID token from that server did not have the groups claim, so the group check could not admit users. Zep now requests the groups scope when your identity provider supports it.

Read the docs
agent-skillsmcpsecuritybug-fix

v4 SDKs 4.1.0

Version 4.1.0 of the v4 SDKs adds the user.get_by_email method and the filters.document_id filter of the graph.episode.list method. You can also list the metadata keys of a graph with the new graph.list_metadata_keys method. A key stays in the list after no episode or message uses the key.

Read the docs
sdkgraphbug-fixdocs

Content policy status of an episode without an evaluation

The content_policy.status field of a v4 episode can now have the value not_evaluated. The value shows that Zep processed the episode without a content policy evaluation, for example because the account has no content policy entitlement. Before, such an episode reported pending.

sdkgraphbug-fixdocs

Content policy repair fixes

A later episode without prohibited content no longer gets a content policy flag because of an earlier dropped or repaired user summary. Before, the next summary update could copy the prohibited text back into the user summary. Zep also drops a repair that returns the original text unchanged.

Read the docs
sdkgraphbug-fixdocs

Mem0 migration guide update

The Mem0 migration guide was updated for v4 ingestion and v4 identifiers.

Read the docs
sdkgraphbug-fixdocs

User retrieval by email in the v4 API

You can now get a user by email with the v4 user.get_by_email method. The match ignores case and leading and trailing whitespace. The method returns HTTP 400 when more than one active user has the email, and when BYOK is active for the account.

Read the docs
sdkgraphbreaking-change

Document filter for the v4 episode list

You can now list the episodes of a document with filters.document_id on the v4 graph.episode.list method. The graph.episode.list_for_document method is removed from the v4 SDKs. The API continues to serve that operation for the 4.0.0 and 4.0.1 SDKs.

Read the docs
sdkgraphbreaking-change