Skip to content

Commit 438d0ff

Browse files
langfuse-botlangfuse-bot
andauthored
feat(api): update API spec from langfuse/langfuse 99e2ce9 (#1842)
Co-authored-by: langfuse-bot <langfuse-bot@langfuse.com>
1 parent 62df602 commit 438d0ff

18 files changed

Lines changed: 260 additions & 1 deletion

File tree

‎langfuse/api/dataset_run_items/client.py‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
import datetime as dt
44
import typing
55

6+
import typing_extensions
67
from ..commons.types.dataset_run_item import DatasetRunItem
78
from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
89
from ..core.request_options import RequestOptions
@@ -28,6 +29,10 @@ def with_raw_response(self) -> RawDatasetRunItemsClient:
2829
"""
2930
return self._raw_client
3031

32+
@typing_extensions.deprecated(
33+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. In Langfuse v4, create experiment data via the SDK experiment runner or the OpenTelemetry endpoint at POST /api/public/otel/v1/traces. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
34+
category=None,
35+
)
3136
def create(
3237
self,
3338
*,
@@ -107,6 +112,10 @@ def create(
107112
)
108113
return _response.data
109114

115+
@typing_extensions.deprecated(
116+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. In Langfuse v4, dataset run items are replaced by experiment items; use `GET /api/public/experiment-items?fromStartTime=<from>&toStartTime=<to>` instead. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
117+
category=None,
118+
)
110119
def list(
111120
self,
112121
*,
@@ -180,6 +189,10 @@ def with_raw_response(self) -> AsyncRawDatasetRunItemsClient:
180189
"""
181190
return self._raw_client
182191

192+
@typing_extensions.deprecated(
193+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. In Langfuse v4, create experiment data via the SDK experiment runner or the OpenTelemetry endpoint at POST /api/public/otel/v1/traces. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
194+
category=None,
195+
)
183196
async def create(
184197
self,
185198
*,
@@ -267,6 +280,10 @@ async def main() -> None:
267280
)
268281
return _response.data
269282

283+
@typing_extensions.deprecated(
284+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. In Langfuse v4, dataset run items are replaced by experiment items; use `GET /api/public/experiment-items?fromStartTime=<from>&toStartTime=<to>` instead. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
285+
category=None,
286+
)
270287
async def list(
271288
self,
272289
*,

‎langfuse/api/dataset_run_items/raw_client.py‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22

33
import datetime as dt
44
import typing
5+
import typing_extensions
56
from json.decoder import JSONDecodeError
67

78
from ..commons.errors.access_denied_error import AccessDeniedError
@@ -25,6 +26,10 @@ class RawDatasetRunItemsClient:
2526
def __init__(self, *, client_wrapper: SyncClientWrapper):
2627
self._client_wrapper = client_wrapper
2728

29+
@typing_extensions.deprecated(
30+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. In Langfuse v4, create experiment data via the SDK experiment runner or the OpenTelemetry endpoint at POST /api/public/otel/v1/traces. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
31+
category=None,
32+
)
2833
def create(
2934
self,
3035
*,
@@ -168,6 +173,10 @@ def create(
168173
body=_response_json,
169174
)
170175

176+
@typing_extensions.deprecated(
177+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. In Langfuse v4, dataset run items are replaced by experiment items; use `GET /api/public/experiment-items?fromStartTime=<from>&toStartTime=<to>` instead. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
178+
category=None,
179+
)
171180
def list(
172181
self,
173182
*,
@@ -293,6 +302,10 @@ class AsyncRawDatasetRunItemsClient:
293302
def __init__(self, *, client_wrapper: AsyncClientWrapper):
294303
self._client_wrapper = client_wrapper
295304

305+
@typing_extensions.deprecated(
306+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. In Langfuse v4, create experiment data via the SDK experiment runner or the OpenTelemetry endpoint at POST /api/public/otel/v1/traces. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
307+
category=None,
308+
)
296309
async def create(
297310
self,
298311
*,
@@ -436,6 +449,10 @@ async def create(
436449
body=_response_json,
437450
)
438451

452+
@typing_extensions.deprecated(
453+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. In Langfuse v4, dataset run items are replaced by experiment items; use `GET /api/public/experiment-items?fromStartTime=<from>&toStartTime=<to>` instead. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
454+
category=None,
455+
)
439456
async def list(
440457
self,
441458
*,

‎langfuse/api/datasets/client.py‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22

33
import typing
44

5+
import typing_extensions
56
from ..commons.types.dataset import Dataset
67
from ..commons.types.dataset_run_with_items import DatasetRunWithItems
78
from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
@@ -173,6 +174,10 @@ def create(
173174
)
174175
return _response.data
175176

177+
@typing_extensions.deprecated(
178+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. In Langfuse v4, dataset runs are replaced by experiments; use GET /api/public/experiments instead. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
179+
category=None,
180+
)
176181
def get_run(
177182
self,
178183
dataset_name: str,
@@ -218,6 +223,10 @@ def get_run(
218223
)
219224
return _response.data
220225

226+
@typing_extensions.deprecated(
227+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. In Langfuse v4, dataset runs are replaced by experiments. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
228+
category=None,
229+
)
221230
def delete_run(
222231
self,
223232
dataset_name: str,
@@ -263,6 +272,10 @@ def delete_run(
263272
)
264273
return _response.data
265274

275+
@typing_extensions.deprecated(
276+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. In Langfuse v4, dataset runs are replaced by experiments; use GET /api/public/experiments instead. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
277+
category=None,
278+
)
266279
def get_runs(
267280
self,
268281
dataset_name: str,
@@ -497,6 +510,10 @@ async def main() -> None:
497510
)
498511
return _response.data
499512

513+
@typing_extensions.deprecated(
514+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. In Langfuse v4, dataset runs are replaced by experiments; use GET /api/public/experiments instead. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
515+
category=None,
516+
)
500517
async def get_run(
501518
self,
502519
dataset_name: str,
@@ -550,6 +567,10 @@ async def main() -> None:
550567
)
551568
return _response.data
552569

570+
@typing_extensions.deprecated(
571+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. In Langfuse v4, dataset runs are replaced by experiments. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
572+
category=None,
573+
)
553574
async def delete_run(
554575
self,
555576
dataset_name: str,
@@ -603,6 +624,10 @@ async def main() -> None:
603624
)
604625
return _response.data
605626

627+
@typing_extensions.deprecated(
628+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. In Langfuse v4, dataset runs are replaced by experiments; use GET /api/public/experiments instead. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
629+
category=None,
630+
)
606631
async def get_runs(
607632
self,
608633
dataset_name: str,

‎langfuse/api/datasets/raw_client.py‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
# This file was auto-generated by Fern from our API Definition.
22

33
import typing
4+
import typing_extensions
45
from json.decoder import JSONDecodeError
56

67
from ..commons.errors.access_denied_error import AccessDeniedError
@@ -368,6 +369,10 @@ def create(
368369
body=_response_json,
369370
)
370371

372+
@typing_extensions.deprecated(
373+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. In Langfuse v4, dataset runs are replaced by experiments; use GET /api/public/experiments instead. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
374+
category=None,
375+
)
371376
def get_run(
372377
self,
373378
dataset_name: str,
@@ -474,6 +479,10 @@ def get_run(
474479
body=_response_json,
475480
)
476481

482+
@typing_extensions.deprecated(
483+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. In Langfuse v4, dataset runs are replaced by experiments. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
484+
category=None,
485+
)
477486
def delete_run(
478487
self,
479488
dataset_name: str,
@@ -580,6 +589,10 @@ def delete_run(
580589
body=_response_json,
581590
)
582591

592+
@typing_extensions.deprecated(
593+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. In Langfuse v4, dataset runs are replaced by experiments; use GET /api/public/experiments instead. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
594+
category=None,
595+
)
583596
def get_runs(
584597
self,
585598
dataset_name: str,
@@ -1040,6 +1053,10 @@ async def create(
10401053
body=_response_json,
10411054
)
10421055

1056+
@typing_extensions.deprecated(
1057+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. In Langfuse v4, dataset runs are replaced by experiments; use GET /api/public/experiments instead. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
1058+
category=None,
1059+
)
10431060
async def get_run(
10441061
self,
10451062
dataset_name: str,
@@ -1146,6 +1163,10 @@ async def get_run(
11461163
body=_response_json,
11471164
)
11481165

1166+
@typing_extensions.deprecated(
1167+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. In Langfuse v4, dataset runs are replaced by experiments. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
1168+
category=None,
1169+
)
11491170
async def delete_run(
11501171
self,
11511172
dataset_name: str,
@@ -1252,6 +1273,10 @@ async def delete_run(
12521273
body=_response_json,
12531274
)
12541275

1276+
@typing_extensions.deprecated(
1277+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. In Langfuse v4, dataset runs are replaced by experiments; use GET /api/public/experiments instead. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
1278+
category=None,
1279+
)
12551280
async def get_runs(
12561281
self,
12571282
dataset_name: str,

‎langfuse/api/ingestion/client.py‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22

33
import typing
44

5+
import typing_extensions
56
from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
67
from ..core.request_options import RequestOptions
78
from .raw_client import AsyncRawIngestionClient, RawIngestionClient
@@ -27,6 +28,10 @@ def with_raw_response(self) -> RawIngestionClient:
2728
"""
2829
return self._raw_client
2930

31+
@typing_extensions.deprecated(
32+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. Send data via the OpenTelemetry endpoint at `POST /api/public/otel/v1/traces` instead, see the [OpenTelemetry integration docs](https://langfuse.com/integrations/native/opentelemetry). Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
33+
category=None,
34+
)
3035
def batch(
3136
self,
3237
*,
@@ -128,6 +133,10 @@ def with_raw_response(self) -> AsyncRawIngestionClient:
128133
"""
129134
return self._raw_client
130135

136+
@typing_extensions.deprecated(
137+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. Send data via the OpenTelemetry endpoint at `POST /api/public/otel/v1/traces` instead, see the [OpenTelemetry integration docs](https://langfuse.com/integrations/native/opentelemetry). Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
138+
category=None,
139+
)
131140
async def batch(
132141
self,
133142
*,

‎langfuse/api/ingestion/raw_client.py‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
# This file was auto-generated by Fern from our API Definition.
22

33
import typing
4+
import typing_extensions
45
from json.decoder import JSONDecodeError
56

67
from ..commons.errors.access_denied_error import AccessDeniedError
@@ -25,6 +26,10 @@ class RawIngestionClient:
2526
def __init__(self, *, client_wrapper: SyncClientWrapper):
2627
self._client_wrapper = client_wrapper
2728

29+
@typing_extensions.deprecated(
30+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. Send data via the OpenTelemetry endpoint at `POST /api/public/otel/v1/traces` instead, see the [OpenTelemetry integration docs](https://langfuse.com/integrations/native/opentelemetry). Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
31+
category=None,
32+
)
2833
def batch(
2934
self,
3035
*,
@@ -161,6 +166,10 @@ class AsyncRawIngestionClient:
161166
def __init__(self, *, client_wrapper: AsyncClientWrapper):
162167
self._client_wrapper = client_wrapper
163168

169+
@typing_extensions.deprecated(
170+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. Send data via the OpenTelemetry endpoint at `POST /api/public/otel/v1/traces` instead, see the [OpenTelemetry integration docs](https://langfuse.com/integrations/native/opentelemetry). Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
171+
category=None,
172+
)
164173
async def batch(
165174
self,
166175
*,

‎langfuse/api/legacy/metrics_v1/client.py‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22

33
import typing
44

5+
import typing_extensions
56
from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
67
from ...core.request_options import RequestOptions
78
from .raw_client import AsyncRawMetricsV1Client, RawMetricsV1Client
@@ -23,6 +24,10 @@ def with_raw_response(self) -> RawMetricsV1Client:
2324
"""
2425
return self._raw_client
2526

27+
@typing_extensions.deprecated(
28+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. Use `GET /api/public/v2/metrics?query=<urlencoded json query>` instead. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
29+
category=None,
30+
)
2631
def metrics(
2732
self, *, query: str, request_options: typing.Optional[RequestOptions] = None
2833
) -> MetricsResponse:
@@ -122,6 +127,10 @@ def with_raw_response(self) -> AsyncRawMetricsV1Client:
122127
"""
123128
return self._raw_client
124129

130+
@typing_extensions.deprecated(
131+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. Use `GET /api/public/v2/metrics?query=<urlencoded json query>` instead. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
132+
category=None,
133+
)
125134
async def metrics(
126135
self, *, query: str, request_options: typing.Optional[RequestOptions] = None
127136
) -> MetricsResponse:

‎langfuse/api/legacy/metrics_v1/raw_client.py‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
# This file was auto-generated by Fern from our API Definition.
22

33
import typing
4+
import typing_extensions
45
from json.decoder import JSONDecodeError
56

67
from ...commons.errors.access_denied_error import AccessDeniedError
@@ -20,6 +21,10 @@ class RawMetricsV1Client:
2021
def __init__(self, *, client_wrapper: SyncClientWrapper):
2122
self._client_wrapper = client_wrapper
2223

24+
@typing_extensions.deprecated(
25+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. Use `GET /api/public/v2/metrics?query=<urlencoded json query>` instead. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
26+
category=None,
27+
)
2328
def metrics(
2429
self, *, query: str, request_options: typing.Optional[RequestOptions] = None
2530
) -> HttpResponse[MetricsResponse]:
@@ -173,6 +178,10 @@ class AsyncRawMetricsV1Client:
173178
def __init__(self, *, client_wrapper: AsyncClientWrapper):
174179
self._client_wrapper = client_wrapper
175180

181+
@typing_extensions.deprecated(
182+
"On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on November 16, 2026. Use `GET /api/public/v2/metrics?query=<urlencoded json query>` instead. Self-hosted deployments are unaffected by this date; the endpoint becomes unavailable when they upgrade to Langfuse v4.",
183+
category=None,
184+
)
176185
async def metrics(
177186
self, *, query: str, request_options: typing.Optional[RequestOptions] = None
178187
) -> AsyncHttpResponse[MetricsResponse]:

0 commit comments

Comments
 (0)