Filter, sort, and paginate when listing graph objects

You can now filter, sort, and page through objects when listing them from a graph. The list methods for nodes, edges, observations, and thread summaries accept optional filters, order_by (created_at or uuid), direction (asc or desc), a page-size limit, and an opaque cursor. When you omit these fields, results are unchanged. This lets you, for example, list a user’s entity nodes created in the last day, sorted oldest-first, and page through them with a stable cursor.

Read the docs

Filter graph search by message metadata

Per-message metadata you attach with thread.add_messages now reaches the graph, so you can filter graph search by it with episode_metadata_filters. Previously this metadata was stored on the message but dropped before it reached the graph, so only metadata added through graph.add was filterable.

Read the docs

Strict ontology now constrains edge types

Strict ontology mode now limits extracted relationships to the edge types you have defined, matching how it already limits entity types. Relationships that fall outside your defined edge types are dropped during extraction.

Read the docs

Updated framework integration guides

The framework integration guides (LangGraph, CrewAI, Google ADK, Vercel AI SDK, and others) were rewritten to match Zep’s standardized integration packages, covering user and thread provisioning, context templates, graph-search tools, and automatic memory loops.

Read the docs