feat(api): update API spec from langfuse/langfuse c04b990

Author: langfuse-bot

langfuse/api/__init__.py

@@ -137,6 +137,7 @@
     OpenAiResponseUsageSchema,
     OpenAiUsage,
     OptionalObservationBody,
+    Organization,
     OrganizationApiKey,
     OrganizationApiKeysResponse,
     OrganizationProject,
@@ -392,6 +393,7 @@
     "OpenAiResponseUsageSchema",
     "OpenAiUsage",
     "OptionalObservationBody",
+    "Organization",
     "OrganizationApiKey",
     "OrganizationApiKeysResponse",
     "OrganizationProject",

langfuse/api/reference.md

@@ -3191,6 +3191,8 @@ JSON string containing the query parameters with the following structure:
 
 Get metrics from the Langfuse project using a query object.
 
+Consider using the [v2 metrics endpoint](/api-reference/metrics-v2/metrics) for better performance.
+
 For more details, see the [Metrics API documentation](https://langfuse.com/docs/metrics/features/metrics-api).
 </dd>
 </dl>
@@ -4007,7 +4009,9 @@ client.observations.get(
 <dl>
 <dd>
 
-Get a list of observations
+Get a list of observations.
+
+Consider using the [v2 observations endpoint](/api-reference/observations-v2/getMany) for cursor-based pagination and field selection.
 </dd>
 </dl>
 </dd>

langfuse/api/resources/__init__.py

@@ -211,6 +211,7 @@
     ApiKeyList,
     ApiKeyResponse,
     ApiKeySummary,
+    Organization,
     Project,
     ProjectDeletionResponse,
     Projects,
@@ -412,6 +413,7 @@
     "OpenAiResponseUsageSchema",
     "OpenAiUsage",
     "OptionalObservationBody",
+    "Organization",
     "OrganizationApiKey",
     "OrganizationApiKeysResponse",
     "OrganizationProject",

langfuse/api/resources/metrics/client.py

@@ -25,6 +25,8 @@ def metrics(
         """
         Get metrics from the Langfuse project using a query object.
 
+        Consider using the [v2 metrics endpoint](/api-reference/metrics-v2/metrics) for better performance.
+
         For more details, see the [Metrics API documentation](https://langfuse.com/docs/metrics/features/metrics-api).
 
         Parameters
@@ -138,6 +140,8 @@ async def metrics(
         """
         Get metrics from the Langfuse project using a query object.
 
+        Consider using the [v2 metrics endpoint](/api-reference/metrics-v2/metrics) for better performance.
+
         For more details, see the [Metrics API documentation](https://langfuse.com/docs/metrics/features/metrics-api).
 
         Parameters

langfuse/api/resources/observations/client.py

@@ -111,7 +111,9 @@ def get_many(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ObservationsViews:
         """
-        Get a list of observations
+        Get a list of observations.
+
+        Consider using the [v2 observations endpoint](/api-reference/observations-v2/getMany) for cursor-based pagination and field selection.
 
         Parameters
         ----------
@@ -412,7 +414,9 @@ async def get_many(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ObservationsViews:
         """
-        Get a list of observations
+        Get a list of observations.
+
+        Consider using the [v2 observations endpoint](/api-reference/observations-v2/getMany) for cursor-based pagination and field selection.
 
         Parameters
         ----------

langfuse/api/resources/projects/__init__.py

@@ -5,6 +5,7 @@
     ApiKeyList,
     ApiKeyResponse,
     ApiKeySummary,
+    Organization,
     Project,
     ProjectDeletionResponse,
     Projects,
@@ -15,6 +16,7 @@
     "ApiKeyList",
     "ApiKeyResponse",
     "ApiKeySummary",
+    "Organization",
     "Project",
     "ProjectDeletionResponse",
     "Projects",

langfuse/api/resources/projects/types/__init__.py

@@ -4,6 +4,7 @@
 from .api_key_list import ApiKeyList
 from .api_key_response import ApiKeyResponse
 from .api_key_summary import ApiKeySummary
+from .organization import Organization
 from .project import Project
 from .project_deletion_response import ProjectDeletionResponse
 from .projects import Projects
@@ -13,6 +14,7 @@
     "ApiKeyList",
     "ApiKeyResponse",
     "ApiKeySummary",
+    "Organization",
     "Project",
     "ProjectDeletionResponse",
     "Projects",

langfuse/api/resources/projects/types/organization.py

@@ -0,0 +1,50 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import datetime as dt
+import typing
+
+from ....core.datetime_utils import serialize_datetime
+from ....core.pydantic_utilities import deep_union_pydantic_dicts, pydantic_v1
+
+
+class Organization(pydantic_v1.BaseModel):
+    id: str = pydantic_v1.Field()
+    """
+    The unique identifier of the organization
+    """
+
+    name: str = pydantic_v1.Field()
+    """
+    The name of the organization
+    """
+
+    def json(self, **kwargs: typing.Any) -> str:
+        kwargs_with_defaults: typing.Any = {
+            "by_alias": True,
+            "exclude_unset": True,
+            **kwargs,
+        }
+        return super().json(**kwargs_with_defaults)
+
+    def dict(self, **kwargs: typing.Any) -> typing.Dict[str, typing.Any]:
+        kwargs_with_defaults_exclude_unset: typing.Any = {
+            "by_alias": True,
+            "exclude_unset": True,
+            **kwargs,
+        }
+        kwargs_with_defaults_exclude_none: typing.Any = {
+            "by_alias": True,
+            "exclude_none": True,
+            **kwargs,
+        }
+
+        return deep_union_pydantic_dicts(
+            super().dict(**kwargs_with_defaults_exclude_unset),
+            super().dict(**kwargs_with_defaults_exclude_none),
+        )
+
+    class Config:
+        frozen = True
+        smart_union = True
+        extra = pydantic_v1.Extra.allow
+        json_encoders = {dt.datetime: serialize_datetime}

langfuse/api/resources/projects/types/project.py

@@ -5,11 +5,17 @@
 
 from ....core.datetime_utils import serialize_datetime
 from ....core.pydantic_utilities import deep_union_pydantic_dicts, pydantic_v1
+from .organization import Organization
 
 
 class Project(pydantic_v1.BaseModel):
     id: str
     name: str
+    organization: Organization = pydantic_v1.Field()
+    """
+    The organization this project belongs to
+    """
+
     metadata: typing.Dict[str, typing.Any] = pydantic_v1.Field()
     """
     Metadata for the project