feat(api): update API spec from langfuse/langfuse 784ab09

Author: langfuse-bot

langfuse/api/observations_v2/client.py

@@ -93,8 +93,9 @@ def get_many(
             Base64-encoded cursor for pagination. Use the cursor from the previous response to get the next page.
 
         parse_io_as_json : typing.Optional[bool]
-            Set to `true` to parse input/output fields as JSON, or `false` to return raw strings.
-            Defaults to `false` if not provided.
+            **Deprecated.** Setting this to `true` will return a 400 error.
+            Input/output fields are always returned as raw strings.
+            Remove this parameter or set it to `false`.
 
         name : typing.Optional[str]
 
@@ -344,8 +345,9 @@ async def get_many(
             Base64-encoded cursor for pagination. Use the cursor from the previous response to get the next page.
 
         parse_io_as_json : typing.Optional[bool]
-            Set to `true` to parse input/output fields as JSON, or `false` to return raw strings.
-            Defaults to `false` if not provided.
+            **Deprecated.** Setting this to `true` will return a 400 error.
+            Input/output fields are always returned as raw strings.
+            Remove this parameter or set it to `false`.
 
         name : typing.Optional[str]
 

langfuse/api/observations_v2/raw_client.py

@@ -91,8 +91,9 @@ def get_many(
             Base64-encoded cursor for pagination. Use the cursor from the previous response to get the next page.
 
         parse_io_as_json : typing.Optional[bool]
-            Set to `true` to parse input/output fields as JSON, or `false` to return raw strings.
-            Defaults to `false` if not provided.
+            **Deprecated.** Setting this to `true` will return a 400 error.
+            Input/output fields are always returned as raw strings.
+            Remove this parameter or set it to `false`.
 
         name : typing.Optional[str]
 
@@ -401,8 +402,9 @@ async def get_many(
             Base64-encoded cursor for pagination. Use the cursor from the previous response to get the next page.
 
         parse_io_as_json : typing.Optional[bool]
-            Set to `true` to parse input/output fields as JSON, or `false` to return raw strings.
-            Defaults to `false` if not provided.
+            **Deprecated.** Setting this to `true` will return a 400 error.
+            Input/output fields are always returned as raw strings.
+            Remove this parameter or set it to `false`.
 
         name : typing.Optional[str]
 

langfuse/api/score_v2/client.py

@@ -50,6 +50,7 @@ def get(
         data_type: typing.Optional[ScoreDataType] = None,
         trace_tags: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         fields: typing.Optional[str] = None,
+        filter: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> GetScoresResponse:
         """
@@ -117,6 +118,9 @@ def get(
         fields : typing.Optional[str]
             Comma-separated list of field groups to include in the response. Available field groups: 'score' (core score fields), 'trace' (trace properties: userId, tags, environment). If not specified, both 'score' and 'trace' are returned by default. Example: 'score' to exclude trace data, 'score,trace' to include both. Note: When filtering by trace properties (using userId or traceTags parameters), the 'trace' field group must be included, otherwise a 400 error will be returned.
 
+        filter : typing.Optional[str]
+            A JSON stringified array of filter objects. Each object requires type, column, operator, and value. Supports filtering by score metadata using the stringObject type. Example: [{"type":"stringObject","column":"metadata","key":"user_id","operator":"=","value":"abc123"}]. Supported types: stringObject (metadata key-value filtering), string, number, datetime, stringOptions, arrayOptions. Supported operators for stringObject: =, contains, does not contain, starts with, ends with.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -159,6 +163,7 @@ def get(
             data_type=data_type,
             trace_tags=trace_tags,
             fields=fields,
+            filter=filter,
             request_options=request_options,
         )
         return _response.data
@@ -241,6 +246,7 @@ async def get(
         data_type: typing.Optional[ScoreDataType] = None,
         trace_tags: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         fields: typing.Optional[str] = None,
+        filter: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> GetScoresResponse:
         """
@@ -308,6 +314,9 @@ async def get(
         fields : typing.Optional[str]
             Comma-separated list of field groups to include in the response. Available field groups: 'score' (core score fields), 'trace' (trace properties: userId, tags, environment). If not specified, both 'score' and 'trace' are returned by default. Example: 'score' to exclude trace data, 'score,trace' to include both. Note: When filtering by trace properties (using userId or traceTags parameters), the 'trace' field group must be included, otherwise a 400 error will be returned.
 
+        filter : typing.Optional[str]
+            A JSON stringified array of filter objects. Each object requires type, column, operator, and value. Supports filtering by score metadata using the stringObject type. Example: [{"type":"stringObject","column":"metadata","key":"user_id","operator":"=","value":"abc123"}]. Supported types: stringObject (metadata key-value filtering), string, number, datetime, stringOptions, arrayOptions. Supported operators for stringObject: =, contains, does not contain, starts with, ends with.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -358,6 +367,7 @@ async def main() -> None:
             data_type=data_type,
             trace_tags=trace_tags,
             fields=fields,
+            filter=filter,
             request_options=request_options,
         )
         return _response.data

langfuse/api/score_v2/raw_client.py

@@ -49,6 +49,7 @@ def get(
         data_type: typing.Optional[ScoreDataType] = None,
         trace_tags: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         fields: typing.Optional[str] = None,
+        filter: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[GetScoresResponse]:
         """
@@ -116,6 +117,9 @@ def get(
         fields : typing.Optional[str]
             Comma-separated list of field groups to include in the response. Available field groups: 'score' (core score fields), 'trace' (trace properties: userId, tags, environment). If not specified, both 'score' and 'trace' are returned by default. Example: 'score' to exclude trace data, 'score,trace' to include both. Note: When filtering by trace properties (using userId or traceTags parameters), the 'trace' field group must be included, otherwise a 400 error will be returned.
 
+        filter : typing.Optional[str]
+            A JSON stringified array of filter objects. Each object requires type, column, operator, and value. Supports filtering by score metadata using the stringObject type. Example: [{"type":"stringObject","column":"metadata","key":"user_id","operator":"=","value":"abc123"}]. Supported types: stringObject (metadata key-value filtering), string, number, datetime, stringOptions, arrayOptions. Supported operators for stringObject: =, contains, does not contain, starts with, ends with.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -151,6 +155,7 @@ def get(
                 "dataType": data_type,
                 "traceTags": trace_tags,
                 "fields": fields,
+                "filter": filter,
             },
             request_options=request_options,
         )
@@ -361,6 +366,7 @@ async def get(
         data_type: typing.Optional[ScoreDataType] = None,
         trace_tags: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         fields: typing.Optional[str] = None,
+        filter: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[GetScoresResponse]:
         """
@@ -428,6 +434,9 @@ async def get(
         fields : typing.Optional[str]
             Comma-separated list of field groups to include in the response. Available field groups: 'score' (core score fields), 'trace' (trace properties: userId, tags, environment). If not specified, both 'score' and 'trace' are returned by default. Example: 'score' to exclude trace data, 'score,trace' to include both. Note: When filtering by trace properties (using userId or traceTags parameters), the 'trace' field group must be included, otherwise a 400 error will be returned.
 
+        filter : typing.Optional[str]
+            A JSON stringified array of filter objects. Each object requires type, column, operator, and value. Supports filtering by score metadata using the stringObject type. Example: [{"type":"stringObject","column":"metadata","key":"user_id","operator":"=","value":"abc123"}]. Supported types: stringObject (metadata key-value filtering), string, number, datetime, stringOptions, arrayOptions. Supported operators for stringObject: =, contains, does not contain, starts with, ends with.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -463,6 +472,7 @@ async def get(
                 "dataType": data_type,
                 "traceTags": trace_tags,
                 "fields": fields,
+                "filter": filter,
             },
             request_options=request_options,
         )