feat(api): update API spec from langfuse/langfuse 5a31664

langfuse/api/__init__.py

@@ -304,7 +304,6 @@
         IngestionEvent_ObservationCreate,
         IngestionEvent_ObservationUpdate,
         IngestionEvent_ScoreCreate,
-        IngestionEvent_SdkLog,
         IngestionEvent_SpanCreate,
         IngestionEvent_SpanUpdate,
         IngestionEvent_TraceCreate,
@@ -319,8 +318,6 @@
         OptionalObservationBody,
         ScoreBody,
         ScoreEvent,
-        SdkLogBody,
-        SdkLogEvent,
         TraceBody,
         TraceEvent,
         UpdateEventBody,
@@ -669,7 +666,6 @@
     "IngestionEvent_ObservationCreate": ".ingestion",
     "IngestionEvent_ObservationUpdate": ".ingestion",
     "IngestionEvent_ScoreCreate": ".ingestion",
-    "IngestionEvent_SdkLog": ".ingestion",
     "IngestionEvent_SpanCreate": ".ingestion",
     "IngestionEvent_SpanUpdate": ".ingestion",
     "IngestionEvent_TraceCreate": ".ingestion",
@@ -820,8 +816,6 @@
     "Score_Correction": ".commons",
     "Score_Numeric": ".commons",
     "Score_Text": ".commons",
-    "SdkLogBody": ".ingestion",
-    "SdkLogEvent": ".ingestion",
     "ServiceProviderConfig": ".scim",
     "ServiceUnavailableError": ".health",
     "Session": ".commons",
@@ -1124,7 +1118,6 @@ def __dir__():
     "IngestionEvent_ObservationCreate",
     "IngestionEvent_ObservationUpdate",
     "IngestionEvent_ScoreCreate",
-    "IngestionEvent_SdkLog",
     "IngestionEvent_SpanCreate",
     "IngestionEvent_SpanUpdate",
     "IngestionEvent_TraceCreate",
@@ -1275,8 +1268,6 @@ def __dir__():
     "Score_Correction",
     "Score_Numeric",
     "Score_Text",
-    "SdkLogBody",
-    "SdkLogEvent",
     "ServiceProviderConfig",
     "ServiceUnavailableError",
     "Session",

langfuse/api/comments/client.py

@@ -1,5 +1,6 @@
 # This file was auto-generated by Fern from our API Definition.
 
+import datetime as dt
 import typing
 
 from ..commons.types.comment import Comment
@@ -36,6 +37,7 @@ def create(
         object_id: str,
         content: str,
         author_user_id: typing.Optional[str] = OMIT,
+        object_start_time: typing.Optional[dt.datetime] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> CreateCommentResponse:
         """
@@ -58,6 +60,9 @@ def create(
         author_user_id : typing.Optional[str]
             The id of the user who created the comment. Must be a member of the organization that owns the project, otherwise an error will be thrown.
 
+        object_start_time : typing.Optional[dt.datetime]
+            The start time of the referenced object (for observations, the observation's start time). Optional performance hint - when provided, Langfuse narrows the lookup to validate the reference faster. It only affects speed - an incorrect or omitted value never changes the result.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -90,6 +95,7 @@ def create(
             object_id=object_id,
             content=content,
             author_user_id=author_user_id,
+            object_start_time=object_start_time,
             request_options=request_options,
         )
         return _response.data
@@ -221,6 +227,7 @@ async def create(
         object_id: str,
         content: str,
         author_user_id: typing.Optional[str] = OMIT,
+        object_start_time: typing.Optional[dt.datetime] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> CreateCommentResponse:
         """
@@ -243,6 +250,9 @@ async def create(
         author_user_id : typing.Optional[str]
             The id of the user who created the comment. Must be a member of the organization that owns the project, otherwise an error will be thrown.
 
+        object_start_time : typing.Optional[dt.datetime]
+            The start time of the referenced object (for observations, the observation's start time). Optional performance hint - when provided, Langfuse narrows the lookup to validate the reference faster. It only affects speed - an incorrect or omitted value never changes the result.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -283,6 +293,7 @@ async def main() -> None:
             object_id=object_id,
             content=content,
             author_user_id=author_user_id,
+            object_start_time=object_start_time,
             request_options=request_options,
         )
         return _response.data

langfuse/api/comments/raw_client.py

@@ -1,5 +1,6 @@
 # This file was auto-generated by Fern from our API Definition.
 
+import datetime as dt
 import typing
 from json.decoder import JSONDecodeError
 
@@ -34,6 +35,7 @@ def create(
         object_id: str,
         content: str,
         author_user_id: typing.Optional[str] = OMIT,
+        object_start_time: typing.Optional[dt.datetime] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[CreateCommentResponse]:
         """
@@ -56,6 +58,9 @@ def create(
         author_user_id : typing.Optional[str]
             The id of the user who created the comment. Must be a member of the organization that owns the project, otherwise an error will be thrown.
 
+        object_start_time : typing.Optional[dt.datetime]
+            The start time of the referenced object (for observations, the observation's start time). Optional performance hint - when provided, Langfuse narrows the lookup to validate the reference faster. It only affects speed - an incorrect or omitted value never changes the result.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -72,6 +77,7 @@ def create(
                 "objectId": object_id,
                 "content": content,
                 "authorUserId": author_user_id,
+                "objectStartTime": object_start_time,
             },
             request_options=request_options,
             omit=OMIT,
@@ -398,6 +404,7 @@ async def create(
         object_id: str,
         content: str,
         author_user_id: typing.Optional[str] = OMIT,
+        object_start_time: typing.Optional[dt.datetime] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[CreateCommentResponse]:
         """
@@ -420,6 +427,9 @@ async def create(
         author_user_id : typing.Optional[str]
             The id of the user who created the comment. Must be a member of the organization that owns the project, otherwise an error will be thrown.
 
+        object_start_time : typing.Optional[dt.datetime]
+            The start time of the referenced object (for observations, the observation's start time). Optional performance hint - when provided, Langfuse narrows the lookup to validate the reference faster. It only affects speed - an incorrect or omitted value never changes the result.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -436,6 +446,7 @@ async def create(
                 "objectId": object_id,
                 "content": content,
                 "authorUserId": author_user_id,
+                "objectStartTime": object_start_time,
             },
             request_options=request_options,
             omit=OMIT,

langfuse/api/comments/types/create_comment_request.py

@@ -1,5 +1,6 @@
 # This file was auto-generated by Fern from our API Definition.
 
+import datetime as dt
 import typing
 
 import pydantic
@@ -42,6 +43,13 @@ class CreateCommentRequest(UniversalBaseModel):
     The id of the user who created the comment. Must be a member of the organization that owns the project, otherwise an error will be thrown.
     """
 
+    object_start_time: typing_extensions.Annotated[
+        typing.Optional[dt.datetime], FieldMetadata(alias="objectStartTime")
+    ] = pydantic.Field(default=None)
+    """
+    The start time of the referenced object (for observations, the observation's start time). Optional performance hint - when provided, Langfuse narrows the lookup to validate the reference faster. It only affects speed - an incorrect or omitted value never changes the result.
+    """
+
     model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
         extra="allow", frozen=True
     )

langfuse/api/ingestion/__init__.py

@@ -23,7 +23,6 @@
         IngestionEvent_ObservationCreate,
         IngestionEvent_ObservationUpdate,
         IngestionEvent_ScoreCreate,
-        IngestionEvent_SdkLog,
         IngestionEvent_SpanCreate,
         IngestionEvent_SpanUpdate,
         IngestionEvent_TraceCreate,
@@ -38,8 +37,6 @@
         OptionalObservationBody,
         ScoreBody,
         ScoreEvent,
-        SdkLogBody,
-        SdkLogEvent,
         TraceBody,
         TraceEvent,
         UpdateEventBody,
@@ -67,7 +64,6 @@
     "IngestionEvent_ObservationCreate": ".types",
     "IngestionEvent_ObservationUpdate": ".types",
     "IngestionEvent_ScoreCreate": ".types",
-    "IngestionEvent_SdkLog": ".types",
     "IngestionEvent_SpanCreate": ".types",
     "IngestionEvent_SpanUpdate": ".types",
     "IngestionEvent_TraceCreate": ".types",
@@ -82,8 +78,6 @@
     "OptionalObservationBody": ".types",
     "ScoreBody": ".types",
     "ScoreEvent": ".types",
-    "SdkLogBody": ".types",
-    "SdkLogEvent": ".types",
     "TraceBody": ".types",
     "TraceEvent": ".types",
     "UpdateEventBody": ".types",
@@ -140,7 +134,6 @@ def __dir__():
     "IngestionEvent_ObservationCreate",
     "IngestionEvent_ObservationUpdate",
     "IngestionEvent_ScoreCreate",
-    "IngestionEvent_SdkLog",
     "IngestionEvent_SpanCreate",
     "IngestionEvent_SpanUpdate",
     "IngestionEvent_TraceCreate",
@@ -155,8 +148,6 @@ def __dir__():
     "OptionalObservationBody",
     "ScoreBody",
     "ScoreEvent",
-    "SdkLogBody",
-    "SdkLogEvent",
     "TraceBody",
     "TraceEvent",
     "UpdateEventBody",

langfuse/api/ingestion/client.py

@@ -29,7 +29,7 @@ def with_raw_response(self) -> RawIngestionClient:
         return self._raw_client
 
     @typing_extensions.deprecated(
-        "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.",
+        "On Langfuse Cloud, this is the deprecated Langfuse v3 ingestion API and it is shut down on November 16, 2026, except for score events: from that date it accepts only `score-create` events and rejects all other event types. To write scores, prefer `POST /api/public/scores`; see the [Scores API docs](https://langfuse.com/docs/api-and-data-platform/features/scores-api). To write traces and observations, always prefer upgrading to the current Python and JS SDKs; if you use custom auto-instrumentation, send them to the OpenTelemetry endpoint at `POST /api/public/otel/v1/traces` (for example with curl); see the [OpenTelemetry integration docs](https://langfuse.com/integrations/native/opentelemetry). To read data back, use the v4 read APIs; see the [Observations API docs](https://langfuse.com/docs/api-and-data-platform/features/observations-api) and the [Metrics API docs](https://langfuse.com/docs/metrics/features/metrics-api). The only path to live data is OpenTelemetry ingestion combined with `GET /api/public/v2/observations` and `GET /api/public/v2/metrics`; all other public APIs may have data delays of several minutes. Self-hosted deployments are unaffected by the November 16 date; this behavior begins only when they enable v4-only write mode.",
         category=None,
     )
     def batch(
@@ -42,7 +42,15 @@ def batch(
         """
         **Legacy endpoint for batch ingestion for Langfuse Observability.**
 
-        -> Please use the OpenTelemetry endpoint (`/api/public/otel/v1/traces`). Learn more: https://langfuse.com/integrations/native/opentelemetry
+        This is the deprecated Langfuse v3 ingestion API. It is shut down on November 16, 2026, except for score events: from that date it accepts only `score-create` events and rejects all other event types.
+
+        To write scores, prefer `POST /api/public/scores`: https://langfuse.com/docs/api-and-data-platform/features/scores-api
+
+        To write traces and observations, always prefer upgrading to the current Python and JS SDKs. If you use custom auto-instrumentation, send them to the OpenTelemetry endpoint (`POST /api/public/otel/v1/traces`), for example with curl: https://langfuse.com/integrations/native/opentelemetry
+
+        To read data back, use the v4 read APIs: https://langfuse.com/docs/api-and-data-platform/features/observations-api and https://langfuse.com/docs/metrics/features/metrics-api
+
+        The only path to live data is OpenTelemetry ingestion combined with `GET /api/public/v2/observations` and `GET /api/public/v2/metrics`. All other public APIs may have data delays of several minutes.
 
         Within each batch, there can be multiple events.
         Each event has a type, an id, a timestamp, metadata and a body.
@@ -59,7 +67,7 @@ def batch(
         Parameters
         ----------
         batch : typing.Sequence[IngestionEvent]
-            Batch of tracing events to be ingested. Discriminated by attribute `type`.
+            Batch of events to be ingested, discriminated by attribute `type`. From November 16, 2026 on Langfuse Cloud, only `score-create` events are accepted; all other event types are rejected.
 
         metadata : typing.Optional[typing.Any]
             Optional. Metadata field used by the Langfuse SDKs for debugging.
@@ -134,7 +142,7 @@ def with_raw_response(self) -> AsyncRawIngestionClient:
         return self._raw_client
 
     @typing_extensions.deprecated(
-        "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.",
+        "On Langfuse Cloud, this is the deprecated Langfuse v3 ingestion API and it is shut down on November 16, 2026, except for score events: from that date it accepts only `score-create` events and rejects all other event types. To write scores, prefer `POST /api/public/scores`; see the [Scores API docs](https://langfuse.com/docs/api-and-data-platform/features/scores-api). To write traces and observations, always prefer upgrading to the current Python and JS SDKs; if you use custom auto-instrumentation, send them to the OpenTelemetry endpoint at `POST /api/public/otel/v1/traces` (for example with curl); see the [OpenTelemetry integration docs](https://langfuse.com/integrations/native/opentelemetry). To read data back, use the v4 read APIs; see the [Observations API docs](https://langfuse.com/docs/api-and-data-platform/features/observations-api) and the [Metrics API docs](https://langfuse.com/docs/metrics/features/metrics-api). The only path to live data is OpenTelemetry ingestion combined with `GET /api/public/v2/observations` and `GET /api/public/v2/metrics`; all other public APIs may have data delays of several minutes. Self-hosted deployments are unaffected by the November 16 date; this behavior begins only when they enable v4-only write mode.",
         category=None,
     )
     async def batch(
@@ -147,7 +155,15 @@ async def batch(
         """
         **Legacy endpoint for batch ingestion for Langfuse Observability.**
 
-        -> Please use the OpenTelemetry endpoint (`/api/public/otel/v1/traces`). Learn more: https://langfuse.com/integrations/native/opentelemetry
+        This is the deprecated Langfuse v3 ingestion API. It is shut down on November 16, 2026, except for score events: from that date it accepts only `score-create` events and rejects all other event types.
+
+        To write scores, prefer `POST /api/public/scores`: https://langfuse.com/docs/api-and-data-platform/features/scores-api
+
+        To write traces and observations, always prefer upgrading to the current Python and JS SDKs. If you use custom auto-instrumentation, send them to the OpenTelemetry endpoint (`POST /api/public/otel/v1/traces`), for example with curl: https://langfuse.com/integrations/native/opentelemetry
+
+        To read data back, use the v4 read APIs: https://langfuse.com/docs/api-and-data-platform/features/observations-api and https://langfuse.com/docs/metrics/features/metrics-api
+
+        The only path to live data is OpenTelemetry ingestion combined with `GET /api/public/v2/observations` and `GET /api/public/v2/metrics`. All other public APIs may have data delays of several minutes.
 
         Within each batch, there can be multiple events.
         Each event has a type, an id, a timestamp, metadata and a body.
@@ -164,7 +180,7 @@ async def batch(
         Parameters
         ----------
         batch : typing.Sequence[IngestionEvent]
-            Batch of tracing events to be ingested. Discriminated by attribute `type`.
+            Batch of events to be ingested, discriminated by attribute `type`. From November 16, 2026 on Langfuse Cloud, only `score-create` events are accepted; all other event types are rejected.
 
         metadata : typing.Optional[typing.Any]
             Optional. Metadata field used by the Langfuse SDKs for debugging.