chore: update client

Author: hassiebp

langfuse/api/reference.md

@@ -2419,7 +2419,7 @@ JSON string containing the query parameters with the following structure:
   "metrics": [              // Required. At least one metric must be provided
     {
       "measure": string,    // What to measure, e.g. "count", "latency", "value"
-      "aggregation": string // How to aggregate, e.g. "count", "sum", "avg", "p95"
+      "aggregation": string // How to aggregate, e.g. "count", "sum", "avg", "p95", "histogram"
     }
   ],
   "filters": [              // Optional. Default: []
@@ -2441,7 +2441,11 @@ JSON string containing the query parameters with the following structure:
       "field": string,      // Field to order by
       "direction": string   // "asc" or "desc"
     }
-  ]
+  ],
+  "config": {               // Optional. Query-specific configuration
+    "bins": number,         // Optional. Number of bins for histogram (1-100), default: 10
+    "row_limit": number     // Optional. Row limit for results (1-1000)
+  }
 }
 ```
 
@@ -6024,6 +6028,14 @@ client.trace.list()
 <dl>
 <dd>
 
+**fields:** `typing.Optional[str]` — Comma-separated list of fields to include in the response. Available field groups are 'core' (always included), 'io' (input, output, metadata), 'scores', 'observations', 'metrics'. If not provided, all fields are included. Example: 'core,scores,metrics'
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.
 
 </dd>

langfuse/api/resources/metrics/client.py

@@ -40,7 +40,7 @@ def metrics(
               "metrics": [              // Required. At least one metric must be provided
                 {
                   "measure": string,    // What to measure, e.g. "count", "latency", "value"
-                  "aggregation": string // How to aggregate, e.g. "count", "sum", "avg", "p95"
+                  "aggregation": string // How to aggregate, e.g. "count", "sum", "avg", "p95", "histogram"
                 }
               ],
               "filters": [              // Optional. Default: []
@@ -62,7 +62,11 @@ def metrics(
                   "field": string,      // Field to order by
                   "direction": string   // "asc" or "desc"
                 }
-              ]
+              ],
+              "config": {               // Optional. Query-specific configuration
+                "bins": number,         // Optional. Number of bins for histogram (1-100), default: 10
+                "row_limit": number     // Optional. Row limit for results (1-1000)
+              }
             }
             ```
 
@@ -147,7 +151,7 @@ async def metrics(
               "metrics": [              // Required. At least one metric must be provided
                 {
                   "measure": string,    // What to measure, e.g. "count", "latency", "value"
-                  "aggregation": string // How to aggregate, e.g. "count", "sum", "avg", "p95"
+                  "aggregation": string // How to aggregate, e.g. "count", "sum", "avg", "p95", "histogram"
                 }
               ],
               "filters": [              // Optional. Default: []
@@ -169,7 +173,11 @@ async def metrics(
                   "field": string,      // Field to order by
                   "direction": string   // "asc" or "desc"
                 }
-              ]
+              ],
+              "config": {               // Optional. Query-specific configuration
+                "bins": number,         // Optional. Number of bins for histogram (1-100), default: 10
+                "row_limit": number     // Optional. Row limit for results (1-1000)
+              }
             }
             ```
 

langfuse/api/resources/metrics/types/metrics_response.py

@@ -12,6 +12,7 @@ class MetricsResponse(pydantic_v1.BaseModel):
     """
     The metrics data. Each item in the list contains the metric values and dimensions requested in the query.
     Format varies based on the query parameters.
+    Histograms will return an array with [lower, upper, height] tuples.
     """
 
     def json(self, **kwargs: typing.Any) -> str:

langfuse/api/resources/trace/client.py

@@ -172,6 +172,7 @@ def list(
         version: typing.Optional[str] = None,
         release: typing.Optional[str] = None,
         environment: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        fields: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Traces:
         """
@@ -212,6 +213,9 @@ def list(
         environment : typing.Optional[typing.Union[str, typing.Sequence[str]]]
             Optional filter for traces where the environment is one of the provided values.
 
+        fields : typing.Optional[str]
+            Comma-separated list of fields to include in the response. Available field groups are 'core' (always included), 'io' (input, output, metadata), 'scores', 'observations', 'metrics'. If not provided, all fields are included. Example: 'core,scores,metrics'
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -253,6 +257,7 @@ def list(
                 "version": version,
                 "release": release,
                 "environment": environment,
+                "fields": fields,
             },
             request_options=request_options,
         )
@@ -518,6 +523,7 @@ async def list(
         version: typing.Optional[str] = None,
         release: typing.Optional[str] = None,
         environment: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        fields: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Traces:
         """
@@ -558,6 +564,9 @@ async def list(
         environment : typing.Optional[typing.Union[str, typing.Sequence[str]]]
             Optional filter for traces where the environment is one of the provided values.
 
+        fields : typing.Optional[str]
+            Comma-separated list of fields to include in the response. Available field groups are 'core' (always included), 'io' (input, output, metadata), 'scores', 'observations', 'metrics'. If not provided, all fields are included. Example: 'core,scores,metrics'
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -607,6 +616,7 @@ async def main() -> None:
                 "version": version,
                 "release": release,
                 "environment": environment,
+                "fields": fields,
             },
             request_options=request_options,
         )