From eafac152c5d4221f2d999fdec124435b88a36bee Mon Sep 17 00:00:00 2001
From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com>
Date: Tue, 28 Jul 2026 21:28:07 +0000
Subject: [PATCH 1/3] [fern-generated] Update SDK
Generated by Fern
CLI Version: unknown
Generators:
- fernapi/fern-python-sdk: 4.25.5
---
.fern/replay.lock | 10 ++++
.fernignore | 5 +-
.gitattributes | 1 +
reference.md | 24 +++------
src/zep_cloud/__init__.py | 2 +
src/zep_cloud/core/client_wrapper.py | 4 +-
src/zep_cloud/graph/client.py | 10 ----
src/zep_cloud/graph/edge/client.py | 8 +--
src/zep_cloud/graph/edge/raw_client.py | 8 +--
src/zep_cloud/graph/node/client.py | 8 +--
src/zep_cloud/graph/node/raw_client.py | 8 +--
src/zep_cloud/graph/observation/client.py | 8 +--
src/zep_cloud/graph/observation/raw_client.py | 8 +--
src/zep_cloud/graph/raw_client.py | 10 ----
src/zep_cloud/graph/thread_summary/client.py | 8 +--
.../graph/thread_summary/raw_client.py | 8 +--
src/zep_cloud/types/__init__.py | 2 +
src/zep_cloud/types/add_node_item.py | 10 ----
src/zep_cloud/types/add_nodes_response.py | 8 +--
src/zep_cloud/types/added_node.py | 54 +++++++++++++++++++
src/zep_cloud/types/comparison_operator.py | 2 +-
src/zep_cloud/types/date_filter.py | 2 +-
src/zep_cloud/types/graph_edges_request.py | 2 +-
src/zep_cloud/types/graph_nodes_request.py | 2 +-
.../types/graph_observations_request.py | 2 +-
.../types/graph_thread_summaries_request.py | 2 +-
26 files changed, 125 insertions(+), 91 deletions(-)
create mode 100644 .fern/replay.lock
create mode 100644 .gitattributes
create mode 100644 src/zep_cloud/types/added_node.py
diff --git a/.fern/replay.lock b/.fern/replay.lock
new file mode 100644
index 00000000..789f6b0e
--- /dev/null
+++ b/.fern/replay.lock
@@ -0,0 +1,10 @@
+# DO NOT EDIT MANUALLY - Managed by Fern Replay
+version: "1.0"
+generations:
+ - commit_sha: 36ef7a1c35b8b6f4614d1095dae12b8328832a89
+ tree_hash: ff6c7f6dca046cfe71ff8d197ce03fd3f3cefccd
+ timestamp: 2026-07-28T21:28:05.428Z
+ cli_version: unknown
+ generator_versions: {}
+current_generation: 36ef7a1c35b8b6f4614d1095dae12b8328832a89
+patches: []
diff --git a/.fernignore b/.fernignore
index ba9cbe29..789c94d6 100644
--- a/.fernignore
+++ b/.fernignore
@@ -10,4 +10,7 @@ README.md
.github
Makefile
.gitignore
-LICENSE
\ No newline at end of file
+LICENSE
+.fern/replay.lock
+.fern/replay.yml
+.gitattributes
diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 00000000..74928d6a
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1 @@
+.fern/replay.lock linguist-generated=true
diff --git a/reference.md b/reference.md
index da5c671a..50ea65cf 100644
--- a/reference.md
+++ b/reference.md
@@ -1666,14 +1666,6 @@ Nested objects and arrays are not allowed.
-
-**fact_uuid:** `typing.Optional[str]` — The uuid of the edge to add
-
-
-
-
-
--
-
**graph_id:** `typing.Optional[str]`
@@ -4951,7 +4943,7 @@ of the previous page. Encodes the sort field, direction, and continuation positi
-
-**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at" or "uuid" (default "uuid").
+**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
@@ -5076,7 +5068,7 @@ of the previous page. Encodes the sort field, direction, and continuation positi
-
-**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at" or "uuid" (default "uuid").
+**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
@@ -5908,7 +5900,7 @@ of the previous page. Encodes the sort field, direction, and continuation positi
-
-**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at" or "uuid" (default "uuid").
+**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
@@ -6033,7 +6025,7 @@ of the previous page. Encodes the sort field, direction, and continuation positi
-
-**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at" or "uuid" (default "uuid").
+**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
@@ -6541,7 +6533,7 @@ of the previous page. Encodes the sort field, direction, and continuation positi
-
-**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at" or "uuid" (default "uuid").
+**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
@@ -6666,7 +6658,7 @@ of the previous page. Encodes the sort field, direction, and continuation positi
-
-**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at" or "uuid" (default "uuid").
+**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
@@ -6862,7 +6854,7 @@ of the previous page. Encodes the sort field, direction, and continuation positi
-
-**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at" or "uuid" (default "uuid").
+**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
@@ -6987,7 +6979,7 @@ of the previous page. Encodes the sort field, direction, and continuation positi
-
-**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at" or "uuid" (default "uuid").
+**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
diff --git a/src/zep_cloud/__init__.py b/src/zep_cloud/__init__.py
index 5ab7c53c..57aa7d2f 100644
--- a/src/zep_cloud/__init__.py
+++ b/src/zep_cloud/__init__.py
@@ -8,6 +8,7 @@
AddThreadMessagesRequest,
AddThreadMessagesResponse,
AddTripleResponse,
+ AddedNode,
ApiError,
ApidataBatchAddItemRole,
ApidataBatchAddItemType,
@@ -101,6 +102,7 @@
"AddThreadMessagesRequest",
"AddThreadMessagesResponse",
"AddTripleResponse",
+ "AddedNode",
"ApiError",
"ApidataBatchAddItemRole",
"ApidataBatchAddItemType",
diff --git a/src/zep_cloud/core/client_wrapper.py b/src/zep_cloud/core/client_wrapper.py
index 72f22959..acb66ced 100644
--- a/src/zep_cloud/core/client_wrapper.py
+++ b/src/zep_cloud/core/client_wrapper.py
@@ -22,10 +22,10 @@ def __init__(
def get_headers(self) -> typing.Dict[str, str]:
headers: typing.Dict[str, str] = {
- "User-Agent": "zep-cloud/3.25.0",
+ "User-Agent": "zep-cloud/3.26.0",
"X-Fern-Language": "Python",
"X-Fern-SDK-Name": "zep-cloud",
- "X-Fern-SDK-Version": "3.25.0",
+ "X-Fern-SDK-Version": "3.26.0",
**(self.get_custom_headers() or {}),
}
headers["Authorization"] = f"Api-Key {self.api_key}"
diff --git a/src/zep_cloud/graph/client.py b/src/zep_cloud/graph/client.py
index 2f6a5670..ec9543e8 100644
--- a/src/zep_cloud/graph/client.py
+++ b/src/zep_cloud/graph/client.py
@@ -430,7 +430,6 @@ def add_fact_triple(
created_at: typing.Optional[str] = OMIT,
edge_attributes: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
expired_at: typing.Optional[str] = OMIT,
- fact_uuid: typing.Optional[str] = OMIT,
graph_id: typing.Optional[str] = OMIT,
invalid_at: typing.Optional[str] = OMIT,
metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
@@ -469,9 +468,6 @@ def add_fact_triple(
expired_at : typing.Optional[str]
The time (if any) at which the edge expires
- fact_uuid : typing.Optional[str]
- The uuid of the edge to add
-
graph_id : typing.Optional[str]
invalid_at : typing.Optional[str]
@@ -552,7 +548,6 @@ def add_fact_triple(
created_at=created_at,
edge_attributes=edge_attributes,
expired_at=expired_at,
- fact_uuid=fact_uuid,
graph_id=graph_id,
invalid_at=invalid_at,
metadata=metadata,
@@ -1564,7 +1559,6 @@ async def add_fact_triple(
created_at: typing.Optional[str] = OMIT,
edge_attributes: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
expired_at: typing.Optional[str] = OMIT,
- fact_uuid: typing.Optional[str] = OMIT,
graph_id: typing.Optional[str] = OMIT,
invalid_at: typing.Optional[str] = OMIT,
metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
@@ -1603,9 +1597,6 @@ async def add_fact_triple(
expired_at : typing.Optional[str]
The time (if any) at which the edge expires
- fact_uuid : typing.Optional[str]
- The uuid of the edge to add
-
graph_id : typing.Optional[str]
invalid_at : typing.Optional[str]
@@ -1694,7 +1685,6 @@ async def main() -> None:
created_at=created_at,
edge_attributes=edge_attributes,
expired_at=expired_at,
- fact_uuid=fact_uuid,
graph_id=graph_id,
invalid_at=invalid_at,
metadata=metadata,
diff --git a/src/zep_cloud/graph/edge/client.py b/src/zep_cloud/graph/edge/client.py
index bd7e6f98..2835015e 100644
--- a/src/zep_cloud/graph/edge/client.py
+++ b/src/zep_cloud/graph/edge/client.py
@@ -62,7 +62,7 @@ def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -134,7 +134,7 @@ def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -353,7 +353,7 @@ async def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -433,7 +433,7 @@ async def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
diff --git a/src/zep_cloud/graph/edge/raw_client.py b/src/zep_cloud/graph/edge/raw_client.py
index 33f435d8..4375c21b 100644
--- a/src/zep_cloud/graph/edge/raw_client.py
+++ b/src/zep_cloud/graph/edge/raw_client.py
@@ -60,7 +60,7 @@ def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -166,7 +166,7 @@ def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -542,7 +542,7 @@ async def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -648,7 +648,7 @@ async def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
diff --git a/src/zep_cloud/graph/node/client.py b/src/zep_cloud/graph/node/client.py
index b086a055..71d531c9 100644
--- a/src/zep_cloud/graph/node/client.py
+++ b/src/zep_cloud/graph/node/client.py
@@ -64,7 +64,7 @@ def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -136,7 +136,7 @@ def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -406,7 +406,7 @@ async def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -486,7 +486,7 @@ async def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
diff --git a/src/zep_cloud/graph/node/raw_client.py b/src/zep_cloud/graph/node/raw_client.py
index 45c6cf8f..a86270d7 100644
--- a/src/zep_cloud/graph/node/raw_client.py
+++ b/src/zep_cloud/graph/node/raw_client.py
@@ -62,7 +62,7 @@ def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -168,7 +168,7 @@ def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -664,7 +664,7 @@ async def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -770,7 +770,7 @@ async def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
diff --git a/src/zep_cloud/graph/observation/client.py b/src/zep_cloud/graph/observation/client.py
index c46ef49b..cdd97fb5 100644
--- a/src/zep_cloud/graph/observation/client.py
+++ b/src/zep_cloud/graph/observation/client.py
@@ -61,7 +61,7 @@ def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -133,7 +133,7 @@ def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -252,7 +252,7 @@ async def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -332,7 +332,7 @@ async def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
diff --git a/src/zep_cloud/graph/observation/raw_client.py b/src/zep_cloud/graph/observation/raw_client.py
index 72b18a5e..b677dfa4 100644
--- a/src/zep_cloud/graph/observation/raw_client.py
+++ b/src/zep_cloud/graph/observation/raw_client.py
@@ -59,7 +59,7 @@ def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -176,7 +176,7 @@ def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -372,7 +372,7 @@ async def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -489,7 +489,7 @@ async def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
diff --git a/src/zep_cloud/graph/raw_client.py b/src/zep_cloud/graph/raw_client.py
index a6e4f8a7..9056b305 100644
--- a/src/zep_cloud/graph/raw_client.py
+++ b/src/zep_cloud/graph/raw_client.py
@@ -723,7 +723,6 @@ def add_fact_triple(
created_at: typing.Optional[str] = OMIT,
edge_attributes: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
expired_at: typing.Optional[str] = OMIT,
- fact_uuid: typing.Optional[str] = OMIT,
graph_id: typing.Optional[str] = OMIT,
invalid_at: typing.Optional[str] = OMIT,
metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
@@ -762,9 +761,6 @@ def add_fact_triple(
expired_at : typing.Optional[str]
The time (if any) at which the edge expires
- fact_uuid : typing.Optional[str]
- The uuid of the edge to add
-
graph_id : typing.Optional[str]
invalid_at : typing.Optional[str]
@@ -836,7 +832,6 @@ def add_fact_triple(
"expired_at": expired_at,
"fact": fact,
"fact_name": fact_name,
- "fact_uuid": fact_uuid,
"graph_id": graph_id,
"invalid_at": invalid_at,
"metadata": metadata,
@@ -2532,7 +2527,6 @@ async def add_fact_triple(
created_at: typing.Optional[str] = OMIT,
edge_attributes: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
expired_at: typing.Optional[str] = OMIT,
- fact_uuid: typing.Optional[str] = OMIT,
graph_id: typing.Optional[str] = OMIT,
invalid_at: typing.Optional[str] = OMIT,
metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
@@ -2571,9 +2565,6 @@ async def add_fact_triple(
expired_at : typing.Optional[str]
The time (if any) at which the edge expires
- fact_uuid : typing.Optional[str]
- The uuid of the edge to add
-
graph_id : typing.Optional[str]
invalid_at : typing.Optional[str]
@@ -2645,7 +2636,6 @@ async def add_fact_triple(
"expired_at": expired_at,
"fact": fact,
"fact_name": fact_name,
- "fact_uuid": fact_uuid,
"graph_id": graph_id,
"invalid_at": invalid_at,
"metadata": metadata,
diff --git a/src/zep_cloud/graph/thread_summary/client.py b/src/zep_cloud/graph/thread_summary/client.py
index 3f6fd543..02b8db7f 100644
--- a/src/zep_cloud/graph/thread_summary/client.py
+++ b/src/zep_cloud/graph/thread_summary/client.py
@@ -61,7 +61,7 @@ def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -133,7 +133,7 @@ def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -221,7 +221,7 @@ async def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -301,7 +301,7 @@ async def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
diff --git a/src/zep_cloud/graph/thread_summary/raw_client.py b/src/zep_cloud/graph/thread_summary/raw_client.py
index 2d041df4..063a02f1 100644
--- a/src/zep_cloud/graph/thread_summary/raw_client.py
+++ b/src/zep_cloud/graph/thread_summary/raw_client.py
@@ -59,7 +59,7 @@ def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -176,7 +176,7 @@ def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -298,7 +298,7 @@ async def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -415,7 +415,7 @@ async def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
diff --git a/src/zep_cloud/types/__init__.py b/src/zep_cloud/types/__init__.py
index 331188b4..4b786fd2 100644
--- a/src/zep_cloud/types/__init__.py
+++ b/src/zep_cloud/types/__init__.py
@@ -7,6 +7,7 @@
from .add_thread_messages_request import AddThreadMessagesRequest
from .add_thread_messages_response import AddThreadMessagesResponse
from .add_triple_response import AddTripleResponse
+from .added_node import AddedNode
from .api_error import ApiError
from .apidata_batch_add_item_role import ApidataBatchAddItemRole
from .apidata_batch_add_item_type import ApidataBatchAddItemType
@@ -94,6 +95,7 @@
"AddThreadMessagesRequest",
"AddThreadMessagesResponse",
"AddTripleResponse",
+ "AddedNode",
"ApiError",
"ApidataBatchAddItemRole",
"ApidataBatchAddItemType",
diff --git a/src/zep_cloud/types/add_node_item.py b/src/zep_cloud/types/add_node_item.py
index f2180352..c63ea100 100644
--- a/src/zep_cloud/types/add_node_item.py
+++ b/src/zep_cloud/types/add_node_item.py
@@ -3,9 +3,7 @@
import typing
import pydantic
-import typing_extensions
from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
-from ..core.serialization import FieldMetadata
class AddNodeItem(UniversalBaseModel):
@@ -42,14 +40,6 @@ class AddNodeItem(UniversalBaseModel):
A regional summary of the node.
"""
- uuid_: typing_extensions.Annotated[typing.Optional[str], FieldMetadata(alias="uuid")] = pydantic.Field(default=None)
- """
- Optional caller-supplied node UUID. When it matches an existing node the
- node is upserted; when well-formed but unknown the node is created with
- this UUID; when absent the server assigns one. This is the node's only
- identity/dedup key -- there is no name-based resolution.
- """
-
if IS_PYDANTIC_V2:
model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2
else:
diff --git a/src/zep_cloud/types/add_nodes_response.py b/src/zep_cloud/types/add_nodes_response.py
index 0f946501..5cc6db7b 100644
--- a/src/zep_cloud/types/add_nodes_response.py
+++ b/src/zep_cloud/types/add_nodes_response.py
@@ -4,14 +4,14 @@
import pydantic
from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
-from .add_node_item import AddNodeItem
+from .added_node import AddedNode
class AddNodesResponse(UniversalBaseModel):
- nodes: typing.Optional[typing.List[AddNodeItem]] = pydantic.Field(default=None)
+ nodes: typing.Optional[typing.List[AddedNode]] = pydantic.Field(default=None)
"""
- The accepted nodes, each carrying its resolved (server-assigned or
- caller-supplied) UUID, in request order.
+ The accepted nodes, each carrying the UUID Zep assigned to it, in request
+ order.
"""
task_id: typing.Optional[str] = pydantic.Field(default=None)
diff --git a/src/zep_cloud/types/added_node.py b/src/zep_cloud/types/added_node.py
new file mode 100644
index 00000000..096a05eb
--- /dev/null
+++ b/src/zep_cloud/types/added_node.py
@@ -0,0 +1,54 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+import typing_extensions
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from ..core.serialization import FieldMetadata
+
+
+class AddedNode(UniversalBaseModel):
+ attributes: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+ """
+ Additional attributes of the node.
+ """
+
+ created_at: typing.Optional[str] = pydantic.Field(default=None)
+ """
+ The node creation time.
+ """
+
+ label: typing.Optional[str] = pydantic.Field(default=None)
+ """
+ The node's entity type.
+ """
+
+ metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+ """
+ Metadata attached to the node's shadow episode.
+ """
+
+ name: str = pydantic.Field()
+ """
+ The name of the node.
+ """
+
+ summary: typing.Optional[str] = pydantic.Field(default=None)
+ """
+ A regional summary of the node.
+ """
+
+ uuid_: typing_extensions.Annotated[typing.Optional[str], FieldMetadata(alias="uuid")] = pydantic.Field(default=None)
+ """
+ The node UUID, assigned by Zep.
+ """
+
+ if IS_PYDANTIC_V2:
+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2
+ else:
+
+ class Config:
+ frozen = True
+ smart_union = True
+ extra = pydantic.Extra.allow
diff --git a/src/zep_cloud/types/comparison_operator.py b/src/zep_cloud/types/comparison_operator.py
index 44393740..8e1df62e 100644
--- a/src/zep_cloud/types/comparison_operator.py
+++ b/src/zep_cloud/types/comparison_operator.py
@@ -3,5 +3,5 @@
import typing
ComparisonOperator = typing.Union[
- typing.Literal["=", "<>", ">", "<", ">=", "<=", "IS NULL", "IS NOT NULL", "CONTAINS"], typing.Any
+ typing.Literal["=", "<>", ">", "<", ">=", "<=", "IS NULL", "is_null", "IS NOT NULL", "CONTAINS"], typing.Any
]
diff --git a/src/zep_cloud/types/date_filter.py b/src/zep_cloud/types/date_filter.py
index 429400ea..154360a6 100644
--- a/src/zep_cloud/types/date_filter.py
+++ b/src/zep_cloud/types/date_filter.py
@@ -16,7 +16,7 @@ class DateFilter(UniversalBaseModel):
date: typing.Optional[str] = pydantic.Field(default=None)
"""
Date to filter on. Required for non-null operators (=, \<\>, \>, \<, \>=, \<=).
- Should be omitted for IS NULL and IS NOT NULL operators.
+ Should be omitted for IS NULL (or is_null) and IS NOT NULL operators.
"""
if IS_PYDANTIC_V2:
diff --git a/src/zep_cloud/types/graph_edges_request.py b/src/zep_cloud/types/graph_edges_request.py
index 270f3e89..77cc19a8 100644
--- a/src/zep_cloud/types/graph_edges_request.py
+++ b/src/zep_cloud/types/graph_edges_request.py
@@ -33,7 +33,7 @@ class GraphEdgesRequest(UniversalBaseModel):
order_by: typing.Optional[str] = pydantic.Field(default=None)
"""
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
"""
uuid_cursor: typing.Optional[str] = pydantic.Field(default=None)
diff --git a/src/zep_cloud/types/graph_nodes_request.py b/src/zep_cloud/types/graph_nodes_request.py
index 30a8e950..e74a760f 100644
--- a/src/zep_cloud/types/graph_nodes_request.py
+++ b/src/zep_cloud/types/graph_nodes_request.py
@@ -33,7 +33,7 @@ class GraphNodesRequest(UniversalBaseModel):
order_by: typing.Optional[str] = pydantic.Field(default=None)
"""
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
"""
uuid_cursor: typing.Optional[str] = pydantic.Field(default=None)
diff --git a/src/zep_cloud/types/graph_observations_request.py b/src/zep_cloud/types/graph_observations_request.py
index 15ff765a..21f81b7e 100644
--- a/src/zep_cloud/types/graph_observations_request.py
+++ b/src/zep_cloud/types/graph_observations_request.py
@@ -33,7 +33,7 @@ class GraphObservationsRequest(UniversalBaseModel):
order_by: typing.Optional[str] = pydantic.Field(default=None)
"""
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
"""
uuid_cursor: typing.Optional[str] = pydantic.Field(default=None)
diff --git a/src/zep_cloud/types/graph_thread_summaries_request.py b/src/zep_cloud/types/graph_thread_summaries_request.py
index ec9b6ac2..0f835d73 100644
--- a/src/zep_cloud/types/graph_thread_summaries_request.py
+++ b/src/zep_cloud/types/graph_thread_summaries_request.py
@@ -33,7 +33,7 @@ class GraphThreadSummariesRequest(UniversalBaseModel):
order_by: typing.Optional[str] = pydantic.Field(default=None)
"""
- Field to sort by. One of "created_at" or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
"""
uuid_cursor: typing.Optional[str] = pydantic.Field(default=None)
From dcfd9e9b65aca4f94c0c28d5d0333f1e0d3c2df6 Mon Sep 17 00:00:00 2001
From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com>
Date: Tue, 28 Jul 2026 21:28:08 +0000
Subject: [PATCH 2/3] [fern-replay] advance lockfile
---
.fern/replay.lock | 8 +++++++-
1 file changed, 7 insertions(+), 1 deletion(-)
diff --git a/.fern/replay.lock b/.fern/replay.lock
index 789f6b0e..6be5ee48 100644
--- a/.fern/replay.lock
+++ b/.fern/replay.lock
@@ -6,5 +6,11 @@ generations:
timestamp: 2026-07-28T21:28:05.428Z
cli_version: unknown
generator_versions: {}
-current_generation: 36ef7a1c35b8b6f4614d1095dae12b8328832a89
+ - commit_sha: a7d57c567987a6cfead733b64cd20d025c4ea593
+ tree_hash: 536ce8a8b7d3e46a6e3b82f36938c3518c6594e9
+ timestamp: 2026-07-28T21:28:05.773Z
+ cli_version: unknown
+ generator_versions:
+ fernapi/fern-python-sdk: 4.25.5
+current_generation: a7d57c567987a6cfead733b64cd20d025c4ea593
patches: []
From 40c9f452b149b0d95c762abed8ded4f777dcc410 Mon Sep 17 00:00:00 2001
From: "zep-sdk-release-bot[bot]"
Date: Tue, 28 Jul 2026 21:28:16 +0000
Subject: [PATCH 3/3] chore: bump SDK version to 3.26.0
---
pyproject.toml | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/pyproject.toml b/pyproject.toml
index b87cb917..e88b9e7c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,10 +1,10 @@
[project]
name = "zep-cloud"
-version = "3.25.0"
+version = "3.26.0"
[tool.poetry]
name = "zep-cloud"
-version = "3.25.0"
+version = "3.26.0"
description = ""
readme = "README.md"
authors = []