klaviyo-api-sdk 17.0.0 → 18.0.0

data/lib/klaviyo-api-sdk/api/reporting_api.rb

@@ -19,10 +19,11 @@ module KlaviyoAPI
       @api_client = api_client
     end
     # Query Campaign Values
-    # Returns the requested campaign analytics values data<br><br>*Rate limits*:<br>Burst: `1/s`<br>Steady: `2/m`<br>Daily: `225/d`  **Scopes:** `campaigns:read`
+    # Returns the requested campaign analytics values data<br><br>*Rate limits*:<br>Burst: `1/s`<br>Steady: `2/m`<br>Daily: `225/d`  **Scopes:** `campaigns:read`  [OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/query_campaign_values.json)
     # @param campaign_values_request_dto [CampaignValuesRequestDTO] 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :page_cursor For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination
+    # @option opts [Array<String>] :fields_campaign_values_report For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
+    # @option opts [String] :page_cursor For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#pagination
     # @return [Hash<String, Object>]
     def query_campaign_values(campaign_values_request_dto, opts = {})
       data, _status_code, _headers = query_campaign_values_with_http_info(campaign_values_request_dto, opts)
@@ -36,10 +37,11 @@ module KlaviyoAPI
     alias create_campaign_values_report query_campaign_values
 
     # Query Campaign Values
-    # Returns the requested campaign analytics values data&lt;br&gt;&lt;br&gt;*Rate limits*:&lt;br&gt;Burst: &#x60;1/s&#x60;&lt;br&gt;Steady: &#x60;2/m&#x60;&lt;br&gt;Daily: &#x60;225/d&#x60;  **Scopes:** &#x60;campaigns:read&#x60;
+    # Returns the requested campaign analytics values data&lt;br&gt;&lt;br&gt;*Rate limits*:&lt;br&gt;Burst: &#x60;1/s&#x60;&lt;br&gt;Steady: &#x60;2/m&#x60;&lt;br&gt;Daily: &#x60;225/d&#x60;  **Scopes:** &#x60;campaigns:read&#x60;  [OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/query_campaign_values.json)
     # @param campaign_values_request_dto [CampaignValuesRequestDTO] 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :page_cursor For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination
+    # @option opts [Array<String>] :fields_campaign_values_report For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
+    # @option opts [String] :page_cursor For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#pagination
     # @return [Array<(Hash<String, Object>, Integer, Hash)>] Hash<String, Object> data, response status code and response headers
     def query_campaign_values_with_http_info(campaign_values_request_dto, opts = {})
       if @api_client.config.debugging
@@ -49,17 +51,22 @@ module KlaviyoAPI
       if @api_client.config.client_side_validation && campaign_values_request_dto.nil?
         fail ArgumentError, "Missing the required parameter 'campaign_values_request_dto' when calling ReportingApi.query_campaign_values"
       end
+      allowable_values = ["id", "results"]
+      if @api_client.config.client_side_validation && opts[:'fields_campaign_values_report'] && !opts[:'fields_campaign_values_report'].all? { |item| allowable_values.include?(item) }
+        fail ArgumentError, "invalid value for \"fields_campaign_values_report\", must include one of #{allowable_values}"
+      end
       # resource path
       local_var_path = '/api/campaign-values-reports'
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'fields[campaign-values-report]'] = @api_client.build_collection_param(opts[:'fields_campaign_values_report'], :csv) if !opts[:'fields_campaign_values_report'].nil?
       query_params[:'page_cursor'] = opts[:'page_cursor'] if !opts[:'page_cursor'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
       # klaviyo api revision
-      header_params['revision'] =  ENV['KLAVIYO_API_REVISION'] || ENV['API_REVISION'] || "2026-04-15"
+      header_params['revision'] =  ENV['KLAVIYO_API_REVISION'] || ENV['API_REVISION'] || "2026-07-15"
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/vnd.api+json'])
       # HTTP header 'Content-Type'
@@ -104,10 +111,11 @@ module KlaviyoAPI
     alias create_campaign_values_report_with_http_info query_campaign_values_with_http_info
 
     # Query Flow Series
-    # Returns the requested flow analytics series data<br><br>*Rate limits*:<br>Burst: `1/s`<br>Steady: `2/m`<br>Daily: `225/d`  **Scopes:** `flows:read`
+    # Returns the requested flow analytics series data<br><br>*Rate limits*:<br>Burst: `1/s`<br>Steady: `2/m`<br>Daily: `225/d`  **Scopes:** `flows:read`  [OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/query_flow_series.json)
     # @param flow_series_request_dto [FlowSeriesRequestDTO] 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :page_cursor For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination
+    # @option opts [Array<String>] :fields_flow_series_report For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
+    # @option opts [String] :page_cursor For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#pagination
     # @return [Hash<String, Object>]
     def query_flow_series(flow_series_request_dto, opts = {})
       data, _status_code, _headers = query_flow_series_with_http_info(flow_series_request_dto, opts)
@@ -121,10 +129,11 @@ module KlaviyoAPI
     alias create_flow_series_report query_flow_series
 
     # Query Flow Series
-    # Returns the requested flow analytics series data&lt;br&gt;&lt;br&gt;*Rate limits*:&lt;br&gt;Burst: &#x60;1/s&#x60;&lt;br&gt;Steady: &#x60;2/m&#x60;&lt;br&gt;Daily: &#x60;225/d&#x60;  **Scopes:** &#x60;flows:read&#x60;
+    # Returns the requested flow analytics series data&lt;br&gt;&lt;br&gt;*Rate limits*:&lt;br&gt;Burst: &#x60;1/s&#x60;&lt;br&gt;Steady: &#x60;2/m&#x60;&lt;br&gt;Daily: &#x60;225/d&#x60;  **Scopes:** &#x60;flows:read&#x60;  [OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/query_flow_series.json)
     # @param flow_series_request_dto [FlowSeriesRequestDTO] 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :page_cursor For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination
+    # @option opts [Array<String>] :fields_flow_series_report For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
+    # @option opts [String] :page_cursor For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#pagination
     # @return [Array<(Hash<String, Object>, Integer, Hash)>] Hash<String, Object> data, response status code and response headers
     def query_flow_series_with_http_info(flow_series_request_dto, opts = {})
       if @api_client.config.debugging
@@ -134,17 +143,22 @@ module KlaviyoAPI
       if @api_client.config.client_side_validation && flow_series_request_dto.nil?
         fail ArgumentError, "Missing the required parameter 'flow_series_request_dto' when calling ReportingApi.query_flow_series"
       end
+      allowable_values = ["date_times", "id", "results"]
+      if @api_client.config.client_side_validation && opts[:'fields_flow_series_report'] && !opts[:'fields_flow_series_report'].all? { |item| allowable_values.include?(item) }
+        fail ArgumentError, "invalid value for \"fields_flow_series_report\", must include one of #{allowable_values}"
+      end
       # resource path
       local_var_path = '/api/flow-series-reports'
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'fields[flow-series-report]'] = @api_client.build_collection_param(opts[:'fields_flow_series_report'], :csv) if !opts[:'fields_flow_series_report'].nil?
       query_params[:'page_cursor'] = opts[:'page_cursor'] if !opts[:'page_cursor'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
       # klaviyo api revision
-      header_params['revision'] =  ENV['KLAVIYO_API_REVISION'] || ENV['API_REVISION'] || "2026-04-15"
+      header_params['revision'] =  ENV['KLAVIYO_API_REVISION'] || ENV['API_REVISION'] || "2026-07-15"
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/vnd.api+json'])
       # HTTP header 'Content-Type'
@@ -189,10 +203,11 @@ module KlaviyoAPI
     alias create_flow_series_report_with_http_info query_flow_series_with_http_info
 
     # Query Flow Values
-    # Returns the requested flow analytics values data<br><br>*Rate limits*:<br>Burst: `1/s`<br>Steady: `2/m`<br>Daily: `225/d`  **Scopes:** `flows:read`
+    # Returns the requested flow analytics values data<br><br>*Rate limits*:<br>Burst: `1/s`<br>Steady: `2/m`<br>Daily: `225/d`  **Scopes:** `flows:read`  [OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/query_flow_values.json)
     # @param flow_values_request_dto [FlowValuesRequestDTO] 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :page_cursor For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination
+    # @option opts [Array<String>] :fields_flow_values_report For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
+    # @option opts [String] :page_cursor For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#pagination
     # @return [Hash<String, Object>]
     def query_flow_values(flow_values_request_dto, opts = {})
       data, _status_code, _headers = query_flow_values_with_http_info(flow_values_request_dto, opts)
@@ -206,10 +221,11 @@ module KlaviyoAPI
     alias create_flow_values_report query_flow_values
 
     # Query Flow Values
-    # Returns the requested flow analytics values data&lt;br&gt;&lt;br&gt;*Rate limits*:&lt;br&gt;Burst: &#x60;1/s&#x60;&lt;br&gt;Steady: &#x60;2/m&#x60;&lt;br&gt;Daily: &#x60;225/d&#x60;  **Scopes:** &#x60;flows:read&#x60;
+    # Returns the requested flow analytics values data&lt;br&gt;&lt;br&gt;*Rate limits*:&lt;br&gt;Burst: &#x60;1/s&#x60;&lt;br&gt;Steady: &#x60;2/m&#x60;&lt;br&gt;Daily: &#x60;225/d&#x60;  **Scopes:** &#x60;flows:read&#x60;  [OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/query_flow_values.json)
     # @param flow_values_request_dto [FlowValuesRequestDTO] 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :page_cursor For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination
+    # @option opts [Array<String>] :fields_flow_values_report For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
+    # @option opts [String] :page_cursor For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#pagination
     # @return [Array<(Hash<String, Object>, Integer, Hash)>] Hash<String, Object> data, response status code and response headers
     def query_flow_values_with_http_info(flow_values_request_dto, opts = {})
       if @api_client.config.debugging
@@ -219,17 +235,22 @@ module KlaviyoAPI
       if @api_client.config.client_side_validation && flow_values_request_dto.nil?
         fail ArgumentError, "Missing the required parameter 'flow_values_request_dto' when calling ReportingApi.query_flow_values"
       end
+      allowable_values = ["id", "results"]
+      if @api_client.config.client_side_validation && opts[:'fields_flow_values_report'] && !opts[:'fields_flow_values_report'].all? { |item| allowable_values.include?(item) }
+        fail ArgumentError, "invalid value for \"fields_flow_values_report\", must include one of #{allowable_values}"
+      end
       # resource path
       local_var_path = '/api/flow-values-reports'
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'fields[flow-values-report]'] = @api_client.build_collection_param(opts[:'fields_flow_values_report'], :csv) if !opts[:'fields_flow_values_report'].nil?
       query_params[:'page_cursor'] = opts[:'page_cursor'] if !opts[:'page_cursor'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
       # klaviyo api revision
-      header_params['revision'] =  ENV['KLAVIYO_API_REVISION'] || ENV['API_REVISION'] || "2026-04-15"
+      header_params['revision'] =  ENV['KLAVIYO_API_REVISION'] || ENV['API_REVISION'] || "2026-07-15"
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/vnd.api+json'])
       # HTTP header 'Content-Type'
@@ -274,9 +295,10 @@ module KlaviyoAPI
     alias create_flow_values_report_with_http_info query_flow_values_with_http_info
 
     # Query Form Series
-    # Returns the requested form analytics series data.<br><br>*Rate limits*:<br>Burst: `1/s`<br>Steady: `2/m`<br>Daily: `225/d`  **Scopes:** `forms:read`
+    # Returns the requested form analytics series data.<br><br>*Rate limits*:<br>Burst: `1/s`<br>Steady: `2/m`<br>Daily: `225/d`  **Scopes:** `forms:read`  [OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/query_form_series.json)
     # @param form_series_request_dto [FormSeriesRequestDTO] 
     # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :fields_form_series_report For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
     # @return [Hash<String, Object>]
     def query_form_series(form_series_request_dto, opts = {})
       data, _status_code, _headers = query_form_series_with_http_info(form_series_request_dto, opts)
@@ -290,9 +312,10 @@ module KlaviyoAPI
     alias create_form_series_report query_form_series
 
     # Query Form Series
-    # Returns the requested form analytics series data.&lt;br&gt;&lt;br&gt;*Rate limits*:&lt;br&gt;Burst: &#x60;1/s&#x60;&lt;br&gt;Steady: &#x60;2/m&#x60;&lt;br&gt;Daily: &#x60;225/d&#x60;  **Scopes:** &#x60;forms:read&#x60;
+    # Returns the requested form analytics series data.&lt;br&gt;&lt;br&gt;*Rate limits*:&lt;br&gt;Burst: &#x60;1/s&#x60;&lt;br&gt;Steady: &#x60;2/m&#x60;&lt;br&gt;Daily: &#x60;225/d&#x60;  **Scopes:** &#x60;forms:read&#x60;  [OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/query_form_series.json)
     # @param form_series_request_dto [FormSeriesRequestDTO] 
     # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :fields_form_series_report For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
     # @return [Array<(Hash<String, Object>, Integer, Hash)>] Hash<String, Object> data, response status code and response headers
     def query_form_series_with_http_info(form_series_request_dto, opts = {})
       if @api_client.config.debugging
@@ -302,16 +325,21 @@ module KlaviyoAPI
       if @api_client.config.client_side_validation && form_series_request_dto.nil?
         fail ArgumentError, "Missing the required parameter 'form_series_request_dto' when calling ReportingApi.query_form_series"
       end
+      allowable_values = ["date_times", "id", "results"]
+      if @api_client.config.client_side_validation && opts[:'fields_form_series_report'] && !opts[:'fields_form_series_report'].all? { |item| allowable_values.include?(item) }
+        fail ArgumentError, "invalid value for \"fields_form_series_report\", must include one of #{allowable_values}"
+      end
       # resource path
       local_var_path = '/api/form-series-reports'
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'fields[form-series-report]'] = @api_client.build_collection_param(opts[:'fields_form_series_report'], :csv) if !opts[:'fields_form_series_report'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
       # klaviyo api revision
-      header_params['revision'] =  ENV['KLAVIYO_API_REVISION'] || ENV['API_REVISION'] || "2026-04-15"
+      header_params['revision'] =  ENV['KLAVIYO_API_REVISION'] || ENV['API_REVISION'] || "2026-07-15"
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/vnd.api+json'])
       # HTTP header 'Content-Type'
@@ -356,9 +384,10 @@ module KlaviyoAPI
     alias create_form_series_report_with_http_info query_form_series_with_http_info
 
     # Query Form Values
-    # Returns the requested form analytics values data.<br><br>*Rate limits*:<br>Burst: `1/s`<br>Steady: `2/m`<br>Daily: `225/d`  **Scopes:** `forms:read`
+    # Returns the requested form analytics values data.<br><br>*Rate limits*:<br>Burst: `1/s`<br>Steady: `2/m`<br>Daily: `225/d`  **Scopes:** `forms:read`  [OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/query_form_values.json)
     # @param form_values_request_dto [FormValuesRequestDTO] 
     # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :fields_form_values_report For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
     # @return [Hash<String, Object>]
     def query_form_values(form_values_request_dto, opts = {})
       data, _status_code, _headers = query_form_values_with_http_info(form_values_request_dto, opts)
@@ -372,9 +401,10 @@ module KlaviyoAPI
     alias create_form_values_report query_form_values
 
     # Query Form Values
-    # Returns the requested form analytics values data.&lt;br&gt;&lt;br&gt;*Rate limits*:&lt;br&gt;Burst: &#x60;1/s&#x60;&lt;br&gt;Steady: &#x60;2/m&#x60;&lt;br&gt;Daily: &#x60;225/d&#x60;  **Scopes:** &#x60;forms:read&#x60;
+    # Returns the requested form analytics values data.&lt;br&gt;&lt;br&gt;*Rate limits*:&lt;br&gt;Burst: &#x60;1/s&#x60;&lt;br&gt;Steady: &#x60;2/m&#x60;&lt;br&gt;Daily: &#x60;225/d&#x60;  **Scopes:** &#x60;forms:read&#x60;  [OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/query_form_values.json)
     # @param form_values_request_dto [FormValuesRequestDTO] 
     # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :fields_form_values_report For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
     # @return [Array<(Hash<String, Object>, Integer, Hash)>] Hash<String, Object> data, response status code and response headers
     def query_form_values_with_http_info(form_values_request_dto, opts = {})
       if @api_client.config.debugging
@@ -384,16 +414,21 @@ module KlaviyoAPI
       if @api_client.config.client_side_validation && form_values_request_dto.nil?
         fail ArgumentError, "Missing the required parameter 'form_values_request_dto' when calling ReportingApi.query_form_values"
       end
+      allowable_values = ["id", "results"]
+      if @api_client.config.client_side_validation && opts[:'fields_form_values_report'] && !opts[:'fields_form_values_report'].all? { |item| allowable_values.include?(item) }
+        fail ArgumentError, "invalid value for \"fields_form_values_report\", must include one of #{allowable_values}"
+      end
       # resource path
       local_var_path = '/api/form-values-reports'
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'fields[form-values-report]'] = @api_client.build_collection_param(opts[:'fields_form_values_report'], :csv) if !opts[:'fields_form_values_report'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
       # klaviyo api revision
-      header_params['revision'] =  ENV['KLAVIYO_API_REVISION'] || ENV['API_REVISION'] || "2026-04-15"
+      header_params['revision'] =  ENV['KLAVIYO_API_REVISION'] || ENV['API_REVISION'] || "2026-07-15"
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/vnd.api+json'])
       # HTTP header 'Content-Type'
@@ -438,9 +473,10 @@ module KlaviyoAPI
     alias create_form_values_report_with_http_info query_form_values_with_http_info
 
     # Query Segment Series
-    # Returns the requested segment analytics series data.<br><br>*Rate limits*:<br>Burst: `1/s`<br>Steady: `2/m`<br>Daily: `225/d`  **Scopes:** `segments:read`
+    # Returns the requested segment analytics series data.<br><br>*Rate limits*:<br>Burst: `1/s`<br>Steady: `2/m`<br>Daily: `225/d`  **Scopes:** `segments:read`  [OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/query_segment_series.json)
     # @param segment_series_request_dto [SegmentSeriesRequestDTO] 
     # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :fields_segment_series_report For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
     # @return [Hash<String, Object>]
     def query_segment_series(segment_series_request_dto, opts = {})
       data, _status_code, _headers = query_segment_series_with_http_info(segment_series_request_dto, opts)
@@ -454,9 +490,10 @@ module KlaviyoAPI
     alias create_segment_series_report query_segment_series
 
     # Query Segment Series
-    # Returns the requested segment analytics series data.&lt;br&gt;&lt;br&gt;*Rate limits*:&lt;br&gt;Burst: &#x60;1/s&#x60;&lt;br&gt;Steady: &#x60;2/m&#x60;&lt;br&gt;Daily: &#x60;225/d&#x60;  **Scopes:** &#x60;segments:read&#x60;
+    # Returns the requested segment analytics series data.&lt;br&gt;&lt;br&gt;*Rate limits*:&lt;br&gt;Burst: &#x60;1/s&#x60;&lt;br&gt;Steady: &#x60;2/m&#x60;&lt;br&gt;Daily: &#x60;225/d&#x60;  **Scopes:** &#x60;segments:read&#x60;  [OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/query_segment_series.json)
     # @param segment_series_request_dto [SegmentSeriesRequestDTO] 
     # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :fields_segment_series_report For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
     # @return [Array<(Hash<String, Object>, Integer, Hash)>] Hash<String, Object> data, response status code and response headers
     def query_segment_series_with_http_info(segment_series_request_dto, opts = {})
       if @api_client.config.debugging
@@ -466,16 +503,21 @@ module KlaviyoAPI
       if @api_client.config.client_side_validation && segment_series_request_dto.nil?
         fail ArgumentError, "Missing the required parameter 'segment_series_request_dto' when calling ReportingApi.query_segment_series"
       end
+      allowable_values = ["date_times", "id", "results"]
+      if @api_client.config.client_side_validation && opts[:'fields_segment_series_report'] && !opts[:'fields_segment_series_report'].all? { |item| allowable_values.include?(item) }
+        fail ArgumentError, "invalid value for \"fields_segment_series_report\", must include one of #{allowable_values}"
+      end
       # resource path
       local_var_path = '/api/segment-series-reports'
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'fields[segment-series-report]'] = @api_client.build_collection_param(opts[:'fields_segment_series_report'], :csv) if !opts[:'fields_segment_series_report'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
       # klaviyo api revision
-      header_params['revision'] =  ENV['KLAVIYO_API_REVISION'] || ENV['API_REVISION'] || "2026-04-15"
+      header_params['revision'] =  ENV['KLAVIYO_API_REVISION'] || ENV['API_REVISION'] || "2026-07-15"
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/vnd.api+json'])
       # HTTP header 'Content-Type'
@@ -520,9 +562,10 @@ module KlaviyoAPI
     alias create_segment_series_report_with_http_info query_segment_series_with_http_info
 
     # Query Segment Values
-    # Returns the requested segment analytics values data.<br><br>*Rate limits*:<br>Burst: `1/s`<br>Steady: `2/m`<br>Daily: `225/d`  **Scopes:** `segments:read`
+    # Returns the requested segment analytics values data.<br><br>*Rate limits*:<br>Burst: `1/s`<br>Steady: `2/m`<br>Daily: `225/d`  **Scopes:** `segments:read`  [OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/query_segment_values.json)
     # @param segment_values_request_dto [SegmentValuesRequestDTO] 
     # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :fields_segment_values_report For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
     # @return [Hash<String, Object>]
     def query_segment_values(segment_values_request_dto, opts = {})
       data, _status_code, _headers = query_segment_values_with_http_info(segment_values_request_dto, opts)
@@ -536,9 +579,10 @@ module KlaviyoAPI
     alias create_segment_values_report query_segment_values
 
     # Query Segment Values
-    # Returns the requested segment analytics values data.&lt;br&gt;&lt;br&gt;*Rate limits*:&lt;br&gt;Burst: &#x60;1/s&#x60;&lt;br&gt;Steady: &#x60;2/m&#x60;&lt;br&gt;Daily: &#x60;225/d&#x60;  **Scopes:** &#x60;segments:read&#x60;
+    # Returns the requested segment analytics values data.&lt;br&gt;&lt;br&gt;*Rate limits*:&lt;br&gt;Burst: &#x60;1/s&#x60;&lt;br&gt;Steady: &#x60;2/m&#x60;&lt;br&gt;Daily: &#x60;225/d&#x60;  **Scopes:** &#x60;segments:read&#x60;  [OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/query_segment_values.json)
     # @param segment_values_request_dto [SegmentValuesRequestDTO] 
     # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :fields_segment_values_report For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
     # @return [Array<(Hash<String, Object>, Integer, Hash)>] Hash<String, Object> data, response status code and response headers
     def query_segment_values_with_http_info(segment_values_request_dto, opts = {})
       if @api_client.config.debugging
@@ -548,16 +592,21 @@ module KlaviyoAPI
       if @api_client.config.client_side_validation && segment_values_request_dto.nil?
         fail ArgumentError, "Missing the required parameter 'segment_values_request_dto' when calling ReportingApi.query_segment_values"
       end
+      allowable_values = ["id", "results"]
+      if @api_client.config.client_side_validation && opts[:'fields_segment_values_report'] && !opts[:'fields_segment_values_report'].all? { |item| allowable_values.include?(item) }
+        fail ArgumentError, "invalid value for \"fields_segment_values_report\", must include one of #{allowable_values}"
+      end
       # resource path
       local_var_path = '/api/segment-values-reports'
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'fields[segment-values-report]'] = @api_client.build_collection_param(opts[:'fields_segment_values_report'], :csv) if !opts[:'fields_segment_values_report'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
       # klaviyo api revision
-      header_params['revision'] =  ENV['KLAVIYO_API_REVISION'] || ENV['API_REVISION'] || "2026-04-15"
+      header_params['revision'] =  ENV['KLAVIYO_API_REVISION'] || ENV['API_REVISION'] || "2026-07-15"
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/vnd.api+json'])
       # HTTP header 'Content-Type'

data/lib/klaviyo-api-sdk/api/reviews_api.rb

@@ -19,12 +19,12 @@ module KlaviyoAPI
       @api_client = api_client
     end
     # Get Review
-    # Get the review with the given ID.<br><br>*Rate limits*:<br>Burst: `10/s`<br>Steady: `150/m`  **Scopes:** `reviews:read`
+    # Get the review with the given ID.<br><br>*Rate limits*:<br>Burst: `10/s`<br>Steady: `150/m`  **Scopes:** `reviews:read`  [OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/get_review.json)
     # @param id [String] The ID of the review
     # @param [Hash] opts the optional parameters
-    # @option opts [Array<String>] :fields_event For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
-    # @option opts [Array<String>] :fields_review For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
-    # @option opts [Array<String>] :include For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships
+    # @option opts [Array<String>] :fields_event For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
+    # @option opts [Array<String>] :fields_review For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
+    # @option opts [Array<String>] :include For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#relationships
     # @return [Hash<String, Object>]
     def get_review(id, opts = {})
       data, _status_code, _headers = get_review_with_http_info(id, opts)
@@ -32,12 +32,12 @@ module KlaviyoAPI
     end
 
     # Get Review
-    # Get the review with the given ID.&lt;br&gt;&lt;br&gt;*Rate limits*:&lt;br&gt;Burst: &#x60;10/s&#x60;&lt;br&gt;Steady: &#x60;150/m&#x60;  **Scopes:** &#x60;reviews:read&#x60;
+    # Get the review with the given ID.&lt;br&gt;&lt;br&gt;*Rate limits*:&lt;br&gt;Burst: &#x60;10/s&#x60;&lt;br&gt;Steady: &#x60;150/m&#x60;  **Scopes:** &#x60;reviews:read&#x60;  [OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/get_review.json)
     # @param id [String] The ID of the review
     # @param [Hash] opts the optional parameters
-    # @option opts [Array<String>] :fields_event For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
-    # @option opts [Array<String>] :fields_review For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
-    # @option opts [Array<String>] :include For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships
+    # @option opts [Array<String>] :fields_event For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
+    # @option opts [Array<String>] :fields_review For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
+    # @option opts [Array<String>] :include For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#relationships
     # @return [Array<(Hash<String, Object>, Integer, Hash)>] Hash<String, Object> data, response status code and response headers
     def get_review_with_http_info(id, opts = {})
       if @api_client.config.debugging
@@ -47,11 +47,11 @@ module KlaviyoAPI
       if @api_client.config.client_side_validation && id.nil?
         fail ArgumentError, "Missing the required parameter 'id' when calling ReviewsApi.get_review"
       end
-      allowable_values = ["datetime", "event_properties", "timestamp", "uuid"]
+      allowable_values = ["datetime", "event_properties", "id", "timestamp", "uuid"]
       if @api_client.config.client_side_validation && opts[:'fields_event'] && !opts[:'fields_event'].all? { |item| allowable_values.include?(item) }
         fail ArgumentError, "invalid value for \"fields_event\", must include one of #{allowable_values}"
       end
-      allowable_values = ["author", "content", "created", "email", "images", "product", "product.external_id", "product.image_url", "product.name", "product.url", "public_reply", "public_reply.author", "public_reply.content", "public_reply.updated", "rating", "review_type", "smart_quote", "status", "status.rejection_reason", "status.rejection_reason.reason", "status.rejection_reason.status_explanation", "status.value", "title", "updated", "verified"]
+      allowable_values = ["author", "content", "created", "email", "id", "images", "product", "product.external_id", "product.image_url", "product.name", "product.url", "public_reply", "public_reply.author", "public_reply.content", "public_reply.updated", "rating", "review_type", "smart_quote", "status", "status.rejection_reason", "status.rejection_reason.reason", "status.rejection_reason.status_explanation", "status.value", "title", "updated", "verified"]
       if @api_client.config.client_side_validation && opts[:'fields_review'] && !opts[:'fields_review'].all? { |item| allowable_values.include?(item) }
         fail ArgumentError, "invalid value for \"fields_review\", must include one of #{allowable_values}"
       end
@@ -71,7 +71,7 @@ module KlaviyoAPI
       # header parameters
       header_params = opts[:header_params] || {}
       # klaviyo api revision
-      header_params['revision'] =  ENV['KLAVIYO_API_REVISION'] || ENV['API_REVISION'] || "2026-04-15"
+      header_params['revision'] =  ENV['KLAVIYO_API_REVISION'] || ENV['API_REVISION'] || "2026-07-15"
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/vnd.api+json'])
 
@@ -105,15 +105,15 @@ module KlaviyoAPI
     end
 
     # Get Reviews
-    # Get all reviews.<br><br>*Rate limits*:<br>Burst: `10/s`<br>Steady: `150/m`  **Scopes:** `reviews:read`
+    # Get all reviews.<br><br>*Rate limits*:<br>Burst: `10/s`<br>Steady: `150/m`  **Scopes:** `reviews:read`  [OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/get_reviews.json)
     # @param [Hash] opts the optional parameters
-    # @option opts [Array<String>] :fields_event For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
-    # @option opts [Array<String>] :fields_review For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
-    # @option opts [String] :filter For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering&lt;br&gt;Allowed field(s)/operator(s):&lt;br&gt;&#x60;created&#x60;: &#x60;greater-or-equal&#x60;, &#x60;less-or-equal&#x60;&lt;br&gt;&#x60;rating&#x60;: &#x60;any&#x60;, &#x60;equals&#x60;, &#x60;greater-or-equal&#x60;, &#x60;less-or-equal&#x60;&lt;br&gt;&#x60;id&#x60;: &#x60;any&#x60;, &#x60;equals&#x60;&lt;br&gt;&#x60;item.id&#x60;: &#x60;any&#x60;, &#x60;equals&#x60;&lt;br&gt;&#x60;content&#x60;: &#x60;contains&#x60;&lt;br&gt;&#x60;status&#x60;: &#x60;equals&#x60;&lt;br&gt;&#x60;review_type&#x60;: &#x60;equals&#x60;&lt;br&gt;&#x60;verified&#x60;: &#x60;equals&#x60;
-    # @option opts [Array<String>] :include For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships
-    # @option opts [String] :page_cursor For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination
+    # @option opts [Array<String>] :fields_event For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
+    # @option opts [Array<String>] :fields_review For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
+    # @option opts [String] :filter For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#filtering&lt;br&gt;Allowed field(s)/operator(s):&lt;br&gt;&#x60;created&#x60;: &#x60;greater-or-equal&#x60;, &#x60;less-or-equal&#x60;&lt;br&gt;&#x60;rating&#x60;: &#x60;any&#x60;, &#x60;equals&#x60;, &#x60;greater-or-equal&#x60;, &#x60;less-or-equal&#x60;&lt;br&gt;&#x60;id&#x60;: &#x60;any&#x60;, &#x60;equals&#x60;&lt;br&gt;&#x60;item.id&#x60;: &#x60;any&#x60;, &#x60;equals&#x60;&lt;br&gt;&#x60;content&#x60;: &#x60;contains&#x60;&lt;br&gt;&#x60;status&#x60;: &#x60;equals&#x60;&lt;br&gt;&#x60;review_type&#x60;: &#x60;equals&#x60;&lt;br&gt;&#x60;verified&#x60;: &#x60;equals&#x60;
+    # @option opts [Array<String>] :include For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#relationships
+    # @option opts [String] :page_cursor For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#pagination
     # @option opts [Integer] :page_size Default: 20. Min: 1. Max: 100. (default to 20)
-    # @option opts [String] :sort For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting
+    # @option opts [String] :sort For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sorting
     # @return [Hash<String, Object>]
     def get_reviews(opts = {})
       data, _status_code, _headers = get_reviews_with_http_info(opts)
@@ -121,25 +121,25 @@ module KlaviyoAPI
     end
 
     # Get Reviews
-    # Get all reviews.&lt;br&gt;&lt;br&gt;*Rate limits*:&lt;br&gt;Burst: &#x60;10/s&#x60;&lt;br&gt;Steady: &#x60;150/m&#x60;  **Scopes:** &#x60;reviews:read&#x60;
+    # Get all reviews.&lt;br&gt;&lt;br&gt;*Rate limits*:&lt;br&gt;Burst: &#x60;10/s&#x60;&lt;br&gt;Steady: &#x60;150/m&#x60;  **Scopes:** &#x60;reviews:read&#x60;  [OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/get_reviews.json)
     # @param [Hash] opts the optional parameters
-    # @option opts [Array<String>] :fields_event For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
-    # @option opts [Array<String>] :fields_review For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
-    # @option opts [String] :filter For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering&lt;br&gt;Allowed field(s)/operator(s):&lt;br&gt;&#x60;created&#x60;: &#x60;greater-or-equal&#x60;, &#x60;less-or-equal&#x60;&lt;br&gt;&#x60;rating&#x60;: &#x60;any&#x60;, &#x60;equals&#x60;, &#x60;greater-or-equal&#x60;, &#x60;less-or-equal&#x60;&lt;br&gt;&#x60;id&#x60;: &#x60;any&#x60;, &#x60;equals&#x60;&lt;br&gt;&#x60;item.id&#x60;: &#x60;any&#x60;, &#x60;equals&#x60;&lt;br&gt;&#x60;content&#x60;: &#x60;contains&#x60;&lt;br&gt;&#x60;status&#x60;: &#x60;equals&#x60;&lt;br&gt;&#x60;review_type&#x60;: &#x60;equals&#x60;&lt;br&gt;&#x60;verified&#x60;: &#x60;equals&#x60;
-    # @option opts [Array<String>] :include For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships
-    # @option opts [String] :page_cursor For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination
+    # @option opts [Array<String>] :fields_event For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
+    # @option opts [Array<String>] :fields_review For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
+    # @option opts [String] :filter For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#filtering&lt;br&gt;Allowed field(s)/operator(s):&lt;br&gt;&#x60;created&#x60;: &#x60;greater-or-equal&#x60;, &#x60;less-or-equal&#x60;&lt;br&gt;&#x60;rating&#x60;: &#x60;any&#x60;, &#x60;equals&#x60;, &#x60;greater-or-equal&#x60;, &#x60;less-or-equal&#x60;&lt;br&gt;&#x60;id&#x60;: &#x60;any&#x60;, &#x60;equals&#x60;&lt;br&gt;&#x60;item.id&#x60;: &#x60;any&#x60;, &#x60;equals&#x60;&lt;br&gt;&#x60;content&#x60;: &#x60;contains&#x60;&lt;br&gt;&#x60;status&#x60;: &#x60;equals&#x60;&lt;br&gt;&#x60;review_type&#x60;: &#x60;equals&#x60;&lt;br&gt;&#x60;verified&#x60;: &#x60;equals&#x60;
+    # @option opts [Array<String>] :include For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#relationships
+    # @option opts [String] :page_cursor For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#pagination
     # @option opts [Integer] :page_size Default: 20. Min: 1. Max: 100. (default to 20)
-    # @option opts [String] :sort For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting
+    # @option opts [String] :sort For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sorting
     # @return [Array<(Hash<String, Object>, Integer, Hash)>] Hash<String, Object> data, response status code and response headers
     def get_reviews_with_http_info(opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: ReviewsApi.get_reviews ...'
       end
-      allowable_values = ["datetime", "event_properties", "timestamp", "uuid"]
+      allowable_values = ["datetime", "event_properties", "id", "timestamp", "uuid"]
       if @api_client.config.client_side_validation && opts[:'fields_event'] && !opts[:'fields_event'].all? { |item| allowable_values.include?(item) }
         fail ArgumentError, "invalid value for \"fields_event\", must include one of #{allowable_values}"
       end
-      allowable_values = ["author", "content", "created", "email", "images", "product", "product.external_id", "product.image_url", "product.name", "product.url", "public_reply", "public_reply.author", "public_reply.content", "public_reply.updated", "rating", "review_type", "smart_quote", "status", "status.rejection_reason", "status.rejection_reason.reason", "status.rejection_reason.status_explanation", "status.value", "title", "updated", "verified"]
+      allowable_values = ["author", "content", "created", "email", "id", "images", "product", "product.external_id", "product.image_url", "product.name", "product.url", "public_reply", "public_reply.author", "public_reply.content", "public_reply.updated", "rating", "review_type", "smart_quote", "status", "status.rejection_reason", "status.rejection_reason.reason", "status.rejection_reason.status_explanation", "status.value", "title", "updated", "verified"]
       if @api_client.config.client_side_validation && opts[:'fields_review'] && !opts[:'fields_review'].all? { |item| allowable_values.include?(item) }
         fail ArgumentError, "invalid value for \"fields_review\", must include one of #{allowable_values}"
       end
@@ -175,7 +175,7 @@ module KlaviyoAPI
       # header parameters
       header_params = opts[:header_params] || {}
       # klaviyo api revision
-      header_params['revision'] =  ENV['KLAVIYO_API_REVISION'] || ENV['API_REVISION'] || "2026-04-15"
+      header_params['revision'] =  ENV['KLAVIYO_API_REVISION'] || ENV['API_REVISION'] || "2026-07-15"
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/vnd.api+json'])
 
@@ -209,10 +209,11 @@ module KlaviyoAPI
     end
 
     # Update Review
-    # Update a review.<br><br>*Rate limits*:<br>Burst: `10/s`<br>Steady: `150/m`  **Scopes:** `reviews:write`
+    # Update a review.<br><br>*Rate limits*:<br>Burst: `10/s`<br>Steady: `150/m`  **Scopes:** `reviews:write`  [OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/update_review.json)
     # @param id [String] The id of the review (review ID).
     # @param review_patch_query [ReviewPatchQuery] DTO for updating reviews
     # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :fields_review For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
     # @return [Hash<String, Object>]
     def update_review(id, review_patch_query, opts = {})
       data, _status_code, _headers = update_review_with_http_info(id, review_patch_query, opts)
@@ -220,10 +221,11 @@ module KlaviyoAPI
     end
 
     # Update Review
-    # Update a review.&lt;br&gt;&lt;br&gt;*Rate limits*:&lt;br&gt;Burst: &#x60;10/s&#x60;&lt;br&gt;Steady: &#x60;150/m&#x60;  **Scopes:** &#x60;reviews:write&#x60;
+    # Update a review.&lt;br&gt;&lt;br&gt;*Rate limits*:&lt;br&gt;Burst: &#x60;10/s&#x60;&lt;br&gt;Steady: &#x60;150/m&#x60;  **Scopes:** &#x60;reviews:write&#x60;  [OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/update_review.json)
     # @param id [String] The id of the review (review ID).
     # @param review_patch_query [ReviewPatchQuery] DTO for updating reviews
     # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :fields_review For more information please visit https://developers.klaviyo.com/en/v2026-07-15/reference/api-overview#sparse-fieldsets
     # @return [Array<(Hash<String, Object>, Integer, Hash)>] Hash<String, Object> data, response status code and response headers
     def update_review_with_http_info(id, review_patch_query, opts = {})
       if @api_client.config.debugging
@@ -237,16 +239,21 @@ module KlaviyoAPI
       if @api_client.config.client_side_validation && review_patch_query.nil?
         fail ArgumentError, "Missing the required parameter 'review_patch_query' when calling ReviewsApi.update_review"
       end
+      allowable_values = ["author", "content", "created", "email", "id", "images", "product", "product.external_id", "product.image_url", "product.name", "product.url", "public_reply", "public_reply.author", "public_reply.content", "public_reply.updated", "rating", "review_type", "smart_quote", "status", "status.rejection_reason", "status.rejection_reason.reason", "status.rejection_reason.status_explanation", "status.value", "title", "updated", "verified"]
+      if @api_client.config.client_side_validation && opts[:'fields_review'] && !opts[:'fields_review'].all? { |item| allowable_values.include?(item) }
+        fail ArgumentError, "invalid value for \"fields_review\", must include one of #{allowable_values}"
+      end
       # resource path
       local_var_path = '/api/reviews/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'fields[review]'] = @api_client.build_collection_param(opts[:'fields_review'], :csv) if !opts[:'fields_review'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
       # klaviyo api revision
-      header_params['revision'] =  ENV['KLAVIYO_API_REVISION'] || ENV['API_REVISION'] || "2026-04-15"
+      header_params['revision'] =  ENV['KLAVIYO_API_REVISION'] || ENV['API_REVISION'] || "2026-07-15"
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/vnd.api+json'])
       # HTTP header 'Content-Type'