From ca7df01ae79b1f68da93bd679dcf79fe30141f98 Mon Sep 17 00:00:00 2001 From: Niklas Semmler Date: Wed, 7 Oct 2026 17:24:57 +0200 Subject: [PATCH 1/2] docs(api): document fromStartTime as required on experiments endpoints Regenerated langfuse/api from the upstream Fern definition: baseline langfuse/langfuse 619dbe3 (last sync, #1866) plus langfuse/langfuse#17603. Split out of the bundled API-spec bot PR #1943. Co-Authored-By: Claude Opus 5.5 (1M context) --- langfuse/api/experiments/client.py | 20 ++++++++++++++++---- langfuse/api/experiments/raw_client.py | 20 ++++++++++++++++---- 2 files changed, 32 insertions(+), 8 deletions(-) diff --git a/langfuse/api/experiments/client.py b/langfuse/api/experiments/client.py index a3d469217..b786fbe35 100644 --- a/langfuse/api/experiments/client.py +++ b/langfuse/api/experiments/client.py @@ -47,7 +47,10 @@ def list( Parameters ---------- from_start_time : dt.datetime - Retrieve only experiments on or after this datetime. + Required. Retrieve only experiments with events on or after this + datetime. A lower bound is required so the query stays fast on + large projects; pair it with `toStartTime` to select a specific + window. fields : typing.Optional[str] Comma-separated list of field groups to include. Available groups: @@ -145,7 +148,10 @@ def list_items( Parameters ---------- from_start_time : dt.datetime - Retrieve only experiment items started on or after this datetime. + Required. Retrieve only experiment items started on or after this + datetime. A lower bound is required so the query stays fast on + large projects; pair it with `toStartTime` to select a specific + window. fields : typing.Optional[str] Comma-separated list of field groups to include. Available groups: @@ -263,7 +269,10 @@ async def list( Parameters ---------- from_start_time : dt.datetime - Retrieve only experiments on or after this datetime. + Required. Retrieve only experiments with events on or after this + datetime. A lower bound is required so the query stays fast on + large projects; pair it with `toStartTime` to select a specific + window. fields : typing.Optional[str] Comma-separated list of field groups to include. Available groups: @@ -368,7 +377,10 @@ async def list_items( Parameters ---------- from_start_time : dt.datetime - Retrieve only experiment items started on or after this datetime. + Required. Retrieve only experiment items started on or after this + datetime. A lower bound is required so the query stays fast on + large projects; pair it with `toStartTime` to select a specific + window. fields : typing.Optional[str] Comma-separated list of field groups to include. Available groups: diff --git a/langfuse/api/experiments/raw_client.py b/langfuse/api/experiments/raw_client.py index 8736786df..c65bbdaa1 100644 --- a/langfuse/api/experiments/raw_client.py +++ b/langfuse/api/experiments/raw_client.py @@ -45,7 +45,10 @@ def list( Parameters ---------- from_start_time : dt.datetime - Retrieve only experiments on or after this datetime. + Required. Retrieve only experiments with events on or after this + datetime. A lower bound is required so the query stays fast on + large projects; pair it with `toStartTime` to select a specific + window. fields : typing.Optional[str] Comma-separated list of field groups to include. Available groups: @@ -205,7 +208,10 @@ def list_items( Parameters ---------- from_start_time : dt.datetime - Retrieve only experiment items started on or after this datetime. + Required. Retrieve only experiment items started on or after this + datetime. A lower bound is required so the query stays fast on + large projects; pair it with `toStartTime` to select a specific + window. fields : typing.Optional[str] Comma-separated list of field groups to include. Available groups: @@ -374,7 +380,10 @@ async def list( Parameters ---------- from_start_time : dt.datetime - Retrieve only experiments on or after this datetime. + Required. Retrieve only experiments with events on or after this + datetime. A lower bound is required so the query stays fast on + large projects; pair it with `toStartTime` to select a specific + window. fields : typing.Optional[str] Comma-separated list of field groups to include. Available groups: @@ -534,7 +543,10 @@ async def list_items( Parameters ---------- from_start_time : dt.datetime - Retrieve only experiment items started on or after this datetime. + Required. Retrieve only experiment items started on or after this + datetime. A lower bound is required so the query stays fast on + large projects; pair it with `toStartTime` to select a specific + window. fields : typing.Optional[str] Comma-separated list of field groups to include. Available groups: From 1d773dfd6492b686e22d33afb85513b3e1241eda Mon Sep 17 00:00:00 2001 From: Niklas Semmler Date: Wed, 7 Oct 2026 17:53:52 +0200 Subject: [PATCH 2/2] docs(api): use language-neutral wording for experiments time window Regenerated from langfuse/langfuse branch docs/experiments-from-start-time-neutral-wording. The fromStartTime docstrings named `toStartTime`, but the Python parameter is `to_start_time`; they now say "an upper bound" instead. Co-Authored-By: Claude Opus 5.5 (1M context) --- langfuse/api/experiments/client.py | 8 ++++---- langfuse/api/experiments/raw_client.py | 8 ++++---- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/langfuse/api/experiments/client.py b/langfuse/api/experiments/client.py index b786fbe35..66a90d95b 100644 --- a/langfuse/api/experiments/client.py +++ b/langfuse/api/experiments/client.py @@ -49,7 +49,7 @@ def list( from_start_time : dt.datetime Required. Retrieve only experiments with events on or after this datetime. A lower bound is required so the query stays fast on - large projects; pair it with `toStartTime` to select a specific + large projects; pair it with an upper bound to select a specific window. fields : typing.Optional[str] @@ -150,7 +150,7 @@ def list_items( from_start_time : dt.datetime Required. Retrieve only experiment items started on or after this datetime. A lower bound is required so the query stays fast on - large projects; pair it with `toStartTime` to select a specific + large projects; pair it with an upper bound to select a specific window. fields : typing.Optional[str] @@ -271,7 +271,7 @@ async def list( from_start_time : dt.datetime Required. Retrieve only experiments with events on or after this datetime. A lower bound is required so the query stays fast on - large projects; pair it with `toStartTime` to select a specific + large projects; pair it with an upper bound to select a specific window. fields : typing.Optional[str] @@ -379,7 +379,7 @@ async def list_items( from_start_time : dt.datetime Required. Retrieve only experiment items started on or after this datetime. A lower bound is required so the query stays fast on - large projects; pair it with `toStartTime` to select a specific + large projects; pair it with an upper bound to select a specific window. fields : typing.Optional[str] diff --git a/langfuse/api/experiments/raw_client.py b/langfuse/api/experiments/raw_client.py index c65bbdaa1..189c826ba 100644 --- a/langfuse/api/experiments/raw_client.py +++ b/langfuse/api/experiments/raw_client.py @@ -47,7 +47,7 @@ def list( from_start_time : dt.datetime Required. Retrieve only experiments with events on or after this datetime. A lower bound is required so the query stays fast on - large projects; pair it with `toStartTime` to select a specific + large projects; pair it with an upper bound to select a specific window. fields : typing.Optional[str] @@ -210,7 +210,7 @@ def list_items( from_start_time : dt.datetime Required. Retrieve only experiment items started on or after this datetime. A lower bound is required so the query stays fast on - large projects; pair it with `toStartTime` to select a specific + large projects; pair it with an upper bound to select a specific window. fields : typing.Optional[str] @@ -382,7 +382,7 @@ async def list( from_start_time : dt.datetime Required. Retrieve only experiments with events on or after this datetime. A lower bound is required so the query stays fast on - large projects; pair it with `toStartTime` to select a specific + large projects; pair it with an upper bound to select a specific window. fields : typing.Optional[str] @@ -545,7 +545,7 @@ async def list_items( from_start_time : dt.datetime Required. Retrieve only experiment items started on or after this datetime. A lower bound is required so the query stays fast on - large projects; pair it with `toStartTime` to select a specific + large projects; pair it with an upper bound to select a specific window. fields : typing.Optional[str]