seatschart 0.1.1 → 0.3.0

data/lib/seatschart/api/events_api.rb

@@ -479,6 +479,139 @@ module SeatsChart
       return data, status_code, headers
     end
 
+    # Objects of my inventory channels (renderer channel-only selection)
+    # Every seat id and GA area id in the channels of the keys sent in `x-channel-key` (comma-separated for several). The renderer reads it once when `objectWithoutChannelSelectable: false` (seats.io `channels` without `NO_CHANNEL`) to keep public objects unselectable. Only channels whose key you send are answered, so buyer tokens can ask too; without a valid key both lists are empty. Two indexed reads; not cached (`private, no-store`).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_api_events_by_event_id_channel_objects(event_id, opts = {})
+      get_api_events_by_event_id_channel_objects_with_http_info(event_id, opts)
+      nil
+    end
+
+    # Objects of my inventory channels (renderer channel-only selection)
+    # Every seat id and GA area id in the channels of the keys sent in `x-channel-key` (comma-separated for several). The renderer reads it once when `objectWithoutChannelSelectable: false` (seats.io `channels` without `NO_CHANNEL`) to keep public objects unselectable. Only channels whose key you send are answered, so buyer tokens can ask too; without a valid key both lists are empty. Two indexed reads; not cached (`private, no-store`).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_events_by_event_id_channel_objects_with_http_info(event_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EventsApi.get_api_events_by_event_id_channel_objects ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.get_api_events_by_event_id_channel_objects"
+      end
+      # resource path
+      local_var_path = '/api/events/{eventId}/channel-objects'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"EventsApi.get_api_events_by_event_id_channel_objects",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_channel_objects\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Published geometry (content-addressed)
+    # Immutable map geometry addressed by the SHA-256 hash from the manifest. Brotli or gzip when `Accept-Encoding` allows (`Content-Encoding` set), else identity JSON. Strong ETag per hash and coding; `If-None-Match` returns 304. `Cache-Control: private, max-age=31536000, immutable`; 404 `not_found` (never cached) when the hash is not a published geometry of this event. Authenticated on every request.
+    # @param event_id [String] 
+    # @param hash [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_api_events_by_event_id_geometry_by_hash(event_id, hash, opts = {})
+      get_api_events_by_event_id_geometry_by_hash_with_http_info(event_id, hash, opts)
+      nil
+    end
+
+    # Published geometry (content-addressed)
+    # Immutable map geometry addressed by the SHA-256 hash from the manifest. Brotli or gzip when &#x60;Accept-Encoding&#x60; allows (&#x60;Content-Encoding&#x60; set), else identity JSON. Strong ETag per hash and coding; &#x60;If-None-Match&#x60; returns 304. &#x60;Cache-Control: private, max-age&#x3D;31536000, immutable&#x60;; 404 &#x60;not_found&#x60; (never cached) when the hash is not a published geometry of this event. Authenticated on every request.
+    # @param event_id [String] 
+    # @param hash [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_events_by_event_id_geometry_by_hash_with_http_info(event_id, hash, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EventsApi.get_api_events_by_event_id_geometry_by_hash ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.get_api_events_by_event_id_geometry_by_hash"
+      end
+      # verify the required parameter 'hash' is set
+      if @api_client.config.client_side_validation && hash.nil?
+        fail ArgumentError, "Missing the required parameter 'hash' when calling EventsApi.get_api_events_by_event_id_geometry_by_hash"
+      end
+      pattern = Regexp.new(/^[a-f0-9]{64}$/)
+      if @api_client.config.client_side_validation && hash !~ pattern
+        fail ArgumentError, "invalid value for 'hash' when calling EventsApi.get_api_events_by_event_id_geometry_by_hash, must conform to the pattern #{pattern}."
+      end
+
+      # resource path
+      local_var_path = '/api/events/{eventId}/geometry/{hash}'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s)).sub('{' + 'hash' + '}', CGI.escape(hash.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"EventsApi.get_api_events_by_event_id_geometry_by_hash",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_geometry_by_hash\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # List inventory channels (ops)
     # Returns id, name, color, and keyPrefix — never the full channelKey secret. Not the same as GET /channels (salesChannel order limits).
     # @param event_id [String] 
@@ -548,6 +681,67 @@ module SeatsChart
       return data, status_code, headers
     end
 
+    # Published geometry manifest
+    # Manifest of the published map (`mapRevision`, `geometryHash` and `geometryUrl` of the geometry served by `GET /api/events/{eventId}/geometry/{hash}`, `seatCount`, `gaCount`) plus the event `currency`, the static `sales` description when the event has sales rules or an external price source, and `testWorkspace: true` in test workspaces. ETag covers the revision, the currency and the sales rules; `If-None-Match` returns 304. 404 `not_found` for an unknown event, 409 `geometry_not_published` before the first publish. `Cache-Control: private, no-cache`.
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_api_events_by_event_id_manifest(event_id, opts = {})
+      get_api_events_by_event_id_manifest_with_http_info(event_id, opts)
+      nil
+    end
+
+    # Published geometry manifest
+    # Manifest of the published map (&#x60;mapRevision&#x60;, &#x60;geometryHash&#x60; and &#x60;geometryUrl&#x60; of the geometry served by &#x60;GET /api/events/{eventId}/geometry/{hash}&#x60;, &#x60;seatCount&#x60;, &#x60;gaCount&#x60;) plus the event &#x60;currency&#x60;, the static &#x60;sales&#x60; description when the event has sales rules or an external price source, and &#x60;testWorkspace: true&#x60; in test workspaces. ETag covers the revision, the currency and the sales rules; &#x60;If-None-Match&#x60; returns 304. 404 &#x60;not_found&#x60; for an unknown event, 409 &#x60;geometry_not_published&#x60; before the first publish. &#x60;Cache-Control: private, no-cache&#x60;.
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_events_by_event_id_manifest_with_http_info(event_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EventsApi.get_api_events_by_event_id_manifest ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.get_api_events_by_event_id_manifest"
+      end
+      # resource path
+      local_var_path = '/api/events/{eventId}/manifest'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"EventsApi.get_api_events_by_event_id_manifest",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_manifest\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Load map draft for designer
     # Returns unpublished draft when present; otherwise bootstraps from the published map. Does not affect the B2C viewer.
     # @param event_id [String] 
@@ -866,7 +1060,7 @@ module SeatsChart
     end
 
     # Retrieve one object (seat or GA area)
-    # Looks the object up by id, then by exact label (409 when the label is not unique). Returns label, category, price (cents), durable `dbStatus`, `visualStatus` (Postgres status merged with live Redis hold presence), `ticketBuyerId` of the current state, `forSale`, the object status overlay (`objectStatus`, `orderId`, `extraData`) and `section` when the seat lies inside a named section guide, and `zone` / `zoneId` (layout zone: explicit assignment, then the section zone, then the zone outline; null outside every zone), and `entrance` (the most specific of seat, row, table and section; GA areas use their own). Seats add `rowLabel`, `displayedLabel`, `accessibility` (stored form: the four original flags as booleans, newer flags in the `amenities` bitmask, `seatType`), `amenityFlags` (every set flag by name) and `seatType` (default chair). GA areas add capacity, soldCount, heldCount and availableCount. `channelKeyId` is returned to partner API keys and workspace admins only. Requires content_write.
+    # Looks the object up by id, then by exact label (409 when the label is not unique). Returns label, category, price (cents), durable `dbStatus`, `visualStatus` (Postgres status merged with live Redis hold presence), `ticketBuyerId` of the current state, `forSale`, the object status overlay (`objectStatus`, `orderId`, `extraData`) and `section` when the seat lies inside a named section guide, and `zone` / `zoneId` (layout zone: explicit assignment, then the section zone, then the zone outline; null outside every zone), and `entrance` (the most specific of seat, row, table and section; GA areas use their own). Seats add `rowLabel`, `displayedLabel`, `accessibility` (stored form: the four original flags as booleans, newer flags in the `amenities` bitmask, `seatType`), `amenityFlags` (every set flag by name) and `seatType` (default chair). GA areas add capacity, soldCount, heldCount and availableCount; areas sold as a whole add the seats.io `areaType` (`fixedOccupancy` / `variableOccupancy`), `bookAsAWhole: true` and, for variable occupancy, `minOccupancy` / `maxOccupancy` (their `availableCount` is the capacity or 0: never part of the area). `channelKeyId` is returned to partner API keys and workspace admins only. Requires content_write.
     # @param event_id [String] 
     # @param object_id [String] Seat or GA area id (UUID), or its exact label / GA name.
     # @param [Hash] opts the optional parameters
@@ -877,7 +1071,7 @@ module SeatsChart
     end
 
     # Retrieve one object (seat or GA area)
-    # Looks the object up by id, then by exact label (409 when the label is not unique). Returns label, category, price (cents), durable &#x60;dbStatus&#x60;, &#x60;visualStatus&#x60; (Postgres status merged with live Redis hold presence), &#x60;ticketBuyerId&#x60; of the current state, &#x60;forSale&#x60;, the object status overlay (&#x60;objectStatus&#x60;, &#x60;orderId&#x60;, &#x60;extraData&#x60;) and &#x60;section&#x60; when the seat lies inside a named section guide, and &#x60;zone&#x60; / &#x60;zoneId&#x60; (layout zone: explicit assignment, then the section zone, then the zone outline; null outside every zone), and &#x60;entrance&#x60; (the most specific of seat, row, table and section; GA areas use their own). Seats add &#x60;rowLabel&#x60;, &#x60;displayedLabel&#x60;, &#x60;accessibility&#x60; (stored form: the four original flags as booleans, newer flags in the &#x60;amenities&#x60; bitmask, &#x60;seatType&#x60;), &#x60;amenityFlags&#x60; (every set flag by name) and &#x60;seatType&#x60; (default chair). GA areas add capacity, soldCount, heldCount and availableCount. &#x60;channelKeyId&#x60; is returned to partner API keys and workspace admins only. Requires content_write.
+    # Looks the object up by id, then by exact label (409 when the label is not unique). Returns label, category, price (cents), durable &#x60;dbStatus&#x60;, &#x60;visualStatus&#x60; (Postgres status merged with live Redis hold presence), &#x60;ticketBuyerId&#x60; of the current state, &#x60;forSale&#x60;, the object status overlay (&#x60;objectStatus&#x60;, &#x60;orderId&#x60;, &#x60;extraData&#x60;) and &#x60;section&#x60; when the seat lies inside a named section guide, and &#x60;zone&#x60; / &#x60;zoneId&#x60; (layout zone: explicit assignment, then the section zone, then the zone outline; null outside every zone), and &#x60;entrance&#x60; (the most specific of seat, row, table and section; GA areas use their own). Seats add &#x60;rowLabel&#x60;, &#x60;displayedLabel&#x60;, &#x60;accessibility&#x60; (stored form: the four original flags as booleans, newer flags in the &#x60;amenities&#x60; bitmask, &#x60;seatType&#x60;), &#x60;amenityFlags&#x60; (every set flag by name) and &#x60;seatType&#x60; (default chair). GA areas add capacity, soldCount, heldCount and availableCount; areas sold as a whole add the seats.io &#x60;areaType&#x60; (&#x60;fixedOccupancy&#x60; / &#x60;variableOccupancy&#x60;), &#x60;bookAsAWhole: true&#x60; and, for variable occupancy, &#x60;minOccupancy&#x60; / &#x60;maxOccupancy&#x60; (their &#x60;availableCount&#x60; is the capacity or 0: never part of the area). &#x60;channelKeyId&#x60; is returned to partner API keys and workspace admins only. Requires content_write.
     # @param event_id [String] 
     # @param object_id [String] Seat or GA area id (UUID), or its exact label / GA name.
     # @param [Hash] opts the optional parameters
@@ -1163,7 +1357,7 @@ module SeatsChart
     end
 
     # Detailed report grouped by availability (available / not_available) (CSV)
-    # Buckets `available` and `not_available`; each row carries `availabilityReason`. Optional `?availability=`. GA areas with at least one free place are `available`. Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
+    # Buckets `available` and `not_available`; each row carries `availabilityReason`. Optional `?availability=`. GA areas with at least one free place are `available`. Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add `areaType` (`fixedOccupancy` | `variableOccupancy`), `bookAsAWhole: true` and, for variable occupancy, `minOccupancy` / `maxOccupancy`; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :availability Only this availability bucket.
@@ -1175,7 +1369,7 @@ module SeatsChart
     end
 
     # Detailed report grouped by availability (available / not_available) (CSV)
-    # Buckets &#x60;available&#x60; and &#x60;not_available&#x60;; each row carries &#x60;availabilityReason&#x60;. Optional &#x60;?availability&#x3D;&#x60;. GA areas with at least one free place are &#x60;available&#x60;. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
+    # Buckets &#x60;available&#x60; and &#x60;not_available&#x60;; each row carries &#x60;availabilityReason&#x60;. Optional &#x60;?availability&#x3D;&#x60;. GA areas with at least one free place are &#x60;available&#x60;. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add &#x60;areaType&#x60; (&#x60;fixedOccupancy&#x60; | &#x60;variableOccupancy&#x60;), &#x60;bookAsAWhole: true&#x60; and, for variable occupancy, &#x60;minOccupancy&#x60; / &#x60;maxOccupancy&#x60;; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :availability Only this availability bucket.
@@ -1247,7 +1441,7 @@ module SeatsChart
     end
 
     # Detailed report grouped by availability (available / not_available)
-    # Buckets `available` and `not_available`; each row carries `availabilityReason`. Optional `?availability=`. GA areas with at least one free place are `available`. Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
+    # Buckets `available` and `not_available`; each row carries `availabilityReason`. Optional `?availability=`. GA areas with at least one free place are `available`. Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add `areaType` (`fixedOccupancy` | `variableOccupancy`), `bookAsAWhole: true` and, for variable occupancy, `minOccupancy` / `maxOccupancy`; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :availability Only this availability bucket.
@@ -1259,7 +1453,7 @@ module SeatsChart
     end
 
     # Detailed report grouped by availability (available / not_available)
-    # Buckets &#x60;available&#x60; and &#x60;not_available&#x60;; each row carries &#x60;availabilityReason&#x60;. Optional &#x60;?availability&#x3D;&#x60;. GA areas with at least one free place are &#x60;available&#x60;. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
+    # Buckets &#x60;available&#x60; and &#x60;not_available&#x60;; each row carries &#x60;availabilityReason&#x60;. Optional &#x60;?availability&#x3D;&#x60;. GA areas with at least one free place are &#x60;available&#x60;. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add &#x60;areaType&#x60; (&#x60;fixedOccupancy&#x60; | &#x60;variableOccupancy&#x60;), &#x60;bookAsAWhole: true&#x60; and, for variable occupancy, &#x60;minOccupancy&#x60; / &#x60;maxOccupancy&#x60;; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :availability Only this availability bucket.
@@ -1331,10 +1525,11 @@ module SeatsChart
     end
 
     # Detailed report grouped by availability reason (CSV)
-    # Buckets available, resale, booked, held, custom_status, not_for_sale. GA areas use their primary reason (available when any place is free). Optional `?reason=`. Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
+    # Buckets available, resale, booked, held, custom_status, not_for_sale. GA areas use their primary reason (available when any place is free). Optional `?reason=` (or `?availabilityReason=`). Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add `areaType` (`fixedOccupancy` | `variableOccupancy`), `bookAsAWhole: true` and, for variable occupancy, `minOccupancy` / `maxOccupancy`; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :reason Only this reason bucket.
+    # @option opts [String] :availability_reason Same as &#x60;reason&#x60;.
     # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
     # @return [nil]
     def get_api_events_by_event_id_reports_by_availability_reason_csv(event_id, opts = {})
@@ -1343,10 +1538,11 @@ module SeatsChart
     end
 
     # Detailed report grouped by availability reason (CSV)
-    # Buckets available, resale, booked, held, custom_status, not_for_sale. GA areas use their primary reason (available when any place is free). Optional &#x60;?reason&#x3D;&#x60;. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
+    # Buckets available, resale, booked, held, custom_status, not_for_sale. GA areas use their primary reason (available when any place is free). Optional &#x60;?reason&#x3D;&#x60; (or &#x60;?availabilityReason&#x3D;&#x60;). Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add &#x60;areaType&#x60; (&#x60;fixedOccupancy&#x60; | &#x60;variableOccupancy&#x60;), &#x60;bookAsAWhole: true&#x60; and, for variable occupancy, &#x60;minOccupancy&#x60; / &#x60;maxOccupancy&#x60;; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :reason Only this reason bucket.
+    # @option opts [String] :availability_reason Same as &#x60;reason&#x60;.
     # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def get_api_events_by_event_id_reports_by_availability_reason_csv_with_http_info(event_id, opts = {})
@@ -1370,6 +1566,14 @@ module SeatsChart
         fail ArgumentError, 'invalid value for "opts[:"reason"]" when calling EventsApi.get_api_events_by_event_id_reports_by_availability_reason_csv, the character length must be great than or equal to 1.'
       end
 
+      if @api_client.config.client_side_validation && !opts[:'availability_reason'].nil? && opts[:'availability_reason'].to_s.length > 128
+        fail ArgumentError, 'invalid value for "opts[:"availability_reason"]" when calling EventsApi.get_api_events_by_event_id_reports_by_availability_reason_csv, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'availability_reason'].nil? && opts[:'availability_reason'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"availability_reason"]" when calling EventsApi.get_api_events_by_event_id_reports_by_availability_reason_csv, the character length must be great than or equal to 1.'
+      end
+
       allowable_values = ["true", "false"]
       if @api_client.config.client_side_validation && opts[:'live_holds'] && !allowable_values.include?(opts[:'live_holds'])
         fail ArgumentError, "invalid value for \"live_holds\", must be one of #{allowable_values}"
@@ -1380,6 +1584,7 @@ module SeatsChart
       # query parameters
       query_params = opts[:query_params] || {}
       query_params[:'reason'] = opts[:'reason'] if !opts[:'reason'].nil?
+      query_params[:'availabilityReason'] = opts[:'availability_reason'] if !opts[:'availability_reason'].nil?
       query_params[:'liveHolds'] = opts[:'live_holds'] if !opts[:'live_holds'].nil?
 
       # header parameters
@@ -1415,10 +1620,11 @@ module SeatsChart
     end
 
     # Detailed report grouped by availability reason
-    # Buckets available, resale, booked, held, custom_status, not_for_sale. GA areas use their primary reason (available when any place is free). Optional `?reason=`. Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
+    # Buckets available, resale, booked, held, custom_status, not_for_sale. GA areas use their primary reason (available when any place is free). Optional `?reason=` (or `?availabilityReason=`). Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add `areaType` (`fixedOccupancy` | `variableOccupancy`), `bookAsAWhole: true` and, for variable occupancy, `minOccupancy` / `maxOccupancy`; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :reason Only this reason bucket.
+    # @option opts [String] :availability_reason Same as &#x60;reason&#x60;.
     # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
     # @return [nil]
     def get_api_events_by_event_id_reports_by_availability_reason_json(event_id, opts = {})
@@ -1427,10 +1633,11 @@ module SeatsChart
     end
 
     # Detailed report grouped by availability reason
-    # Buckets available, resale, booked, held, custom_status, not_for_sale. GA areas use their primary reason (available when any place is free). Optional &#x60;?reason&#x3D;&#x60;. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
+    # Buckets available, resale, booked, held, custom_status, not_for_sale. GA areas use their primary reason (available when any place is free). Optional &#x60;?reason&#x3D;&#x60; (or &#x60;?availabilityReason&#x3D;&#x60;). Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add &#x60;areaType&#x60; (&#x60;fixedOccupancy&#x60; | &#x60;variableOccupancy&#x60;), &#x60;bookAsAWhole: true&#x60; and, for variable occupancy, &#x60;minOccupancy&#x60; / &#x60;maxOccupancy&#x60;; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :reason Only this reason bucket.
+    # @option opts [String] :availability_reason Same as &#x60;reason&#x60;.
     # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def get_api_events_by_event_id_reports_by_availability_reason_json_with_http_info(event_id, opts = {})
@@ -1454,6 +1661,14 @@ module SeatsChart
         fail ArgumentError, 'invalid value for "opts[:"reason"]" when calling EventsApi.get_api_events_by_event_id_reports_by_availability_reason_json, the character length must be great than or equal to 1.'
       end
 
+      if @api_client.config.client_side_validation && !opts[:'availability_reason'].nil? && opts[:'availability_reason'].to_s.length > 128
+        fail ArgumentError, 'invalid value for "opts[:"availability_reason"]" when calling EventsApi.get_api_events_by_event_id_reports_by_availability_reason_json, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'availability_reason'].nil? && opts[:'availability_reason'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"availability_reason"]" when calling EventsApi.get_api_events_by_event_id_reports_by_availability_reason_json, the character length must be great than or equal to 1.'
+      end
+
       allowable_values = ["true", "false"]
       if @api_client.config.client_side_validation && opts[:'live_holds'] && !allowable_values.include?(opts[:'live_holds'])
         fail ArgumentError, "invalid value for \"live_holds\", must be one of #{allowable_values}"
@@ -1464,6 +1679,7 @@ module SeatsChart
       # query parameters
       query_params = opts[:query_params] || {}
       query_params[:'reason'] = opts[:'reason'] if !opts[:'reason'].nil?
+      query_params[:'availabilityReason'] = opts[:'availability_reason'] if !opts[:'availability_reason'].nil?
       query_params[:'liveHolds'] = opts[:'live_holds'] if !opts[:'live_holds'].nil?
 
       # header parameters
@@ -1566,7 +1782,7 @@ module SeatsChart
     end
 
     # Detailed report grouped by category key (CSV)
-    # Seats.io byCategoryKey: buckets are the category keys (chart category id, or the event category key of an event-only category); a category value no category defines is its own key; objects without a category → NO_CATEGORY. Rows carry `categoryKey` next to `category` (the label). Optional `?categoryKey=`. Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
+    # Seats.io byCategoryKey: buckets are the category keys (chart category id, or the event category key of an event-only category); a category value no category defines is its own key; objects without a category → NO_CATEGORY. Rows carry `categoryKey` next to `category` (the label). Optional `?categoryKey=`. Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add `areaType` (`fixedOccupancy` | `variableOccupancy`), `bookAsAWhole: true` and, for variable occupancy, `minOccupancy` / `maxOccupancy`; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :category_key Only this categoryKey bucket.
@@ -1578,7 +1794,7 @@ module SeatsChart
     end
 
     # Detailed report grouped by category key (CSV)
-    # Seats.io byCategoryKey: buckets are the category keys (chart category id, or the event category key of an event-only category); a category value no category defines is its own key; objects without a category → NO_CATEGORY. Rows carry &#x60;categoryKey&#x60; next to &#x60;category&#x60; (the label). Optional &#x60;?categoryKey&#x3D;&#x60;. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
+    # Seats.io byCategoryKey: buckets are the category keys (chart category id, or the event category key of an event-only category); a category value no category defines is its own key; objects without a category → NO_CATEGORY. Rows carry &#x60;categoryKey&#x60; next to &#x60;category&#x60; (the label). Optional &#x60;?categoryKey&#x3D;&#x60;. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add &#x60;areaType&#x60; (&#x60;fixedOccupancy&#x60; | &#x60;variableOccupancy&#x60;), &#x60;bookAsAWhole: true&#x60; and, for variable occupancy, &#x60;minOccupancy&#x60; / &#x60;maxOccupancy&#x60;; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :category_key Only this categoryKey bucket.
@@ -1650,7 +1866,7 @@ module SeatsChart
     end
 
     # Detailed report grouped by category key
-    # Seats.io byCategoryKey: buckets are the category keys (chart category id, or the event category key of an event-only category); a category value no category defines is its own key; objects without a category → NO_CATEGORY. Rows carry `categoryKey` next to `category` (the label). Optional `?categoryKey=`. Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
+    # Seats.io byCategoryKey: buckets are the category keys (chart category id, or the event category key of an event-only category); a category value no category defines is its own key; objects without a category → NO_CATEGORY. Rows carry `categoryKey` next to `category` (the label). Optional `?categoryKey=`. Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add `areaType` (`fixedOccupancy` | `variableOccupancy`), `bookAsAWhole: true` and, for variable occupancy, `minOccupancy` / `maxOccupancy`; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :category_key Only this categoryKey bucket.
@@ -1662,7 +1878,7 @@ module SeatsChart
     end
 
     # Detailed report grouped by category key
-    # Seats.io byCategoryKey: buckets are the category keys (chart category id, or the event category key of an event-only category); a category value no category defines is its own key; objects without a category → NO_CATEGORY. Rows carry &#x60;categoryKey&#x60; next to &#x60;category&#x60; (the label). Optional &#x60;?categoryKey&#x3D;&#x60;. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
+    # Seats.io byCategoryKey: buckets are the category keys (chart category id, or the event category key of an event-only category); a category value no category defines is its own key; objects without a category → NO_CATEGORY. Rows carry &#x60;categoryKey&#x60; next to &#x60;category&#x60; (the label). Optional &#x60;?categoryKey&#x3D;&#x60;. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add &#x60;areaType&#x60; (&#x60;fixedOccupancy&#x60; | &#x60;variableOccupancy&#x60;), &#x60;bookAsAWhole: true&#x60; and, for variable occupancy, &#x60;minOccupancy&#x60; / &#x60;maxOccupancy&#x60;; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :category_key Only this categoryKey bucket.
@@ -1734,10 +1950,11 @@ module SeatsChart
     end
 
     # Detailed report grouped by category label (CSV)
-    # Seats.io byCategoryLabel: buckets are the category labels (the objects' `category` value, as in the legacy by-category report); objects without a category → NO_CATEGORY. Optional `?categoryLabel=`. Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
+    # Seats.io byCategoryLabel: buckets are the category labels (the objects' `category` value, as in the legacy by-category report); objects without a category → NO_CATEGORY. Optional `?categoryLabel=` (or `?category=`). Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add `areaType` (`fixedOccupancy` | `variableOccupancy`), `bookAsAWhole: true` and, for variable occupancy, `minOccupancy` / `maxOccupancy`; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :category_label Only this categoryLabel bucket.
+    # @option opts [String] :category Same as &#x60;categoryLabel&#x60;.
     # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
     # @return [nil]
     def get_api_events_by_event_id_reports_by_category_label_csv(event_id, opts = {})
@@ -1746,10 +1963,11 @@ module SeatsChart
     end
 
     # Detailed report grouped by category label (CSV)
-    # Seats.io byCategoryLabel: buckets are the category labels (the objects&#39; &#x60;category&#x60; value, as in the legacy by-category report); objects without a category → NO_CATEGORY. Optional &#x60;?categoryLabel&#x3D;&#x60;. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
+    # Seats.io byCategoryLabel: buckets are the category labels (the objects&#39; &#x60;category&#x60; value, as in the legacy by-category report); objects without a category → NO_CATEGORY. Optional &#x60;?categoryLabel&#x3D;&#x60; (or &#x60;?category&#x3D;&#x60;). Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add &#x60;areaType&#x60; (&#x60;fixedOccupancy&#x60; | &#x60;variableOccupancy&#x60;), &#x60;bookAsAWhole: true&#x60; and, for variable occupancy, &#x60;minOccupancy&#x60; / &#x60;maxOccupancy&#x60;; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :category_label Only this categoryLabel bucket.
+    # @option opts [String] :category Same as &#x60;categoryLabel&#x60;.
     # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def get_api_events_by_event_id_reports_by_category_label_csv_with_http_info(event_id, opts = {})
@@ -1773,6 +1991,14 @@ module SeatsChart
         fail ArgumentError, 'invalid value for "opts[:"category_label"]" when calling EventsApi.get_api_events_by_event_id_reports_by_category_label_csv, the character length must be great than or equal to 1.'
       end
 
+      if @api_client.config.client_side_validation && !opts[:'category'].nil? && opts[:'category'].to_s.length > 128
+        fail ArgumentError, 'invalid value for "opts[:"category"]" when calling EventsApi.get_api_events_by_event_id_reports_by_category_label_csv, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'category'].nil? && opts[:'category'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"category"]" when calling EventsApi.get_api_events_by_event_id_reports_by_category_label_csv, the character length must be great than or equal to 1.'
+      end
+
       allowable_values = ["true", "false"]
       if @api_client.config.client_side_validation && opts[:'live_holds'] && !allowable_values.include?(opts[:'live_holds'])
         fail ArgumentError, "invalid value for \"live_holds\", must be one of #{allowable_values}"
@@ -1783,6 +2009,7 @@ module SeatsChart
       # query parameters
       query_params = opts[:query_params] || {}
       query_params[:'categoryLabel'] = opts[:'category_label'] if !opts[:'category_label'].nil?
+      query_params[:'category'] = opts[:'category'] if !opts[:'category'].nil?
       query_params[:'liveHolds'] = opts[:'live_holds'] if !opts[:'live_holds'].nil?
 
       # header parameters
@@ -1818,10 +2045,11 @@ module SeatsChart
     end
 
     # Detailed report grouped by category label
-    # Seats.io byCategoryLabel: buckets are the category labels (the objects' `category` value, as in the legacy by-category report); objects without a category → NO_CATEGORY. Optional `?categoryLabel=`. Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
+    # Seats.io byCategoryLabel: buckets are the category labels (the objects' `category` value, as in the legacy by-category report); objects without a category → NO_CATEGORY. Optional `?categoryLabel=` (or `?category=`). Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add `areaType` (`fixedOccupancy` | `variableOccupancy`), `bookAsAWhole: true` and, for variable occupancy, `minOccupancy` / `maxOccupancy`; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :category_label Only this categoryLabel bucket.
+    # @option opts [String] :category Same as &#x60;categoryLabel&#x60;.
     # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
     # @return [nil]
     def get_api_events_by_event_id_reports_by_category_label_json(event_id, opts = {})
@@ -1830,10 +2058,11 @@ module SeatsChart
     end
 
     # Detailed report grouped by category label
-    # Seats.io byCategoryLabel: buckets are the category labels (the objects&#39; &#x60;category&#x60; value, as in the legacy by-category report); objects without a category → NO_CATEGORY. Optional &#x60;?categoryLabel&#x3D;&#x60;. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
+    # Seats.io byCategoryLabel: buckets are the category labels (the objects&#39; &#x60;category&#x60; value, as in the legacy by-category report); objects without a category → NO_CATEGORY. Optional &#x60;?categoryLabel&#x3D;&#x60; (or &#x60;?category&#x3D;&#x60;). Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add &#x60;areaType&#x60; (&#x60;fixedOccupancy&#x60; | &#x60;variableOccupancy&#x60;), &#x60;bookAsAWhole: true&#x60; and, for variable occupancy, &#x60;minOccupancy&#x60; / &#x60;maxOccupancy&#x60;; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :category_label Only this categoryLabel bucket.
+    # @option opts [String] :category Same as &#x60;categoryLabel&#x60;.
     # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def get_api_events_by_event_id_reports_by_category_label_json_with_http_info(event_id, opts = {})
@@ -1857,6 +2086,14 @@ module SeatsChart
         fail ArgumentError, 'invalid value for "opts[:"category_label"]" when calling EventsApi.get_api_events_by_event_id_reports_by_category_label_json, the character length must be great than or equal to 1.'
       end
 
+      if @api_client.config.client_side_validation && !opts[:'category'].nil? && opts[:'category'].to_s.length > 128
+        fail ArgumentError, 'invalid value for "opts[:"category"]" when calling EventsApi.get_api_events_by_event_id_reports_by_category_label_json, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'category'].nil? && opts[:'category'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"category"]" when calling EventsApi.get_api_events_by_event_id_reports_by_category_label_json, the character length must be great than or equal to 1.'
+      end
+
       allowable_values = ["true", "false"]
       if @api_client.config.client_side_validation && opts[:'live_holds'] && !allowable_values.include?(opts[:'live_holds'])
         fail ArgumentError, "invalid value for \"live_holds\", must be one of #{allowable_values}"
@@ -1867,6 +2104,7 @@ module SeatsChart
       # query parameters
       query_params = opts[:query_params] || {}
       query_params[:'categoryLabel'] = opts[:'category_label'] if !opts[:'category_label'].nil?
+      query_params[:'category'] = opts[:'category'] if !opts[:'category'].nil?
       query_params[:'liveHolds'] = opts[:'live_holds'] if !opts[:'live_holds'].nil?
 
       # header parameters
@@ -2053,40 +2291,57 @@ module SeatsChart
       return data, status_code, headers
     end
 
-    # Detailed report grouped by object type (seat|ga)
+    # Detailed report grouped by object status (CSV)
+    # seats.io detailed byStatus: buckets are the object statuses (`available`, `locked`, `sold`, a custom object status, `resale`, …), each with its objects. `GET /events/{eventId}/reports/by-status.json` keeps returning counts only. Optional `?status=` returns only that status (seats.io `byStatus(event, status)`). Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add `areaType` (`fixedOccupancy` | `variableOccupancy`), `bookAsAWhole: true` and, for variable occupancy, `minOccupancy` / `maxOccupancy`; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :status Only this status bucket.
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
     # @return [nil]
-    def get_api_events_by_event_id_reports_by_object_type_json(event_id, opts = {})
-      get_api_events_by_event_id_reports_by_object_type_json_with_http_info(event_id, opts)
+    def get_api_events_by_event_id_reports_by_object_status_csv(event_id, opts = {})
+      get_api_events_by_event_id_reports_by_object_status_csv_with_http_info(event_id, opts)
       nil
     end
 
-    # Detailed report grouped by object type (seat|ga)
+    # Detailed report grouped by object status (CSV)
+    # seats.io detailed byStatus: buckets are the object statuses (&#x60;available&#x60;, &#x60;locked&#x60;, &#x60;sold&#x60;, a custom object status, &#x60;resale&#x60;, …), each with its objects. &#x60;GET /events/{eventId}/reports/by-status.json&#x60; keeps returning counts only. Optional &#x60;?status&#x3D;&#x60; returns only that status (seats.io &#x60;byStatus(event, status)&#x60;). Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add &#x60;areaType&#x60; (&#x60;fixedOccupancy&#x60; | &#x60;variableOccupancy&#x60;), &#x60;bookAsAWhole: true&#x60; and, for variable occupancy, &#x60;minOccupancy&#x60; / &#x60;maxOccupancy&#x60;; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :status Only this status bucket.
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
-    def get_api_events_by_event_id_reports_by_object_type_json_with_http_info(event_id, opts = {})
+    def get_api_events_by_event_id_reports_by_object_status_csv_with_http_info(event_id, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: EventsApi.get_api_events_by_event_id_reports_by_object_type_json ...'
+        @api_client.config.logger.debug 'Calling API: EventsApi.get_api_events_by_event_id_reports_by_object_status_csv ...'
       end
       # verify the required parameter 'event_id' is set
       if @api_client.config.client_side_validation && event_id.nil?
-        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_by_object_type_json"
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_by_object_status_csv"
       end
-      if @api_client.config.client_side_validation && event_id.to_s.length > 36
-        fail ArgumentError, 'invalid value for "event_id" when calling EventsApi.get_api_events_by_event_id_reports_by_object_type_json, the character length must be smaller than or equal to 36.'
+      pattern = Regexp.new(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/)
+      if @api_client.config.client_side_validation && event_id !~ pattern
+        fail ArgumentError, "invalid value for 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_by_object_status_csv, must conform to the pattern #{pattern}."
       end
 
-      if @api_client.config.client_side_validation && event_id.to_s.length < 36
-        fail ArgumentError, 'invalid value for "event_id" when calling EventsApi.get_api_events_by_event_id_reports_by_object_type_json, the character length must be great than or equal to 36.'
+      if @api_client.config.client_side_validation && !opts[:'status'].nil? && opts[:'status'].to_s.length > 128
+        fail ArgumentError, 'invalid value for "opts[:"status"]" when calling EventsApi.get_api_events_by_event_id_reports_by_object_status_csv, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'status'].nil? && opts[:'status'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"status"]" when calling EventsApi.get_api_events_by_event_id_reports_by_object_status_csv, the character length must be great than or equal to 1.'
       end
 
+      allowable_values = ["true", "false"]
+      if @api_client.config.client_side_validation && opts[:'live_holds'] && !allowable_values.include?(opts[:'live_holds'])
+        fail ArgumentError, "invalid value for \"live_holds\", must be one of #{allowable_values}"
+      end
       # resource path
-      local_var_path = '/api/events/{eventId}/reports/by-object-type.json'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+      local_var_path = '/api/events/{eventId}/reports/by-object-status.csv'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'status'] = opts[:'status'] if !opts[:'status'].nil?
+      query_params[:'liveHolds'] = opts[:'live_holds'] if !opts[:'live_holds'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -2104,7 +2359,7 @@ module SeatsChart
       auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
 
       new_options = opts.merge(
-        :operation => :"EventsApi.get_api_events_by_event_id_reports_by_object_type_json",
+        :operation => :"EventsApi.get_api_events_by_event_id_reports_by_object_status_csv",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -2115,54 +2370,62 @@ module SeatsChart
 
       data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_reports_by_object_type_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_reports_by_object_status_csv\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Detailed report grouped by orderId (Postgres)
-    # Uses object_statuses.order_id. Missing order → bucket NO_ORDER_ID. Optional `?orderId=`.
+    # Detailed report grouped by object status
+    # seats.io detailed byStatus: buckets are the object statuses (`available`, `locked`, `sold`, a custom object status, `resale`, …), each with its objects. `GET /events/{eventId}/reports/by-status.json` keeps returning counts only. Optional `?status=` returns only that status (seats.io `byStatus(event, status)`). Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add `areaType` (`fixedOccupancy` | `variableOccupancy`), `bookAsAWhole: true` and, for variable occupancy, `minOccupancy` / `maxOccupancy`; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :order_id 
+    # @option opts [String] :status Only this status bucket.
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
     # @return [nil]
-    def get_api_events_by_event_id_reports_by_order_id_json(event_id, opts = {})
-      get_api_events_by_event_id_reports_by_order_id_json_with_http_info(event_id, opts)
+    def get_api_events_by_event_id_reports_by_object_status_json(event_id, opts = {})
+      get_api_events_by_event_id_reports_by_object_status_json_with_http_info(event_id, opts)
       nil
     end
 
-    # Detailed report grouped by orderId (Postgres)
-    # Uses object_statuses.order_id. Missing order → bucket NO_ORDER_ID. Optional &#x60;?orderId&#x3D;&#x60;.
+    # Detailed report grouped by object status
+    # seats.io detailed byStatus: buckets are the object statuses (&#x60;available&#x60;, &#x60;locked&#x60;, &#x60;sold&#x60;, a custom object status, &#x60;resale&#x60;, …), each with its objects. &#x60;GET /events/{eventId}/reports/by-status.json&#x60; keeps returning counts only. Optional &#x60;?status&#x3D;&#x60; returns only that status (seats.io &#x60;byStatus(event, status)&#x60;). Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add &#x60;areaType&#x60; (&#x60;fixedOccupancy&#x60; | &#x60;variableOccupancy&#x60;), &#x60;bookAsAWhole: true&#x60; and, for variable occupancy, &#x60;minOccupancy&#x60; / &#x60;maxOccupancy&#x60;; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :order_id 
+    # @option opts [String] :status Only this status bucket.
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
-    def get_api_events_by_event_id_reports_by_order_id_json_with_http_info(event_id, opts = {})
+    def get_api_events_by_event_id_reports_by_object_status_json_with_http_info(event_id, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: EventsApi.get_api_events_by_event_id_reports_by_order_id_json ...'
+        @api_client.config.logger.debug 'Calling API: EventsApi.get_api_events_by_event_id_reports_by_object_status_json ...'
       end
       # verify the required parameter 'event_id' is set
       if @api_client.config.client_side_validation && event_id.nil?
-        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_by_order_id_json"
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_by_object_status_json"
       end
-      if @api_client.config.client_side_validation && event_id.to_s.length > 36
-        fail ArgumentError, 'invalid value for "event_id" when calling EventsApi.get_api_events_by_event_id_reports_by_order_id_json, the character length must be smaller than or equal to 36.'
+      pattern = Regexp.new(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/)
+      if @api_client.config.client_side_validation && event_id !~ pattern
+        fail ArgumentError, "invalid value for 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_by_object_status_json, must conform to the pattern #{pattern}."
       end
 
-      if @api_client.config.client_side_validation && event_id.to_s.length < 36
-        fail ArgumentError, 'invalid value for "event_id" when calling EventsApi.get_api_events_by_event_id_reports_by_order_id_json, the character length must be great than or equal to 36.'
+      if @api_client.config.client_side_validation && !opts[:'status'].nil? && opts[:'status'].to_s.length > 128
+        fail ArgumentError, 'invalid value for "opts[:"status"]" when calling EventsApi.get_api_events_by_event_id_reports_by_object_status_json, the character length must be smaller than or equal to 128.'
       end
 
-      if @api_client.config.client_side_validation && !opts[:'order_id'].nil? && opts[:'order_id'].to_s.length > 255
-        fail ArgumentError, 'invalid value for "opts[:"order_id"]" when calling EventsApi.get_api_events_by_event_id_reports_by_order_id_json, the character length must be smaller than or equal to 255.'
+      if @api_client.config.client_side_validation && !opts[:'status'].nil? && opts[:'status'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"status"]" when calling EventsApi.get_api_events_by_event_id_reports_by_object_status_json, the character length must be great than or equal to 1.'
       end
 
+      allowable_values = ["true", "false"]
+      if @api_client.config.client_side_validation && opts[:'live_holds'] && !allowable_values.include?(opts[:'live_holds'])
+        fail ArgumentError, "invalid value for \"live_holds\", must be one of #{allowable_values}"
+      end
       # resource path
-      local_var_path = '/api/events/{eventId}/reports/by-order-id.json'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+      local_var_path = '/api/events/{eventId}/reports/by-object-status.json'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
-      query_params[:'orderId'] = opts[:'order_id'] if !opts[:'order_id'].nil?
+      query_params[:'status'] = opts[:'status'] if !opts[:'status'].nil?
+      query_params[:'liveHolds'] = opts[:'live_holds'] if !opts[:'live_holds'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -2180,7 +2443,7 @@ module SeatsChart
       auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
 
       new_options = opts.merge(
-        :operation => :"EventsApi.get_api_events_by_event_id_reports_by_order_id_json",
+        :operation => :"EventsApi.get_api_events_by_event_id_reports_by_object_status_json",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -2191,54 +2454,54 @@ module SeatsChart
 
       data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_reports_by_order_id_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_reports_by_object_status_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Detailed report grouped by section
-    # Groups seats by layout sectionGuide name (geometry join via pos_x/pos_y). Seats outside all guides and GA areas → NO_SECTION.
+    # Detailed report grouped by object type (seat|ga)
+    # Buckets `seat` and `ga` with their objects (Postgres). Optional `?objectType=seat|ga` returns only that bucket.
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :section 
+    # @option opts [String] :object_type Only this object type (seats.io &#x60;byObjectType(event, type)&#x60;).
     # @return [nil]
-    def get_api_events_by_event_id_reports_by_section_json(event_id, opts = {})
-      get_api_events_by_event_id_reports_by_section_json_with_http_info(event_id, opts)
+    def get_api_events_by_event_id_reports_by_object_type_json(event_id, opts = {})
+      get_api_events_by_event_id_reports_by_object_type_json_with_http_info(event_id, opts)
       nil
     end
 
-    # Detailed report grouped by section
-    # Groups seats by layout sectionGuide name (geometry join via pos_x/pos_y). Seats outside all guides and GA areas → NO_SECTION.
+    # Detailed report grouped by object type (seat|ga)
+    # Buckets &#x60;seat&#x60; and &#x60;ga&#x60; with their objects (Postgres). Optional &#x60;?objectType&#x3D;seat|ga&#x60; returns only that bucket.
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :section 
+    # @option opts [String] :object_type Only this object type (seats.io &#x60;byObjectType(event, type)&#x60;).
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
-    def get_api_events_by_event_id_reports_by_section_json_with_http_info(event_id, opts = {})
+    def get_api_events_by_event_id_reports_by_object_type_json_with_http_info(event_id, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: EventsApi.get_api_events_by_event_id_reports_by_section_json ...'
+        @api_client.config.logger.debug 'Calling API: EventsApi.get_api_events_by_event_id_reports_by_object_type_json ...'
       end
       # verify the required parameter 'event_id' is set
       if @api_client.config.client_side_validation && event_id.nil?
-        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_by_section_json"
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_by_object_type_json"
       end
       if @api_client.config.client_side_validation && event_id.to_s.length > 36
-        fail ArgumentError, 'invalid value for "event_id" when calling EventsApi.get_api_events_by_event_id_reports_by_section_json, the character length must be smaller than or equal to 36.'
+        fail ArgumentError, 'invalid value for "event_id" when calling EventsApi.get_api_events_by_event_id_reports_by_object_type_json, the character length must be smaller than or equal to 36.'
       end
 
       if @api_client.config.client_side_validation && event_id.to_s.length < 36
-        fail ArgumentError, 'invalid value for "event_id" when calling EventsApi.get_api_events_by_event_id_reports_by_section_json, the character length must be great than or equal to 36.'
+        fail ArgumentError, 'invalid value for "event_id" when calling EventsApi.get_api_events_by_event_id_reports_by_object_type_json, the character length must be great than or equal to 36.'
       end
 
-      if @api_client.config.client_side_validation && !opts[:'section'].nil? && opts[:'section'].to_s.length > 128
-        fail ArgumentError, 'invalid value for "opts[:"section"]" when calling EventsApi.get_api_events_by_event_id_reports_by_section_json, the character length must be smaller than or equal to 128.'
+      allowable_values = ["seat", "ga"]
+      if @api_client.config.client_side_validation && opts[:'object_type'] && !allowable_values.include?(opts[:'object_type'])
+        fail ArgumentError, "invalid value for \"object_type\", must be one of #{allowable_values}"
       end
-
       # resource path
-      local_var_path = '/api/events/{eventId}/reports/by-section.json'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+      local_var_path = '/api/events/{eventId}/reports/by-object-type.json'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
-      query_params[:'section'] = opts[:'section'] if !opts[:'section'].nil?
+      query_params[:'objectType'] = opts[:'object_type'] if !opts[:'object_type'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -2256,7 +2519,7 @@ module SeatsChart
       auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
 
       new_options = opts.merge(
-        :operation => :"EventsApi.get_api_events_by_event_id_reports_by_section_json",
+        :operation => :"EventsApi.get_api_events_by_event_id_reports_by_object_type_json",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -2267,12 +2530,164 @@ module SeatsChart
 
       data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_reports_by_section_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_reports_by_object_type_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Seat counts by Postgres status
+    # Detailed report grouped by orderId (Postgres)
+    # Uses object_statuses.order_id. Missing order → bucket NO_ORDER_ID. Optional `?orderId=`.
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :order_id 
+    # @return [nil]
+    def get_api_events_by_event_id_reports_by_order_id_json(event_id, opts = {})
+      get_api_events_by_event_id_reports_by_order_id_json_with_http_info(event_id, opts)
+      nil
+    end
+
+    # Detailed report grouped by orderId (Postgres)
+    # Uses object_statuses.order_id. Missing order → bucket NO_ORDER_ID. Optional &#x60;?orderId&#x3D;&#x60;.
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :order_id 
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_events_by_event_id_reports_by_order_id_json_with_http_info(event_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EventsApi.get_api_events_by_event_id_reports_by_order_id_json ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_by_order_id_json"
+      end
+      if @api_client.config.client_side_validation && event_id.to_s.length > 36
+        fail ArgumentError, 'invalid value for "event_id" when calling EventsApi.get_api_events_by_event_id_reports_by_order_id_json, the character length must be smaller than or equal to 36.'
+      end
+
+      if @api_client.config.client_side_validation && event_id.to_s.length < 36
+        fail ArgumentError, 'invalid value for "event_id" when calling EventsApi.get_api_events_by_event_id_reports_by_order_id_json, the character length must be great than or equal to 36.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'order_id'].nil? && opts[:'order_id'].to_s.length > 255
+        fail ArgumentError, 'invalid value for "opts[:"order_id"]" when calling EventsApi.get_api_events_by_event_id_reports_by_order_id_json, the character length must be smaller than or equal to 255.'
+      end
+
+      # resource path
+      local_var_path = '/api/events/{eventId}/reports/by-order-id.json'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'orderId'] = opts[:'order_id'] if !opts[:'order_id'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"EventsApi.get_api_events_by_event_id_reports_by_order_id_json",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_reports_by_order_id_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Detailed report grouped by section
+    # Groups seats by layout sectionGuide name (geometry join via pos_x/pos_y). Seats outside all guides and GA areas → NO_SECTION.
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :section 
+    # @return [nil]
+    def get_api_events_by_event_id_reports_by_section_json(event_id, opts = {})
+      get_api_events_by_event_id_reports_by_section_json_with_http_info(event_id, opts)
+      nil
+    end
+
+    # Detailed report grouped by section
+    # Groups seats by layout sectionGuide name (geometry join via pos_x/pos_y). Seats outside all guides and GA areas → NO_SECTION.
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :section 
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_events_by_event_id_reports_by_section_json_with_http_info(event_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EventsApi.get_api_events_by_event_id_reports_by_section_json ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_by_section_json"
+      end
+      if @api_client.config.client_side_validation && event_id.to_s.length > 36
+        fail ArgumentError, 'invalid value for "event_id" when calling EventsApi.get_api_events_by_event_id_reports_by_section_json, the character length must be smaller than or equal to 36.'
+      end
+
+      if @api_client.config.client_side_validation && event_id.to_s.length < 36
+        fail ArgumentError, 'invalid value for "event_id" when calling EventsApi.get_api_events_by_event_id_reports_by_section_json, the character length must be great than or equal to 36.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'section'].nil? && opts[:'section'].to_s.length > 128
+        fail ArgumentError, 'invalid value for "opts[:"section"]" when calling EventsApi.get_api_events_by_event_id_reports_by_section_json, the character length must be smaller than or equal to 128.'
+      end
+
+      # resource path
+      local_var_path = '/api/events/{eventId}/reports/by-section.json'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'section'] = opts[:'section'] if !opts[:'section'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"EventsApi.get_api_events_by_event_id_reports_by_section_json",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_reports_by_section_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Seat counts by Postgres status
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -2340,7 +2755,7 @@ module SeatsChart
     end
 
     # Detailed report grouped by zone (CSV)
-    # Zones are `zone` layout shapes. Seats resolve explicit assignment (layoutMeta.seatZones) → their section's zone → the zone outline containing them; GA areas use `zoneId` or their centre. Others → NO_ZONE. Optional `?zone=` (zone name). The response lists the layout `zones`. Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
+    # Zones are `zone` layout shapes. Seats resolve explicit assignment (layoutMeta.seatZones) → their section's zone → the zone outline containing them; GA areas use `zoneId` or their centre. Others → NO_ZONE. Optional `?zone=` (zone name). The response lists the layout `zones`. Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add `areaType` (`fixedOccupancy` | `variableOccupancy`), `bookAsAWhole: true` and, for variable occupancy, `minOccupancy` / `maxOccupancy`; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :zone Only this zone bucket.
@@ -2352,7 +2767,7 @@ module SeatsChart
     end
 
     # Detailed report grouped by zone (CSV)
-    # Zones are &#x60;zone&#x60; layout shapes. Seats resolve explicit assignment (layoutMeta.seatZones) → their section&#39;s zone → the zone outline containing them; GA areas use &#x60;zoneId&#x60; or their centre. Others → NO_ZONE. Optional &#x60;?zone&#x3D;&#x60; (zone name). The response lists the layout &#x60;zones&#x60;. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
+    # Zones are &#x60;zone&#x60; layout shapes. Seats resolve explicit assignment (layoutMeta.seatZones) → their section&#39;s zone → the zone outline containing them; GA areas use &#x60;zoneId&#x60; or their centre. Others → NO_ZONE. Optional &#x60;?zone&#x3D;&#x60; (zone name). The response lists the layout &#x60;zones&#x60;. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add &#x60;areaType&#x60; (&#x60;fixedOccupancy&#x60; | &#x60;variableOccupancy&#x60;), &#x60;bookAsAWhole: true&#x60; and, for variable occupancy, &#x60;minOccupancy&#x60; / &#x60;maxOccupancy&#x60;; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :zone Only this zone bucket.
@@ -2424,7 +2839,7 @@ module SeatsChart
     end
 
     # Detailed report grouped by zone
-    # Zones are `zone` layout shapes. Seats resolve explicit assignment (layoutMeta.seatZones) → their section's zone → the zone outline containing them; GA areas use `zoneId` or their centre. Others → NO_ZONE. Optional `?zone=` (zone name). The response lists the layout `zones`. Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
+    # Zones are `zone` layout shapes. Seats resolve explicit assignment (layoutMeta.seatZones) → their section's zone → the zone outline containing them; GA areas use `zoneId` or their centre. Others → NO_ZONE. Optional `?zone=` (zone name). The response lists the layout `zones`. Rows: `objectId`, `label`, `objectType` (seat|ga), `status` (durable status or object status overlay), `category`, `section`, `zone`, `forSale`, `channelKeyId`, `orderId`, `availability` (available|not_available) and `availabilityReason` (available|resale|booked|held|custom_status|not_for_sale). GA rows add `capacity`, `soldCount`, `heldCount`, `availableCount` and `places` (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. `liveHolds` tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add `areaType` (`fixedOccupancy` | `variableOccupancy`), `bookAsAWhole: true` and, for variable occupancy, `minOccupancy` / `maxOccupancy`; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The `.csv` variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :zone Only this zone bucket.
@@ -2436,7 +2851,7 @@ module SeatsChart
     end
 
     # Detailed report grouped by zone
-    # Zones are &#x60;zone&#x60; layout shapes. Seats resolve explicit assignment (layoutMeta.seatZones) → their section&#39;s zone → the zone outline containing them; GA areas use &#x60;zoneId&#x60; or their centre. Others → NO_ZONE. Optional &#x60;?zone&#x3D;&#x60; (zone name). The response lists the layout &#x60;zones&#x60;. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
+    # Zones are &#x60;zone&#x60; layout shapes. Seats resolve explicit assignment (layoutMeta.seatZones) → their section&#39;s zone → the zone outline containing them; GA areas use &#x60;zoneId&#x60; or their centre. Others → NO_ZONE. Optional &#x60;?zone&#x3D;&#x60; (zone name). The response lists the layout &#x60;zones&#x60;. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60; (seat|ga), &#x60;status&#x60; (durable status or object status overlay), &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;forSale&#x60;, &#x60;channelKeyId&#x60;, &#x60;orderId&#x60;, &#x60;availability&#x60; (available|not_available) and &#x60;availabilityReason&#x60; (available|resale|booked|held|custom_status|not_for_sale). GA rows add &#x60;capacity&#x60;, &#x60;soldCount&#x60;, &#x60;heldCount&#x60;, &#x60;availableCount&#x60; and &#x60;places&#x60; (places per reason). Availability: custom object status → custom_status; sold → booked (resale overlay → resale, still available); durable or live hold → held; not for sale → not_for_sale. &#x60;liveHolds&#x60; tells whether active buyer holds were merged (false when skipped or Redis is unavailable). GA areas sold as a whole add &#x60;areaType&#x60; (&#x60;fixedOccupancy&#x60; | &#x60;variableOccupancy&#x60;), &#x60;bookAsAWhole: true&#x60; and, for variable occupancy, &#x60;minOccupancy&#x60; / &#x60;maxOccupancy&#x60;; their places are available all together or not at all (a partly withheld whole area is not_for_sale). The &#x60;.csv&#x60; variant returns the same data as RFC 4180 CSV (one line per object, or per group for summaries). Requires content_write (or a partner API key with the reports scope).
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :zone Only this zone bucket.
@@ -2468,11 +2883,741 @@ module SeatsChart
         fail ArgumentError, "invalid value for \"live_holds\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/events/{eventId}/reports/by-zone.json'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+      local_var_path = '/api/events/{eventId}/reports/by-zone.json'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'zone'] = opts[:'zone'] if !opts[:'zone'].nil?
+      query_params[:'liveHolds'] = opts[:'live_holds'] if !opts[:'live_holds'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"EventsApi.get_api_events_by_event_id_reports_by_zone_json",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_reports_by_zone_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Deep summary report by availability
+    # seats.io deep summary by availability: the buckets of the summary by availability, each with `deep` — one full summary bucket per section (named in `deepBy`). Each bucket: `count` (places — 1 per seat, capacity per GA area), `objects`, `seats`, `gaPlaces`, and nested `byStatus`, `byAvailability`, `byAvailabilityReason`, `byCategory`, `bySection`, `byZone`, `byChannel`, `byObjectType`. GA areas are split by place, so one area can contribute to several availability buckets. `totals` sums every bucket. Missing keys use NO_CATEGORY / NO_SECTION / NO_ZONE / NO_CHANNEL. Requires content_write (or a partner API key with the reports scope).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
+    # @return [nil]
+    def get_api_events_by_event_id_reports_deep_summary_by_availability_json(event_id, opts = {})
+      get_api_events_by_event_id_reports_deep_summary_by_availability_json_with_http_info(event_id, opts)
+      nil
+    end
+
+    # Deep summary report by availability
+    # seats.io deep summary by availability: the buckets of the summary by availability, each with &#x60;deep&#x60; — one full summary bucket per section (named in &#x60;deepBy&#x60;). Each bucket: &#x60;count&#x60; (places — 1 per seat, capacity per GA area), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, and nested &#x60;byStatus&#x60;, &#x60;byAvailability&#x60;, &#x60;byAvailabilityReason&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byChannel&#x60;, &#x60;byObjectType&#x60;. GA areas are split by place, so one area can contribute to several availability buckets. &#x60;totals&#x60; sums every bucket. Missing keys use NO_CATEGORY / NO_SECTION / NO_ZONE / NO_CHANNEL. Requires content_write (or a partner API key with the reports scope).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_events_by_event_id_reports_deep_summary_by_availability_json_with_http_info(event_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EventsApi.get_api_events_by_event_id_reports_deep_summary_by_availability_json ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_deep_summary_by_availability_json"
+      end
+      pattern = Regexp.new(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/)
+      if @api_client.config.client_side_validation && event_id !~ pattern
+        fail ArgumentError, "invalid value for 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_deep_summary_by_availability_json, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["true", "false"]
+      if @api_client.config.client_side_validation && opts[:'live_holds'] && !allowable_values.include?(opts[:'live_holds'])
+        fail ArgumentError, "invalid value for \"live_holds\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/events/{eventId}/reports/deep-summary/by-availability.json'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'liveHolds'] = opts[:'live_holds'] if !opts[:'live_holds'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"EventsApi.get_api_events_by_event_id_reports_deep_summary_by_availability_json",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_reports_deep_summary_by_availability_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Deep summary report by availability reason
+    # seats.io deep summary by availabilityReason: the buckets of the summary by availabilityReason, each with `deep` — one full summary bucket per section (named in `deepBy`). Each bucket: `count` (places — 1 per seat, capacity per GA area), `objects`, `seats`, `gaPlaces`, and nested `byStatus`, `byAvailability`, `byAvailabilityReason`, `byCategory`, `bySection`, `byZone`, `byChannel`, `byObjectType`. GA areas are split by place, so one area can contribute to several availability buckets. `totals` sums every bucket. Missing keys use NO_CATEGORY / NO_SECTION / NO_ZONE / NO_CHANNEL. Requires content_write (or a partner API key with the reports scope).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
+    # @return [nil]
+    def get_api_events_by_event_id_reports_deep_summary_by_availability_reason_json(event_id, opts = {})
+      get_api_events_by_event_id_reports_deep_summary_by_availability_reason_json_with_http_info(event_id, opts)
+      nil
+    end
+
+    # Deep summary report by availability reason
+    # seats.io deep summary by availabilityReason: the buckets of the summary by availabilityReason, each with &#x60;deep&#x60; — one full summary bucket per section (named in &#x60;deepBy&#x60;). Each bucket: &#x60;count&#x60; (places — 1 per seat, capacity per GA area), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, and nested &#x60;byStatus&#x60;, &#x60;byAvailability&#x60;, &#x60;byAvailabilityReason&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byChannel&#x60;, &#x60;byObjectType&#x60;. GA areas are split by place, so one area can contribute to several availability buckets. &#x60;totals&#x60; sums every bucket. Missing keys use NO_CATEGORY / NO_SECTION / NO_ZONE / NO_CHANNEL. Requires content_write (or a partner API key with the reports scope).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_events_by_event_id_reports_deep_summary_by_availability_reason_json_with_http_info(event_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EventsApi.get_api_events_by_event_id_reports_deep_summary_by_availability_reason_json ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_deep_summary_by_availability_reason_json"
+      end
+      pattern = Regexp.new(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/)
+      if @api_client.config.client_side_validation && event_id !~ pattern
+        fail ArgumentError, "invalid value for 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_deep_summary_by_availability_reason_json, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["true", "false"]
+      if @api_client.config.client_side_validation && opts[:'live_holds'] && !allowable_values.include?(opts[:'live_holds'])
+        fail ArgumentError, "invalid value for \"live_holds\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/events/{eventId}/reports/deep-summary/by-availability-reason.json'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'liveHolds'] = opts[:'live_holds'] if !opts[:'live_holds'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"EventsApi.get_api_events_by_event_id_reports_deep_summary_by_availability_reason_json",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_reports_deep_summary_by_availability_reason_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Deep summary report by category
+    # seats.io deep summary by category: the buckets of the summary by category, each with `deep` — one full summary bucket per section (named in `deepBy`). Each bucket: `count` (places — 1 per seat, capacity per GA area), `objects`, `seats`, `gaPlaces`, and nested `byStatus`, `byAvailability`, `byAvailabilityReason`, `byCategory`, `bySection`, `byZone`, `byChannel`, `byObjectType`. GA areas are split by place, so one area can contribute to several availability buckets. `totals` sums every bucket. Missing keys use NO_CATEGORY / NO_SECTION / NO_ZONE / NO_CHANNEL. Requires content_write (or a partner API key with the reports scope).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
+    # @return [nil]
+    def get_api_events_by_event_id_reports_deep_summary_by_category_json(event_id, opts = {})
+      get_api_events_by_event_id_reports_deep_summary_by_category_json_with_http_info(event_id, opts)
+      nil
+    end
+
+    # Deep summary report by category
+    # seats.io deep summary by category: the buckets of the summary by category, each with &#x60;deep&#x60; — one full summary bucket per section (named in &#x60;deepBy&#x60;). Each bucket: &#x60;count&#x60; (places — 1 per seat, capacity per GA area), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, and nested &#x60;byStatus&#x60;, &#x60;byAvailability&#x60;, &#x60;byAvailabilityReason&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byChannel&#x60;, &#x60;byObjectType&#x60;. GA areas are split by place, so one area can contribute to several availability buckets. &#x60;totals&#x60; sums every bucket. Missing keys use NO_CATEGORY / NO_SECTION / NO_ZONE / NO_CHANNEL. Requires content_write (or a partner API key with the reports scope).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_events_by_event_id_reports_deep_summary_by_category_json_with_http_info(event_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EventsApi.get_api_events_by_event_id_reports_deep_summary_by_category_json ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_deep_summary_by_category_json"
+      end
+      pattern = Regexp.new(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/)
+      if @api_client.config.client_side_validation && event_id !~ pattern
+        fail ArgumentError, "invalid value for 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_deep_summary_by_category_json, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["true", "false"]
+      if @api_client.config.client_side_validation && opts[:'live_holds'] && !allowable_values.include?(opts[:'live_holds'])
+        fail ArgumentError, "invalid value for \"live_holds\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/events/{eventId}/reports/deep-summary/by-category.json'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'liveHolds'] = opts[:'live_holds'] if !opts[:'live_holds'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"EventsApi.get_api_events_by_event_id_reports_deep_summary_by_category_json",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_reports_deep_summary_by_category_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Deep summary report by category key
+    # seats.io deep summary by categoryKey: the buckets of the summary by categoryKey, each with `deep` — one full summary bucket per section (named in `deepBy`). Each bucket: `count` (places — 1 per seat, capacity per GA area), `objects`, `seats`, `gaPlaces`, and nested `byStatus`, `byAvailability`, `byAvailabilityReason`, `byCategory`, `bySection`, `byZone`, `byChannel`, `byObjectType`. GA areas are split by place, so one area can contribute to several availability buckets. `totals` sums every bucket. Missing keys use NO_CATEGORY / NO_SECTION / NO_ZONE / NO_CHANNEL. Requires content_write (or a partner API key with the reports scope).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
+    # @return [nil]
+    def get_api_events_by_event_id_reports_deep_summary_by_category_key_json(event_id, opts = {})
+      get_api_events_by_event_id_reports_deep_summary_by_category_key_json_with_http_info(event_id, opts)
+      nil
+    end
+
+    # Deep summary report by category key
+    # seats.io deep summary by categoryKey: the buckets of the summary by categoryKey, each with &#x60;deep&#x60; — one full summary bucket per section (named in &#x60;deepBy&#x60;). Each bucket: &#x60;count&#x60; (places — 1 per seat, capacity per GA area), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, and nested &#x60;byStatus&#x60;, &#x60;byAvailability&#x60;, &#x60;byAvailabilityReason&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byChannel&#x60;, &#x60;byObjectType&#x60;. GA areas are split by place, so one area can contribute to several availability buckets. &#x60;totals&#x60; sums every bucket. Missing keys use NO_CATEGORY / NO_SECTION / NO_ZONE / NO_CHANNEL. Requires content_write (or a partner API key with the reports scope).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_events_by_event_id_reports_deep_summary_by_category_key_json_with_http_info(event_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EventsApi.get_api_events_by_event_id_reports_deep_summary_by_category_key_json ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_deep_summary_by_category_key_json"
+      end
+      pattern = Regexp.new(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/)
+      if @api_client.config.client_side_validation && event_id !~ pattern
+        fail ArgumentError, "invalid value for 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_deep_summary_by_category_key_json, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["true", "false"]
+      if @api_client.config.client_side_validation && opts[:'live_holds'] && !allowable_values.include?(opts[:'live_holds'])
+        fail ArgumentError, "invalid value for \"live_holds\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/events/{eventId}/reports/deep-summary/by-category-key.json'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'liveHolds'] = opts[:'live_holds'] if !opts[:'live_holds'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"EventsApi.get_api_events_by_event_id_reports_deep_summary_by_category_key_json",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_reports_deep_summary_by_category_key_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Deep summary report by category label
+    # seats.io deep summary by categoryLabel: the buckets of the summary by categoryLabel, each with `deep` — one full summary bucket per section (named in `deepBy`). Each bucket: `count` (places — 1 per seat, capacity per GA area), `objects`, `seats`, `gaPlaces`, and nested `byStatus`, `byAvailability`, `byAvailabilityReason`, `byCategory`, `bySection`, `byZone`, `byChannel`, `byObjectType`. GA areas are split by place, so one area can contribute to several availability buckets. `totals` sums every bucket. Missing keys use NO_CATEGORY / NO_SECTION / NO_ZONE / NO_CHANNEL. Requires content_write (or a partner API key with the reports scope).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
+    # @return [nil]
+    def get_api_events_by_event_id_reports_deep_summary_by_category_label_json(event_id, opts = {})
+      get_api_events_by_event_id_reports_deep_summary_by_category_label_json_with_http_info(event_id, opts)
+      nil
+    end
+
+    # Deep summary report by category label
+    # seats.io deep summary by categoryLabel: the buckets of the summary by categoryLabel, each with &#x60;deep&#x60; — one full summary bucket per section (named in &#x60;deepBy&#x60;). Each bucket: &#x60;count&#x60; (places — 1 per seat, capacity per GA area), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, and nested &#x60;byStatus&#x60;, &#x60;byAvailability&#x60;, &#x60;byAvailabilityReason&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byChannel&#x60;, &#x60;byObjectType&#x60;. GA areas are split by place, so one area can contribute to several availability buckets. &#x60;totals&#x60; sums every bucket. Missing keys use NO_CATEGORY / NO_SECTION / NO_ZONE / NO_CHANNEL. Requires content_write (or a partner API key with the reports scope).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_events_by_event_id_reports_deep_summary_by_category_label_json_with_http_info(event_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EventsApi.get_api_events_by_event_id_reports_deep_summary_by_category_label_json ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_deep_summary_by_category_label_json"
+      end
+      pattern = Regexp.new(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/)
+      if @api_client.config.client_side_validation && event_id !~ pattern
+        fail ArgumentError, "invalid value for 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_deep_summary_by_category_label_json, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["true", "false"]
+      if @api_client.config.client_side_validation && opts[:'live_holds'] && !allowable_values.include?(opts[:'live_holds'])
+        fail ArgumentError, "invalid value for \"live_holds\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/events/{eventId}/reports/deep-summary/by-category-label.json'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'liveHolds'] = opts[:'live_holds'] if !opts[:'live_holds'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"EventsApi.get_api_events_by_event_id_reports_deep_summary_by_category_label_json",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_reports_deep_summary_by_category_label_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Deep summary report by channel
+    # seats.io deep summary by channel: the buckets of the summary by channel, each with `deep` — one full summary bucket per section (named in `deepBy`). Each bucket: `count` (places — 1 per seat, capacity per GA area), `objects`, `seats`, `gaPlaces`, and nested `byStatus`, `byAvailability`, `byAvailabilityReason`, `byCategory`, `bySection`, `byZone`, `byChannel`, `byObjectType`. GA areas are split by place, so one area can contribute to several availability buckets. `totals` sums every bucket. Missing keys use NO_CATEGORY / NO_SECTION / NO_ZONE / NO_CHANNEL. Requires content_write (or a partner API key with the reports scope).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
+    # @return [nil]
+    def get_api_events_by_event_id_reports_deep_summary_by_channel_json(event_id, opts = {})
+      get_api_events_by_event_id_reports_deep_summary_by_channel_json_with_http_info(event_id, opts)
+      nil
+    end
+
+    # Deep summary report by channel
+    # seats.io deep summary by channel: the buckets of the summary by channel, each with &#x60;deep&#x60; — one full summary bucket per section (named in &#x60;deepBy&#x60;). Each bucket: &#x60;count&#x60; (places — 1 per seat, capacity per GA area), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, and nested &#x60;byStatus&#x60;, &#x60;byAvailability&#x60;, &#x60;byAvailabilityReason&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byChannel&#x60;, &#x60;byObjectType&#x60;. GA areas are split by place, so one area can contribute to several availability buckets. &#x60;totals&#x60; sums every bucket. Missing keys use NO_CATEGORY / NO_SECTION / NO_ZONE / NO_CHANNEL. Requires content_write (or a partner API key with the reports scope).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_events_by_event_id_reports_deep_summary_by_channel_json_with_http_info(event_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EventsApi.get_api_events_by_event_id_reports_deep_summary_by_channel_json ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_deep_summary_by_channel_json"
+      end
+      pattern = Regexp.new(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/)
+      if @api_client.config.client_side_validation && event_id !~ pattern
+        fail ArgumentError, "invalid value for 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_deep_summary_by_channel_json, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["true", "false"]
+      if @api_client.config.client_side_validation && opts[:'live_holds'] && !allowable_values.include?(opts[:'live_holds'])
+        fail ArgumentError, "invalid value for \"live_holds\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/events/{eventId}/reports/deep-summary/by-channel.json'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'liveHolds'] = opts[:'live_holds'] if !opts[:'live_holds'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"EventsApi.get_api_events_by_event_id_reports_deep_summary_by_channel_json",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_reports_deep_summary_by_channel_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Deep summary report by object type
+    # seats.io deep summary by objectType: the buckets of the summary by objectType, each with `deep` — one full summary bucket per section (named in `deepBy`). Each bucket: `count` (places — 1 per seat, capacity per GA area), `objects`, `seats`, `gaPlaces`, and nested `byStatus`, `byAvailability`, `byAvailabilityReason`, `byCategory`, `bySection`, `byZone`, `byChannel`, `byObjectType`. GA areas are split by place, so one area can contribute to several availability buckets. `totals` sums every bucket. Missing keys use NO_CATEGORY / NO_SECTION / NO_ZONE / NO_CHANNEL. Requires content_write (or a partner API key with the reports scope).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
+    # @return [nil]
+    def get_api_events_by_event_id_reports_deep_summary_by_object_type_json(event_id, opts = {})
+      get_api_events_by_event_id_reports_deep_summary_by_object_type_json_with_http_info(event_id, opts)
+      nil
+    end
+
+    # Deep summary report by object type
+    # seats.io deep summary by objectType: the buckets of the summary by objectType, each with &#x60;deep&#x60; — one full summary bucket per section (named in &#x60;deepBy&#x60;). Each bucket: &#x60;count&#x60; (places — 1 per seat, capacity per GA area), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, and nested &#x60;byStatus&#x60;, &#x60;byAvailability&#x60;, &#x60;byAvailabilityReason&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byChannel&#x60;, &#x60;byObjectType&#x60;. GA areas are split by place, so one area can contribute to several availability buckets. &#x60;totals&#x60; sums every bucket. Missing keys use NO_CATEGORY / NO_SECTION / NO_ZONE / NO_CHANNEL. Requires content_write (or a partner API key with the reports scope).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_events_by_event_id_reports_deep_summary_by_object_type_json_with_http_info(event_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EventsApi.get_api_events_by_event_id_reports_deep_summary_by_object_type_json ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_deep_summary_by_object_type_json"
+      end
+      pattern = Regexp.new(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/)
+      if @api_client.config.client_side_validation && event_id !~ pattern
+        fail ArgumentError, "invalid value for 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_deep_summary_by_object_type_json, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["true", "false"]
+      if @api_client.config.client_side_validation && opts[:'live_holds'] && !allowable_values.include?(opts[:'live_holds'])
+        fail ArgumentError, "invalid value for \"live_holds\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/events/{eventId}/reports/deep-summary/by-object-type.json'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'liveHolds'] = opts[:'live_holds'] if !opts[:'live_holds'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"EventsApi.get_api_events_by_event_id_reports_deep_summary_by_object_type_json",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_reports_deep_summary_by_object_type_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Deep summary report by section
+    # seats.io deep summary by section: the buckets of the summary by section, each with `deep` — one full summary bucket per status (named in `deepBy`). Each bucket: `count` (places — 1 per seat, capacity per GA area), `objects`, `seats`, `gaPlaces`, and nested `byStatus`, `byAvailability`, `byAvailabilityReason`, `byCategory`, `bySection`, `byZone`, `byChannel`, `byObjectType`. GA areas are split by place, so one area can contribute to several availability buckets. `totals` sums every bucket. Missing keys use NO_CATEGORY / NO_SECTION / NO_ZONE / NO_CHANNEL. Requires content_write (or a partner API key with the reports scope).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
+    # @return [nil]
+    def get_api_events_by_event_id_reports_deep_summary_by_section_json(event_id, opts = {})
+      get_api_events_by_event_id_reports_deep_summary_by_section_json_with_http_info(event_id, opts)
+      nil
+    end
+
+    # Deep summary report by section
+    # seats.io deep summary by section: the buckets of the summary by section, each with &#x60;deep&#x60; — one full summary bucket per status (named in &#x60;deepBy&#x60;). Each bucket: &#x60;count&#x60; (places — 1 per seat, capacity per GA area), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, and nested &#x60;byStatus&#x60;, &#x60;byAvailability&#x60;, &#x60;byAvailabilityReason&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byChannel&#x60;, &#x60;byObjectType&#x60;. GA areas are split by place, so one area can contribute to several availability buckets. &#x60;totals&#x60; sums every bucket. Missing keys use NO_CATEGORY / NO_SECTION / NO_ZONE / NO_CHANNEL. Requires content_write (or a partner API key with the reports scope).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_events_by_event_id_reports_deep_summary_by_section_json_with_http_info(event_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EventsApi.get_api_events_by_event_id_reports_deep_summary_by_section_json ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_deep_summary_by_section_json"
+      end
+      pattern = Regexp.new(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/)
+      if @api_client.config.client_side_validation && event_id !~ pattern
+        fail ArgumentError, "invalid value for 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_deep_summary_by_section_json, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["true", "false"]
+      if @api_client.config.client_side_validation && opts[:'live_holds'] && !allowable_values.include?(opts[:'live_holds'])
+        fail ArgumentError, "invalid value for \"live_holds\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/events/{eventId}/reports/deep-summary/by-section.json'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'liveHolds'] = opts[:'live_holds'] if !opts[:'live_holds'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"EventsApi.get_api_events_by_event_id_reports_deep_summary_by_section_json",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_reports_deep_summary_by_section_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Deep summary report by status
+    # seats.io deep summary by status: the buckets of the summary by status, each with `deep` — one full summary bucket per section (named in `deepBy`). Each bucket: `count` (places — 1 per seat, capacity per GA area), `objects`, `seats`, `gaPlaces`, and nested `byStatus`, `byAvailability`, `byAvailabilityReason`, `byCategory`, `bySection`, `byZone`, `byChannel`, `byObjectType`. GA areas are split by place, so one area can contribute to several availability buckets. `totals` sums every bucket. Missing keys use NO_CATEGORY / NO_SECTION / NO_ZONE / NO_CHANNEL. Requires content_write (or a partner API key with the reports scope).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
+    # @return [nil]
+    def get_api_events_by_event_id_reports_deep_summary_by_status_json(event_id, opts = {})
+      get_api_events_by_event_id_reports_deep_summary_by_status_json_with_http_info(event_id, opts)
+      nil
+    end
+
+    # Deep summary report by status
+    # seats.io deep summary by status: the buckets of the summary by status, each with &#x60;deep&#x60; — one full summary bucket per section (named in &#x60;deepBy&#x60;). Each bucket: &#x60;count&#x60; (places — 1 per seat, capacity per GA area), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, and nested &#x60;byStatus&#x60;, &#x60;byAvailability&#x60;, &#x60;byAvailabilityReason&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byChannel&#x60;, &#x60;byObjectType&#x60;. GA areas are split by place, so one area can contribute to several availability buckets. &#x60;totals&#x60; sums every bucket. Missing keys use NO_CATEGORY / NO_SECTION / NO_ZONE / NO_CHANNEL. Requires content_write (or a partner API key with the reports scope).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_events_by_event_id_reports_deep_summary_by_status_json_with_http_info(event_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EventsApi.get_api_events_by_event_id_reports_deep_summary_by_status_json ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_deep_summary_by_status_json"
+      end
+      pattern = Regexp.new(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/)
+      if @api_client.config.client_side_validation && event_id !~ pattern
+        fail ArgumentError, "invalid value for 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_deep_summary_by_status_json, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["true", "false"]
+      if @api_client.config.client_side_validation && opts[:'live_holds'] && !allowable_values.include?(opts[:'live_holds'])
+        fail ArgumentError, "invalid value for \"live_holds\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/events/{eventId}/reports/deep-summary/by-status.json'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'liveHolds'] = opts[:'live_holds'] if !opts[:'live_holds'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"EventsApi.get_api_events_by_event_id_reports_deep_summary_by_status_json",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_reports_deep_summary_by_status_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Deep summary report by zone
+    # seats.io deep summary by zone: the buckets of the summary by zone, each with `deep` — one full summary bucket per section (named in `deepBy`). Each bucket: `count` (places — 1 per seat, capacity per GA area), `objects`, `seats`, `gaPlaces`, and nested `byStatus`, `byAvailability`, `byAvailabilityReason`, `byCategory`, `bySection`, `byZone`, `byChannel`, `byObjectType`. GA areas are split by place, so one area can contribute to several availability buckets. `totals` sums every bucket. Missing keys use NO_CATEGORY / NO_SECTION / NO_ZONE / NO_CHANNEL. Requires content_write (or a partner API key with the reports scope).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
+    # @return [nil]
+    def get_api_events_by_event_id_reports_deep_summary_by_zone_json(event_id, opts = {})
+      get_api_events_by_event_id_reports_deep_summary_by_zone_json_with_http_info(event_id, opts)
+      nil
+    end
+
+    # Deep summary report by zone
+    # seats.io deep summary by zone: the buckets of the summary by zone, each with &#x60;deep&#x60; — one full summary bucket per section (named in &#x60;deepBy&#x60;). Each bucket: &#x60;count&#x60; (places — 1 per seat, capacity per GA area), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, and nested &#x60;byStatus&#x60;, &#x60;byAvailability&#x60;, &#x60;byAvailabilityReason&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byChannel&#x60;, &#x60;byObjectType&#x60;. GA areas are split by place, so one area can contribute to several availability buckets. &#x60;totals&#x60; sums every bucket. Missing keys use NO_CATEGORY / NO_SECTION / NO_ZONE / NO_CHANNEL. Requires content_write (or a partner API key with the reports scope).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :live_holds Merge active buyer holds from the per-event hold index (default &#x60;true&#x60;). &#x60;false&#x60; &#x3D; Postgres only.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_events_by_event_id_reports_deep_summary_by_zone_json_with_http_info(event_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EventsApi.get_api_events_by_event_id_reports_deep_summary_by_zone_json ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_deep_summary_by_zone_json"
+      end
+      pattern = Regexp.new(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/)
+      if @api_client.config.client_side_validation && event_id !~ pattern
+        fail ArgumentError, "invalid value for 'event_id' when calling EventsApi.get_api_events_by_event_id_reports_deep_summary_by_zone_json, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["true", "false"]
+      if @api_client.config.client_side_validation && opts[:'live_holds'] && !allowable_values.include?(opts[:'live_holds'])
+        fail ArgumentError, "invalid value for \"live_holds\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/events/{eventId}/reports/deep-summary/by-zone.json'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
-      query_params[:'zone'] = opts[:'zone'] if !opts[:'zone'].nil?
       query_params[:'liveHolds'] = opts[:'live_holds'] if !opts[:'live_holds'].nil?
 
       # header parameters
@@ -2491,7 +3636,7 @@ module SeatsChart
       auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
 
       new_options = opts.merge(
-        :operation => :"EventsApi.get_api_events_by_event_id_reports_by_zone_json",
+        :operation => :"EventsApi.get_api_events_by_event_id_reports_deep_summary_by_zone_json",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -2502,7 +3647,7 @@ module SeatsChart
 
       data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_reports_by_zone_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: EventsApi#get_api_events_by_event_id_reports_deep_summary_by_zone_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
@@ -4435,7 +5580,7 @@ module SeatsChart
     end
 
     # List seats for an event
-    # Returns the seat map (`dbStatus` from Postgres, `visualStatus` merged with live Redis locks) only when the event belongs to the authenticated tenant. Cache-aside key `event:{tenantId}:{eventId}:map` skips the Postgres scan on hits (`X-Seat-Map-Cache: hit|miss`) and merges live TTL locks into each build. Builds are shared per (tenant, event, view, channel cohort) and reused while the inventory version is unchanged, for at most 1 s (`X-Seat-Map-Microcache: hit|shared|miss|bypass`). Responses carry a weak `ETag` (If-None-Match → 304) and are br/gzip-encoded when accepted. Optional header **`x-channel-key`** authorizes an inventory partition (not salesChannel); several comma-separated keys (max 16) authorize every listed channel (renderer `channelKeys`), on reads, holds and best available alike. Buyers receive a masked payload (no channelKeyId); restricted seats without a matching key are non-bookable. channelKey→id resolution uses Redis memo `event:…:channel-keys` (no PG on cache hit when memo is warm). Optional `resalePriceCents` is merged at cache build from the overlay table — the seats SELECT list is unchanged.
+    # Returns the seat map (`dbStatus` from Postgres, `visualStatus` merged with live Redis locks) only when the event belongs to the authenticated tenant. Cache-aside key `event:{tenantId}:{eventId}:map` skips the Postgres scan on hits (`X-Seat-Map-Cache: hit|miss`) and merges live TTL locks into each build. Builds are shared per (tenant, event, view, channel cohort) and reused while the inventory version is unchanged, for at most 1 s (`X-Seat-Map-Microcache: hit|shared|miss|bypass`). Responses carry a weak `ETag` (If-None-Match → 304) and are br/gzip-encoded when accepted. Optional header **`x-channel-key`** authorizes an inventory partition (not salesChannel); several comma-separated keys (max 16) authorize every listed channel (renderer `channelKeys`), on reads, holds and best available alike. Buyers receive a masked payload (no channelKeyId); restricted seats without a matching key are non-bookable. channelKey→id resolution uses Redis memo `event:…:channel-keys` (no PG on cache hit when memo is warm). Optional `resalePriceCents` is merged at cache build from the overlay table — the seats SELECT list is unchanged. `forSale` is the effective flag, the same one holds, confirmations and the viewer state use: a seat that is not for sale on its own but is in an active resale listing of a season member whose for-sale configuration does not follow the season (`forSalePropagated: false`) is reported with `forSale: true` and the additive marker `forSaleViaResale: true` (absent on every other seat). Both are decided at cache build from the event row and the cached listing context (no extra query on cache hits); listing and season for-sale changes invalidate the cached map.
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -4445,7 +5590,7 @@ module SeatsChart
     end
 
     # List seats for an event
-    # Returns the seat map (&#x60;dbStatus&#x60; from Postgres, &#x60;visualStatus&#x60; merged with live Redis locks) only when the event belongs to the authenticated tenant. Cache-aside key &#x60;event:{tenantId}:{eventId}:map&#x60; skips the Postgres scan on hits (&#x60;X-Seat-Map-Cache: hit|miss&#x60;) and merges live TTL locks into each build. Builds are shared per (tenant, event, view, channel cohort) and reused while the inventory version is unchanged, for at most 1 s (&#x60;X-Seat-Map-Microcache: hit|shared|miss|bypass&#x60;). Responses carry a weak &#x60;ETag&#x60; (If-None-Match → 304) and are br/gzip-encoded when accepted. Optional header **&#x60;x-channel-key&#x60;** authorizes an inventory partition (not salesChannel); several comma-separated keys (max 16) authorize every listed channel (renderer &#x60;channelKeys&#x60;), on reads, holds and best available alike. Buyers receive a masked payload (no channelKeyId); restricted seats without a matching key are non-bookable. channelKey→id resolution uses Redis memo &#x60;event:…:channel-keys&#x60; (no PG on cache hit when memo is warm). Optional &#x60;resalePriceCents&#x60; is merged at cache build from the overlay table — the seats SELECT list is unchanged.
+    # Returns the seat map (&#x60;dbStatus&#x60; from Postgres, &#x60;visualStatus&#x60; merged with live Redis locks) only when the event belongs to the authenticated tenant. Cache-aside key &#x60;event:{tenantId}:{eventId}:map&#x60; skips the Postgres scan on hits (&#x60;X-Seat-Map-Cache: hit|miss&#x60;) and merges live TTL locks into each build. Builds are shared per (tenant, event, view, channel cohort) and reused while the inventory version is unchanged, for at most 1 s (&#x60;X-Seat-Map-Microcache: hit|shared|miss|bypass&#x60;). Responses carry a weak &#x60;ETag&#x60; (If-None-Match → 304) and are br/gzip-encoded when accepted. Optional header **&#x60;x-channel-key&#x60;** authorizes an inventory partition (not salesChannel); several comma-separated keys (max 16) authorize every listed channel (renderer &#x60;channelKeys&#x60;), on reads, holds and best available alike. Buyers receive a masked payload (no channelKeyId); restricted seats without a matching key are non-bookable. channelKey→id resolution uses Redis memo &#x60;event:…:channel-keys&#x60; (no PG on cache hit when memo is warm). Optional &#x60;resalePriceCents&#x60; is merged at cache build from the overlay table — the seats SELECT list is unchanged. &#x60;forSale&#x60; is the effective flag, the same one holds, confirmations and the viewer state use: a seat that is not for sale on its own but is in an active resale listing of a season member whose for-sale configuration does not follow the season (&#x60;forSalePropagated: false&#x60;) is reported with &#x60;forSale: true&#x60; and the additive marker &#x60;forSaleViaResale: true&#x60; (absent on every other seat). Both are decided at cache build from the event row and the cached listing context (no extra query on cache hits); listing and season for-sale changes invalidate the cached map.
     # @param event_id [String] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
@@ -4786,7 +5931,7 @@ module SeatsChart
     end
 
     # Patch event: name, date, currency, overrides (isInThePast is irreversible)
-    # All fields optional. `date` is an ISO-8601 timestamp. `tableBookingConfig` overrides the chart table booking mode for this event only (`all_by_seat`, `all_by_table`, or `custom` with `tables: { tableId: by_seat | by_table }`); seat-to-table membership stays from the chart. `null` clears the override. Applied by reserve and in the published commercial layout. `categoryOverrides` **replaces** the per-event override map (keys = seat/GA `category` values; `null` clears all): `priceCents` sets the base price of every seat in the category (clearing it restores the chart price by seat label; ticket-type prices from the chart still take precedence), `tint` (#RRGGBB) recolors the category in this event's published geometry (republished atomically), `forSale: false` takes the category off sale (removing it puts it back on sale; retired seats stay off sale). `forSalePerCategory` (`{ category: boolean }`) toggles category availability without storing an override. Prices already accepted in orders never change. `key` sets, renames or clears (`null`) the event key (409 `event_key_taken`).  **Chart switch** (`chartId`): moves the event to another published, non-archived chart of the workspace in **one transaction** with the event row and every seat/GA row locked in the commercial lock order. Seats are matched by `label`, GA areas by `name`: matched objects keep their ids (so holds, sales, orders and status history stay valid) and take the new geometry and category; sold/held/pending seats keep their price, other seats take the new chart price (or the category override). Unmatched objects without commercial state are removed, new chart objects are added (closed categories start not for sale), the event map draft is discarded and the geometry is republished atomically. Refused with **409 `chart_switch_conflict`** and nothing changed when a sold, held, pending or historical object has no counterpart, or a GA area would have less capacity than sold + held + withheld places: `objects: [{ objectId, label, objectType, reason: sold|held|pending|history|capacity, required?, capacity? }]`. Other refusals: 404 (chart), 409 `chart_not_published`, `chart_archived`, `season_chart_mismatch`. Emits `event.updated` with `changed_fields`.  **Event categories** (seats.io event `categories` / `objectCategories`): `categories` **replaces** the event-only categories (`[{ key, label, color, accessible? }]`, max 128; keys and labels unique, and neither may reuse a chart category id or name: 400 `category_conflict`). They are added to this event's published layout categories (`{ id: key, name: label, tint, accessible }`), so the renderer, legend and filters show them. `objectCategories` **replaces** the object → category map (object label = seat label or GA area name; value = event category key, chart category id or chart category name; max 10000; unknown references: 400 `unknown_category` with `labels`). Assignments are resolved once, in this transaction: the objects' `category` becomes the category label (removing an assignment restores the previous category), reassigned seats take the price override of their new category (else the chart price) and close with a closed category, and the geometry is republished. Best available (`categories` filter), quotes, synced price tables (keyed by the label), sales rules, reports and the section aggregates of the renderer all see the event category. Events that use neither keep their geometry hash. Changes emit `event.categories_updated` (event log and admin webhook) and `event.updated` with `changed_fields` `categories` / `objectCategories`.  Response: `{ id, key, name, date, currency, isInThePast, chartId, categoryOverrides, tableBookingConfig, categories, objectCategories, forSaleUpdated?, chartSwitch?: { previousChartId, chartId, keptSeats, addedSeats, removedSeats, keptGaAreas, addedGaAreas, removedGaAreas } }`.
+    # All fields optional. `date` is an ISO-8601 timestamp. `tableBookingConfig` overrides the chart table booking mode for this event only (`all_by_seat`, `all_by_table`, or `custom` with `tables: { tableId: by_seat | by_table }`); seat-to-table membership stays from the chart. `null` clears the override. Applied by reserve and in the published commercial layout. `categoryOverrides` **replaces** the per-event override map (keys = seat/GA `category` values; `null` clears all): `priceCents` sets the base price of every seat in the category (clearing it restores the chart price by seat label; ticket-type prices from the chart still take precedence), `tint` (#RRGGBB) recolors the category in this event's published geometry (republished atomically), `forSale: false` takes the category off sale (removing it puts it back on sale; retired seats stay off sale). `forSalePerCategory` (`{ category: boolean }`) toggles category availability without storing an override. Prices already accepted in orders never change. `key` sets, renames or clears (`null`) the event key (409 `event_key_taken`).  **Chart switch** (`chartId`): moves the event to another published, non-archived chart of the workspace in **one transaction** with the event row and every seat/GA row locked in the commercial lock order. Seats are matched by `label`, GA areas by `name`: matched objects keep their ids (so holds, sales, orders and status history stay valid) and take the new geometry and category; sold/held/pending seats keep their price, other seats take the new chart price (or the category override). Unmatched objects without commercial state are removed, new chart objects are added (closed categories start not for sale), the event map draft is discarded and the geometry is republished atomically. Refused with **409 `chart_switch_conflict`** and nothing changed when a sold, held, pending or historical object has no counterpart, a GA area would have less capacity than sold + held + withheld places, or a GA area with sold or held places would change how it is sold (`occupancy`: regular / fixed / variable occupancy, or the capacity / minimum of a whole area): `objects: [{ objectId, label, objectType, reason: sold|held|pending|history|capacity|occupancy, required?, capacity? }]`. Other refusals: 404 (chart), 409 `chart_not_published`, `chart_archived`, `season_chart_mismatch`. Emits `event.updated` with `changed_fields`. A switch that removes objects of active listings is refused with 409 `listing_objects_removed` (`listings`: id, key, `removedObjects`) unless `withdrawAffectedListings: true` withdraws them in the same transaction (409 `listing_has_holds` while held); `chartSwitch.withdrawnListings` lists them.  **Event categories** (seats.io event `categories` / `objectCategories`): `categories` **replaces** the event-only categories (`[{ key, label, color, accessible? }]`, max 128; keys and labels unique, and neither may reuse a chart category id or name: 400 `category_conflict`). They are added to this event's published layout categories (`{ id: key, name: label, tint, accessible }`), so the renderer, legend and filters show them. `objectCategories` **replaces** the object → category map (object label = seat label or GA area name; value = event category key, chart category id or chart category name; max 10000; unknown references: 400 `unknown_category` with `labels`). Assignments are resolved once, in this transaction: the objects' `category` becomes the category label (removing an assignment restores the previous category), reassigned seats take the price override of their new category (else the chart price) and close with a closed category, and the geometry is republished. Best available (`categories` filter), quotes, synced price tables (keyed by the label), sales rules, reports and the section aggregates of the renderer all see the event category. Events that use neither keep their geometry hash. Changes emit `event.categories_updated` (event log and admin webhook) and `event.updated` with `changed_fields` `categories` / `objectCategories`.  Response: `{ id, key, name, date, currency, isInThePast, chartId, categoryOverrides, tableBookingConfig, categories, objectCategories, forSaleUpdated?, chartSwitch?: { previousChartId, chartId, keptSeats, addedSeats, removedSeats, keptGaAreas, addedGaAreas, removedGaAreas } }`.
     # @param event_id [String] 
     # @param patch_api_events_by_event_id_request [PatchApiEventsByEventIdRequest] 
     # @param [Hash] opts the optional parameters
@@ -4798,7 +5943,7 @@ module SeatsChart
     end
 
     # Patch event: name, date, currency, overrides (isInThePast is irreversible)
-    # All fields optional. &#x60;date&#x60; is an ISO-8601 timestamp. &#x60;tableBookingConfig&#x60; overrides the chart table booking mode for this event only (&#x60;all_by_seat&#x60;, &#x60;all_by_table&#x60;, or &#x60;custom&#x60; with &#x60;tables: { tableId: by_seat | by_table }&#x60;); seat-to-table membership stays from the chart. &#x60;null&#x60; clears the override. Applied by reserve and in the published commercial layout. &#x60;categoryOverrides&#x60; **replaces** the per-event override map (keys &#x3D; seat/GA &#x60;category&#x60; values; &#x60;null&#x60; clears all): &#x60;priceCents&#x60; sets the base price of every seat in the category (clearing it restores the chart price by seat label; ticket-type prices from the chart still take precedence), &#x60;tint&#x60; (#RRGGBB) recolors the category in this event&#39;s published geometry (republished atomically), &#x60;forSale: false&#x60; takes the category off sale (removing it puts it back on sale; retired seats stay off sale). &#x60;forSalePerCategory&#x60; (&#x60;{ category: boolean }&#x60;) toggles category availability without storing an override. Prices already accepted in orders never change. &#x60;key&#x60; sets, renames or clears (&#x60;null&#x60;) the event key (409 &#x60;event_key_taken&#x60;).  **Chart switch** (&#x60;chartId&#x60;): moves the event to another published, non-archived chart of the workspace in **one transaction** with the event row and every seat/GA row locked in the commercial lock order. Seats are matched by &#x60;label&#x60;, GA areas by &#x60;name&#x60;: matched objects keep their ids (so holds, sales, orders and status history stay valid) and take the new geometry and category; sold/held/pending seats keep their price, other seats take the new chart price (or the category override). Unmatched objects without commercial state are removed, new chart objects are added (closed categories start not for sale), the event map draft is discarded and the geometry is republished atomically. Refused with **409 &#x60;chart_switch_conflict&#x60;** and nothing changed when a sold, held, pending or historical object has no counterpart, or a GA area would have less capacity than sold + held + withheld places: &#x60;objects: [{ objectId, label, objectType, reason: sold|held|pending|history|capacity, required?, capacity? }]&#x60;. Other refusals: 404 (chart), 409 &#x60;chart_not_published&#x60;, &#x60;chart_archived&#x60;, &#x60;season_chart_mismatch&#x60;. Emits &#x60;event.updated&#x60; with &#x60;changed_fields&#x60;.  **Event categories** (seats.io event &#x60;categories&#x60; / &#x60;objectCategories&#x60;): &#x60;categories&#x60; **replaces** the event-only categories (&#x60;[{ key, label, color, accessible? }]&#x60;, max 128; keys and labels unique, and neither may reuse a chart category id or name: 400 &#x60;category_conflict&#x60;). They are added to this event&#39;s published layout categories (&#x60;{ id: key, name: label, tint, accessible }&#x60;), so the renderer, legend and filters show them. &#x60;objectCategories&#x60; **replaces** the object → category map (object label &#x3D; seat label or GA area name; value &#x3D; event category key, chart category id or chart category name; max 10000; unknown references: 400 &#x60;unknown_category&#x60; with &#x60;labels&#x60;). Assignments are resolved once, in this transaction: the objects&#39; &#x60;category&#x60; becomes the category label (removing an assignment restores the previous category), reassigned seats take the price override of their new category (else the chart price) and close with a closed category, and the geometry is republished. Best available (&#x60;categories&#x60; filter), quotes, synced price tables (keyed by the label), sales rules, reports and the section aggregates of the renderer all see the event category. Events that use neither keep their geometry hash. Changes emit &#x60;event.categories_updated&#x60; (event log and admin webhook) and &#x60;event.updated&#x60; with &#x60;changed_fields&#x60; &#x60;categories&#x60; / &#x60;objectCategories&#x60;.  Response: &#x60;{ id, key, name, date, currency, isInThePast, chartId, categoryOverrides, tableBookingConfig, categories, objectCategories, forSaleUpdated?, chartSwitch?: { previousChartId, chartId, keptSeats, addedSeats, removedSeats, keptGaAreas, addedGaAreas, removedGaAreas } }&#x60;.
+    # All fields optional. &#x60;date&#x60; is an ISO-8601 timestamp. &#x60;tableBookingConfig&#x60; overrides the chart table booking mode for this event only (&#x60;all_by_seat&#x60;, &#x60;all_by_table&#x60;, or &#x60;custom&#x60; with &#x60;tables: { tableId: by_seat | by_table }&#x60;); seat-to-table membership stays from the chart. &#x60;null&#x60; clears the override. Applied by reserve and in the published commercial layout. &#x60;categoryOverrides&#x60; **replaces** the per-event override map (keys &#x3D; seat/GA &#x60;category&#x60; values; &#x60;null&#x60; clears all): &#x60;priceCents&#x60; sets the base price of every seat in the category (clearing it restores the chart price by seat label; ticket-type prices from the chart still take precedence), &#x60;tint&#x60; (#RRGGBB) recolors the category in this event&#39;s published geometry (republished atomically), &#x60;forSale: false&#x60; takes the category off sale (removing it puts it back on sale; retired seats stay off sale). &#x60;forSalePerCategory&#x60; (&#x60;{ category: boolean }&#x60;) toggles category availability without storing an override. Prices already accepted in orders never change. &#x60;key&#x60; sets, renames or clears (&#x60;null&#x60;) the event key (409 &#x60;event_key_taken&#x60;).  **Chart switch** (&#x60;chartId&#x60;): moves the event to another published, non-archived chart of the workspace in **one transaction** with the event row and every seat/GA row locked in the commercial lock order. Seats are matched by &#x60;label&#x60;, GA areas by &#x60;name&#x60;: matched objects keep their ids (so holds, sales, orders and status history stay valid) and take the new geometry and category; sold/held/pending seats keep their price, other seats take the new chart price (or the category override). Unmatched objects without commercial state are removed, new chart objects are added (closed categories start not for sale), the event map draft is discarded and the geometry is republished atomically. Refused with **409 &#x60;chart_switch_conflict&#x60;** and nothing changed when a sold, held, pending or historical object has no counterpart, a GA area would have less capacity than sold + held + withheld places, or a GA area with sold or held places would change how it is sold (&#x60;occupancy&#x60;: regular / fixed / variable occupancy, or the capacity / minimum of a whole area): &#x60;objects: [{ objectId, label, objectType, reason: sold|held|pending|history|capacity|occupancy, required?, capacity? }]&#x60;. Other refusals: 404 (chart), 409 &#x60;chart_not_published&#x60;, &#x60;chart_archived&#x60;, &#x60;season_chart_mismatch&#x60;. Emits &#x60;event.updated&#x60; with &#x60;changed_fields&#x60;. A switch that removes objects of active listings is refused with 409 &#x60;listing_objects_removed&#x60; (&#x60;listings&#x60;: id, key, &#x60;removedObjects&#x60;) unless &#x60;withdrawAffectedListings: true&#x60; withdraws them in the same transaction (409 &#x60;listing_has_holds&#x60; while held); &#x60;chartSwitch.withdrawnListings&#x60; lists them.  **Event categories** (seats.io event &#x60;categories&#x60; / &#x60;objectCategories&#x60;): &#x60;categories&#x60; **replaces** the event-only categories (&#x60;[{ key, label, color, accessible? }]&#x60;, max 128; keys and labels unique, and neither may reuse a chart category id or name: 400 &#x60;category_conflict&#x60;). They are added to this event&#39;s published layout categories (&#x60;{ id: key, name: label, tint, accessible }&#x60;), so the renderer, legend and filters show them. &#x60;objectCategories&#x60; **replaces** the object → category map (object label &#x3D; seat label or GA area name; value &#x3D; event category key, chart category id or chart category name; max 10000; unknown references: 400 &#x60;unknown_category&#x60; with &#x60;labels&#x60;). Assignments are resolved once, in this transaction: the objects&#39; &#x60;category&#x60; becomes the category label (removing an assignment restores the previous category), reassigned seats take the price override of their new category (else the chart price) and close with a closed category, and the geometry is republished. Best available (&#x60;categories&#x60; filter), quotes, synced price tables (keyed by the label), sales rules, reports and the section aggregates of the renderer all see the event category. Events that use neither keep their geometry hash. Changes emit &#x60;event.categories_updated&#x60; (event log and admin webhook) and &#x60;event.updated&#x60; with &#x60;changed_fields&#x60; &#x60;categories&#x60; / &#x60;objectCategories&#x60;.  Response: &#x60;{ id, key, name, date, currency, isInThePast, chartId, categoryOverrides, tableBookingConfig, categories, objectCategories, forSaleUpdated?, chartSwitch?: { previousChartId, chartId, keptSeats, addedSeats, removedSeats, keptGaAreas, addedGaAreas, removedGaAreas } }&#x60;.
     # @param event_id [String] 
     # @param patch_api_events_by_event_id_request [PatchApiEventsByEventIdRequest] 
     # @param [Hash] opts the optional parameters
@@ -4982,7 +6127,7 @@ module SeatsChart
     end
 
     # Create event
-    # Creates a new event scoped to the workspace. Optional `chartId` clones the published chart seat/GA templates into event inventory. A chart whose published map has error-level validation issues (workspace severity, see `GET /api/workspace/chart-validation`) is refused with 409 `chart_invalid` `{ chartId, issues: [{ code, severity, count, message }] }`; fix the chart in the designer and publish again. Optional `key` (unique per workspace, URL-safe, not UUID-shaped) can be used instead of the id in every event route; 409 `event_key_taken`. Creation-time configuration is applied **in the creation transaction** (all or nothing): `tableBookingConfig` and `categoryOverrides` (same semantics as PATCH), `channels` (inventory channels with their objects and GA `areaPlaces`; each `channelKey` secret is returned once) and `forSaleConfig` (`forSale: false` = listed objects/categories not for sale and `areaPlaces` withheld; `forSale: true` = only the listed ones for sale). Objects are seat labels/UUIDs or GA area names/UUIDs; unknown ones return 400 `objects_not_found`. Optional `seasonId` attaches the event afterwards and syncs NFS + channelKey from the season source. Optional `currency` (ISO 4217, two-decimal) sets the catalog currency used by quotes and the viewer. Emits the `event.created` webhook.
+    # Creates a new event scoped to the workspace. Optional `chartId` clones the published chart seat/GA templates into event inventory. A chart whose published map has error-level validation issues (workspace severity, see `GET /api/workspace/chart-validation`) is refused with 409 `chart_invalid` `{ chartId, issues: [{ code, severity, count, message }] }`; fix the chart in the designer and publish again. Optional `key` (unique per workspace, URL-safe, not UUID-shaped) can be used instead of the id in every event route; 409 `event_key_taken`. Creation-time configuration is applied **in the creation transaction** (all or nothing): `categories` / `objectCategories` (seats.io event categories: event-only categories and object assignments, validated and materialized exactly as on PATCH /events/{eventId}, applied first so the other settings see them; 400 `category_conflict` / `unknown_category`), `tableBookingConfig` and `categoryOverrides` (same semantics as PATCH), `channels` (inventory channels with their objects and GA `areaPlaces`; each `channelKey` secret is returned once) and `forSaleConfig` (`forSale: false` = listed objects/categories not for sale and `areaPlaces` withheld; `forSale: true` = only the listed ones for sale; without it, the workspace setting `newEventsNotForSale` starts every object off sale). Objects are seat labels/UUIDs or GA area names/UUIDs; unknown ones return 400 `objects_not_found`. GA areas sold as a whole (fixed or variable occupancy) go on or off sale whole: for-sale `areaPlaces` on them, or a channel quota below their capacity, return 400 `ga_area_whole` `{ areas: [{ areaId, label, capacity }] }`. Optional `seasonId` attaches the event afterwards and syncs NFS + channelKey from the season source. Optional `currency` (ISO 4217, two-decimal) sets the catalog currency used by quotes and the viewer. Emits the `event.created` webhook.
     # @param post_api_events_request [PostApiEventsRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :idempotency_key Required on transactional routes. Reuse the same key for every retry of one logical operation; the API replays the stored outcome.
@@ -4993,7 +6138,7 @@ module SeatsChart
     end
 
     # Create event
-    # Creates a new event scoped to the workspace. Optional &#x60;chartId&#x60; clones the published chart seat/GA templates into event inventory. A chart whose published map has error-level validation issues (workspace severity, see &#x60;GET /api/workspace/chart-validation&#x60;) is refused with 409 &#x60;chart_invalid&#x60; &#x60;{ chartId, issues: [{ code, severity, count, message }] }&#x60;; fix the chart in the designer and publish again. Optional &#x60;key&#x60; (unique per workspace, URL-safe, not UUID-shaped) can be used instead of the id in every event route; 409 &#x60;event_key_taken&#x60;. Creation-time configuration is applied **in the creation transaction** (all or nothing): &#x60;tableBookingConfig&#x60; and &#x60;categoryOverrides&#x60; (same semantics as PATCH), &#x60;channels&#x60; (inventory channels with their objects and GA &#x60;areaPlaces&#x60;; each &#x60;channelKey&#x60; secret is returned once) and &#x60;forSaleConfig&#x60; (&#x60;forSale: false&#x60; &#x3D; listed objects/categories not for sale and &#x60;areaPlaces&#x60; withheld; &#x60;forSale: true&#x60; &#x3D; only the listed ones for sale). Objects are seat labels/UUIDs or GA area names/UUIDs; unknown ones return 400 &#x60;objects_not_found&#x60;. Optional &#x60;seasonId&#x60; attaches the event afterwards and syncs NFS + channelKey from the season source. Optional &#x60;currency&#x60; (ISO 4217, two-decimal) sets the catalog currency used by quotes and the viewer. Emits the &#x60;event.created&#x60; webhook.
+    # Creates a new event scoped to the workspace. Optional &#x60;chartId&#x60; clones the published chart seat/GA templates into event inventory. A chart whose published map has error-level validation issues (workspace severity, see &#x60;GET /api/workspace/chart-validation&#x60;) is refused with 409 &#x60;chart_invalid&#x60; &#x60;{ chartId, issues: [{ code, severity, count, message }] }&#x60;; fix the chart in the designer and publish again. Optional &#x60;key&#x60; (unique per workspace, URL-safe, not UUID-shaped) can be used instead of the id in every event route; 409 &#x60;event_key_taken&#x60;. Creation-time configuration is applied **in the creation transaction** (all or nothing): &#x60;categories&#x60; / &#x60;objectCategories&#x60; (seats.io event categories: event-only categories and object assignments, validated and materialized exactly as on PATCH /events/{eventId}, applied first so the other settings see them; 400 &#x60;category_conflict&#x60; / &#x60;unknown_category&#x60;), &#x60;tableBookingConfig&#x60; and &#x60;categoryOverrides&#x60; (same semantics as PATCH), &#x60;channels&#x60; (inventory channels with their objects and GA &#x60;areaPlaces&#x60;; each &#x60;channelKey&#x60; secret is returned once) and &#x60;forSaleConfig&#x60; (&#x60;forSale: false&#x60; &#x3D; listed objects/categories not for sale and &#x60;areaPlaces&#x60; withheld; &#x60;forSale: true&#x60; &#x3D; only the listed ones for sale; without it, the workspace setting &#x60;newEventsNotForSale&#x60; starts every object off sale). Objects are seat labels/UUIDs or GA area names/UUIDs; unknown ones return 400 &#x60;objects_not_found&#x60;. GA areas sold as a whole (fixed or variable occupancy) go on or off sale whole: for-sale &#x60;areaPlaces&#x60; on them, or a channel quota below their capacity, return 400 &#x60;ga_area_whole&#x60; &#x60;{ areas: [{ areaId, label, capacity }] }&#x60;. Optional &#x60;seasonId&#x60; attaches the event afterwards and syncs NFS + channelKey from the season source. Optional &#x60;currency&#x60; (ISO 4217, two-decimal) sets the catalog currency used by quotes and the viewer. Emits the &#x60;event.created&#x60; webhook.
     # @param post_api_events_request [PostApiEventsRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :idempotency_key Required on transactional routes. Reuse the same key for every retry of one logical operation; the API replays the stored outcome.
@@ -5058,6 +6203,83 @@ module SeatsChart
       return data, status_code, headers
     end
 
+    # Edit the for-sale configuration of several events (all or nothing)
+    # Seats.io `editForSaleConfigForEvents`: `events[]` (1–100, each event once, at most 20000 items overall) with `event` (UUID or key), `forSale`, `notForSale` and `cascadeSeason`, applied to every event in **one SQL transaction**: either every event changes or none does (events are locked in id order, so overlapping calls serialize). Per event: Incremental: only the listed objects, GA places and categories change, everything else keeps its state, and both lists are applied in **one SQL transaction** (all or nothing; the event row lock serializes it with the replace and mark-everything calls). Items are `{ object }` (seat UUID or label, GA area UUID or name), `{ object, quantity }` (GA places: `notForSale` withholds that many more places, checked under the GA row lock against sold and held places — 409 `insufficient_free_places`; `forSale` returns that many withheld places) or `{ category }`. An explicit object wins over its category; retired seats never go back on sale; sold seats stay sold (only their flag changes). The same object or category in both lists is 400 `for_sale_edit_conflict`; unknown objects 404 `objects_not_found`; a label that names several objects 409 `ambiguous_label`. After COMMIT the holds on objects that went off sale are released, the seat-map cache is invalidated once and `for_sale` realtime messages are published (GA place changes as GA updates); a confirmation racing the change never sells an object that went off sale (the SQL decision re-checks under the seat row lock). Audited as `inventory.for_sale.edit` (event log and `event.for_sale_changed` webhook, alias `event.for.sale.config.updated`). On a season member that is not the source, the membership's `forSalePropagated` becomes false, as with the other for-sale calls. Optional `Idempotency-Key`. Not rate limited per event (seats.io allows 10 calls per event and day in its RATE_LIMITED for-sale mode). Response `{ ok, results: [{ index, event, eventId, forSaleConfig, changedSeats, …, seasonCascade }], realtime }` in request order. On any refusal nothing is written and the status is that of the failing event, with its `index` and `event` in the body.
+    # @param post_api_events_actions_edit_for_sale_config_request [PostApiEventsActionsEditForSaleConfigRequest] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Optional. A replay with the same key and body returns the stored response (24 h); a different body under the same key is 409 &#x60;idempotency_conflict&#x60;.
+    # @return [nil]
+    def post_api_events_actions_edit_for_sale_config(post_api_events_actions_edit_for_sale_config_request, opts = {})
+      post_api_events_actions_edit_for_sale_config_with_http_info(post_api_events_actions_edit_for_sale_config_request, opts)
+      nil
+    end
+
+    # Edit the for-sale configuration of several events (all or nothing)
+    # Seats.io &#x60;editForSaleConfigForEvents&#x60;: &#x60;events[]&#x60; (1–100, each event once, at most 20000 items overall) with &#x60;event&#x60; (UUID or key), &#x60;forSale&#x60;, &#x60;notForSale&#x60; and &#x60;cascadeSeason&#x60;, applied to every event in **one SQL transaction**: either every event changes or none does (events are locked in id order, so overlapping calls serialize). Per event: Incremental: only the listed objects, GA places and categories change, everything else keeps its state, and both lists are applied in **one SQL transaction** (all or nothing; the event row lock serializes it with the replace and mark-everything calls). Items are &#x60;{ object }&#x60; (seat UUID or label, GA area UUID or name), &#x60;{ object, quantity }&#x60; (GA places: &#x60;notForSale&#x60; withholds that many more places, checked under the GA row lock against sold and held places — 409 &#x60;insufficient_free_places&#x60;; &#x60;forSale&#x60; returns that many withheld places) or &#x60;{ category }&#x60;. An explicit object wins over its category; retired seats never go back on sale; sold seats stay sold (only their flag changes). The same object or category in both lists is 400 &#x60;for_sale_edit_conflict&#x60;; unknown objects 404 &#x60;objects_not_found&#x60;; a label that names several objects 409 &#x60;ambiguous_label&#x60;. After COMMIT the holds on objects that went off sale are released, the seat-map cache is invalidated once and &#x60;for_sale&#x60; realtime messages are published (GA place changes as GA updates); a confirmation racing the change never sells an object that went off sale (the SQL decision re-checks under the seat row lock). Audited as &#x60;inventory.for_sale.edit&#x60; (event log and &#x60;event.for_sale_changed&#x60; webhook, alias &#x60;event.for.sale.config.updated&#x60;). On a season member that is not the source, the membership&#39;s &#x60;forSalePropagated&#x60; becomes false, as with the other for-sale calls. Optional &#x60;Idempotency-Key&#x60;. Not rate limited per event (seats.io allows 10 calls per event and day in its RATE_LIMITED for-sale mode). Response &#x60;{ ok, results: [{ index, event, eventId, forSaleConfig, changedSeats, …, seasonCascade }], realtime }&#x60; in request order. On any refusal nothing is written and the status is that of the failing event, with its &#x60;index&#x60; and &#x60;event&#x60; in the body.
+    # @param post_api_events_actions_edit_for_sale_config_request [PostApiEventsActionsEditForSaleConfigRequest] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Optional. A replay with the same key and body returns the stored response (24 h); a different body under the same key is 409 &#x60;idempotency_conflict&#x60;.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def post_api_events_actions_edit_for_sale_config_with_http_info(post_api_events_actions_edit_for_sale_config_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EventsApi.post_api_events_actions_edit_for_sale_config ...'
+      end
+      # verify the required parameter 'post_api_events_actions_edit_for_sale_config_request' is set
+      if @api_client.config.client_side_validation && post_api_events_actions_edit_for_sale_config_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_events_actions_edit_for_sale_config_request' when calling EventsApi.post_api_events_actions_edit_for_sale_config"
+      end
+      if @api_client.config.client_side_validation && !opts[:'idempotency_key'].nil? && opts[:'idempotency_key'].to_s.length > 255
+        fail ArgumentError, 'invalid value for "opts[:"idempotency_key"]" when calling EventsApi.post_api_events_actions_edit_for_sale_config, the character length must be smaller than or equal to 255.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'idempotency_key'].nil? && opts[:'idempotency_key'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"idempotency_key"]" when calling EventsApi.post_api_events_actions_edit_for_sale_config, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/events/actions/edit-for-sale-config'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json', 'multipart/form-data', 'text/plain'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'idempotency-key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(post_api_events_actions_edit_for_sale_config_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"EventsApi.post_api_events_actions_edit_for_sale_config",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EventsApi#post_api_events_actions_edit_for_sale_config\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Create up to 50 events for one chart
     # Creates every event (with its cloned seat/GA inventory and published geometry) in **one transaction**: either all events exist afterwards or none. The plan event limit is checked for the whole batch (402). Optional `seasonId` attaches each created event afterwards (like POST /events); `seasonId: null` in an item means that attachment failed. A chart with error-level validation issues is refused with 409 `chart_invalid` (`issues`, `index`) and nothing is created. Every item accepts the creation-time configuration of POST /events (`key`, `tableBookingConfig`, `categoryOverrides`, `channels`, `forSaleConfig`), applied in the same transaction; a rejected item returns its error with `index` and nothing is created. Keys must be unique in the batch and the workspace (409 `event_key_taken`). Emits one `event.created` webhook for the batch. Response `{ events: [{ id, key, name, date, chartId, clonedSeats, clonedGaAreas, seasonId, categoryOverrides, tableBookingConfig, channels, forSale }] }`.
     # @param post_api_events_bulk_request [PostApiEventsBulkRequest] 
@@ -5135,6 +6357,255 @@ module SeatsChart
       return data, status_code, headers
     end
 
+    # Edit the for-sale configuration (forSale and notForSale in one transaction)
+    # Seats.io `editForSaleConfig`. Incremental: only the listed objects, GA places and categories change, everything else keeps its state, and both lists are applied in **one SQL transaction** (all or nothing; the event row lock serializes it with the replace and mark-everything calls). Items are `{ object }` (seat UUID or label, GA area UUID or name), `{ object, quantity }` (GA places: `notForSale` withholds that many more places, checked under the GA row lock against sold and held places — 409 `insufficient_free_places`; `forSale` returns that many withheld places) or `{ category }`. An explicit object wins over its category; retired seats never go back on sale; sold seats stay sold (only their flag changes). The same object or category in both lists is 400 `for_sale_edit_conflict`; unknown objects 404 `objects_not_found`; a label that names several objects 409 `ambiguous_label`. After COMMIT the holds on objects that went off sale are released, the seat-map cache is invalidated once and `for_sale` realtime messages are published (GA place changes as GA updates); a confirmation racing the change never sells an object that went off sale (the SQL decision re-checks under the seat row lock). Audited as `inventory.for_sale.edit` (event log and `event.for_sale_changed` webhook, alias `event.for.sale.config.updated`). On a season member that is not the source, the membership's `forSalePropagated` becomes false, as with the other for-sale calls. Optional `Idempotency-Key`. Not rate limited per event (seats.io allows 10 calls per event and day in its RATE_LIMITED for-sale mode). Response: `forSaleConfig` (the resulting configuration as seats.io returns it: `forSale: false`, `objects` (labels of the seats and names of the GA areas that are off sale), `categories` (categories whose every object is off sale; their objects are not repeated in `objects`) and `areaPlaces` (GA area name → withheld places of an area on sale)), `changedSeats`, `changedGaAreas`, `seatsNotForSale`, `gaAreasNotForSale`, `notForSalePlaces` (GA area id → withheld places of the areas changed by quantity), `releasedSeatHolds`, `clearedGaHoldAreas`, `seasonCascade`, `forSalePropagated` (false when this call detached a season member) and `realtime`.
+    # @param event_id [String] 
+    # @param post_api_events_by_event_id_actions_edit_for_sale_config_request [PostApiEventsByEventIdActionsEditForSaleConfigRequest] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Optional. A replay with the same key and body returns the stored response (24 h); a different body under the same key is 409 &#x60;idempotency_conflict&#x60;.
+    # @return [nil]
+    def post_api_events_by_event_id_actions_edit_for_sale_config(event_id, post_api_events_by_event_id_actions_edit_for_sale_config_request, opts = {})
+      post_api_events_by_event_id_actions_edit_for_sale_config_with_http_info(event_id, post_api_events_by_event_id_actions_edit_for_sale_config_request, opts)
+      nil
+    end
+
+    # Edit the for-sale configuration (forSale and notForSale in one transaction)
+    # Seats.io &#x60;editForSaleConfig&#x60;. Incremental: only the listed objects, GA places and categories change, everything else keeps its state, and both lists are applied in **one SQL transaction** (all or nothing; the event row lock serializes it with the replace and mark-everything calls). Items are &#x60;{ object }&#x60; (seat UUID or label, GA area UUID or name), &#x60;{ object, quantity }&#x60; (GA places: &#x60;notForSale&#x60; withholds that many more places, checked under the GA row lock against sold and held places — 409 &#x60;insufficient_free_places&#x60;; &#x60;forSale&#x60; returns that many withheld places) or &#x60;{ category }&#x60;. An explicit object wins over its category; retired seats never go back on sale; sold seats stay sold (only their flag changes). The same object or category in both lists is 400 &#x60;for_sale_edit_conflict&#x60;; unknown objects 404 &#x60;objects_not_found&#x60;; a label that names several objects 409 &#x60;ambiguous_label&#x60;. After COMMIT the holds on objects that went off sale are released, the seat-map cache is invalidated once and &#x60;for_sale&#x60; realtime messages are published (GA place changes as GA updates); a confirmation racing the change never sells an object that went off sale (the SQL decision re-checks under the seat row lock). Audited as &#x60;inventory.for_sale.edit&#x60; (event log and &#x60;event.for_sale_changed&#x60; webhook, alias &#x60;event.for.sale.config.updated&#x60;). On a season member that is not the source, the membership&#39;s &#x60;forSalePropagated&#x60; becomes false, as with the other for-sale calls. Optional &#x60;Idempotency-Key&#x60;. Not rate limited per event (seats.io allows 10 calls per event and day in its RATE_LIMITED for-sale mode). Response: &#x60;forSaleConfig&#x60; (the resulting configuration as seats.io returns it: &#x60;forSale: false&#x60;, &#x60;objects&#x60; (labels of the seats and names of the GA areas that are off sale), &#x60;categories&#x60; (categories whose every object is off sale; their objects are not repeated in &#x60;objects&#x60;) and &#x60;areaPlaces&#x60; (GA area name → withheld places of an area on sale)), &#x60;changedSeats&#x60;, &#x60;changedGaAreas&#x60;, &#x60;seatsNotForSale&#x60;, &#x60;gaAreasNotForSale&#x60;, &#x60;notForSalePlaces&#x60; (GA area id → withheld places of the areas changed by quantity), &#x60;releasedSeatHolds&#x60;, &#x60;clearedGaHoldAreas&#x60;, &#x60;seasonCascade&#x60;, &#x60;forSalePropagated&#x60; (false when this call detached a season member) and &#x60;realtime&#x60;.
+    # @param event_id [String] 
+    # @param post_api_events_by_event_id_actions_edit_for_sale_config_request [PostApiEventsByEventIdActionsEditForSaleConfigRequest] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Optional. A replay with the same key and body returns the stored response (24 h); a different body under the same key is 409 &#x60;idempotency_conflict&#x60;.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def post_api_events_by_event_id_actions_edit_for_sale_config_with_http_info(event_id, post_api_events_by_event_id_actions_edit_for_sale_config_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EventsApi.post_api_events_by_event_id_actions_edit_for_sale_config ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.post_api_events_by_event_id_actions_edit_for_sale_config"
+      end
+      # verify the required parameter 'post_api_events_by_event_id_actions_edit_for_sale_config_request' is set
+      if @api_client.config.client_side_validation && post_api_events_by_event_id_actions_edit_for_sale_config_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_events_by_event_id_actions_edit_for_sale_config_request' when calling EventsApi.post_api_events_by_event_id_actions_edit_for_sale_config"
+      end
+      if @api_client.config.client_side_validation && !opts[:'idempotency_key'].nil? && opts[:'idempotency_key'].to_s.length > 255
+        fail ArgumentError, 'invalid value for "opts[:"idempotency_key"]" when calling EventsApi.post_api_events_by_event_id_actions_edit_for_sale_config, the character length must be smaller than or equal to 255.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'idempotency_key'].nil? && opts[:'idempotency_key'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"idempotency_key"]" when calling EventsApi.post_api_events_by_event_id_actions_edit_for_sale_config, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/events/{eventId}/actions/edit-for-sale-config'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json', 'multipart/form-data', 'text/plain'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'idempotency-key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(post_api_events_by_event_id_actions_edit_for_sale_config_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"EventsApi.post_api_events_by_event_id_actions_edit_for_sale_config",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EventsApi#post_api_events_by_event_id_actions_edit_for_sale_config\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Put every object of the event back on sale
+    # Seats.io `markEverythingAsForSale`: the inverse of mark-everything-as-not-for-sale, in one SQL transaction — every seat (except retired ones) and GA area goes on sale and withheld GA places are cleared. Audited (`inventory.for_sale.mark_everything_for_sale`), event log and webhook as above. Same response.
+    # @param event_id [String] 
+    # @param post_api_events_by_event_id_actions_mark_everything_as_not_for_sale_request [PostApiEventsByEventIdActionsMarkEverythingAsNotForSaleRequest] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Required on transactional routes. Reuse the same key for every retry of one logical operation; the API replays the stored outcome.
+    # @return [nil]
+    def post_api_events_by_event_id_actions_mark_everything_as_for_sale(event_id, post_api_events_by_event_id_actions_mark_everything_as_not_for_sale_request, opts = {})
+      post_api_events_by_event_id_actions_mark_everything_as_for_sale_with_http_info(event_id, post_api_events_by_event_id_actions_mark_everything_as_not_for_sale_request, opts)
+      nil
+    end
+
+    # Put every object of the event back on sale
+    # Seats.io &#x60;markEverythingAsForSale&#x60;: the inverse of mark-everything-as-not-for-sale, in one SQL transaction — every seat (except retired ones) and GA area goes on sale and withheld GA places are cleared. Audited (&#x60;inventory.for_sale.mark_everything_for_sale&#x60;), event log and webhook as above. Same response.
+    # @param event_id [String] 
+    # @param post_api_events_by_event_id_actions_mark_everything_as_not_for_sale_request [PostApiEventsByEventIdActionsMarkEverythingAsNotForSaleRequest] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Required on transactional routes. Reuse the same key for every retry of one logical operation; the API replays the stored outcome.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def post_api_events_by_event_id_actions_mark_everything_as_for_sale_with_http_info(event_id, post_api_events_by_event_id_actions_mark_everything_as_not_for_sale_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EventsApi.post_api_events_by_event_id_actions_mark_everything_as_for_sale ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.post_api_events_by_event_id_actions_mark_everything_as_for_sale"
+      end
+      # verify the required parameter 'post_api_events_by_event_id_actions_mark_everything_as_not_for_sale_request' is set
+      if @api_client.config.client_side_validation && post_api_events_by_event_id_actions_mark_everything_as_not_for_sale_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_events_by_event_id_actions_mark_everything_as_not_for_sale_request' when calling EventsApi.post_api_events_by_event_id_actions_mark_everything_as_for_sale"
+      end
+      if @api_client.config.client_side_validation && !opts[:'idempotency_key'].nil? && opts[:'idempotency_key'].to_s.length > 255
+        fail ArgumentError, 'invalid value for "opts[:"idempotency_key"]" when calling EventsApi.post_api_events_by_event_id_actions_mark_everything_as_for_sale, the character length must be smaller than or equal to 255.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'idempotency_key'].nil? && opts[:'idempotency_key'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"idempotency_key"]" when calling EventsApi.post_api_events_by_event_id_actions_mark_everything_as_for_sale, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/events/{eventId}/actions/mark-everything-as-for-sale'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json', 'multipart/form-data', 'text/plain'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(post_api_events_by_event_id_actions_mark_everything_as_not_for_sale_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"EventsApi.post_api_events_by_event_id_actions_mark_everything_as_for_sale",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EventsApi#post_api_events_by_event_id_actions_mark_everything_as_for_sale\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Mark every object of the event not for sale
+    # Seats.io `markEverythingAsNotForSale`: every seat and GA area of the event goes off sale in **one SQL transaction** (the event row lock serializes it with other for-sale changes; all or nothing). Holds on the objects are released after COMMIT, then one cache invalidate and one `for_sale` realtime message. Sold seats stay sold. Audited (`inventory.for_sale.mark_everything_not_for_sale`), in the event log and the `event.for_sale_changed` webhook (`event.for.sale.config.updated` alias). Season behaviour as POST …/for-sale/apply (`cascadeSeason`, `forSalePropagated`). Response as PUT …/inventory/for-sale (`changedSeats`, `changedGaAreas`, `seatsNotForSale`, `gaAreasNotForSale`, `releasedSeatHolds`, `clearedGaHoldAreas`).
+    # @param event_id [String] 
+    # @param post_api_events_by_event_id_actions_mark_everything_as_not_for_sale_request [PostApiEventsByEventIdActionsMarkEverythingAsNotForSaleRequest] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Required on transactional routes. Reuse the same key for every retry of one logical operation; the API replays the stored outcome.
+    # @return [nil]
+    def post_api_events_by_event_id_actions_mark_everything_as_not_for_sale(event_id, post_api_events_by_event_id_actions_mark_everything_as_not_for_sale_request, opts = {})
+      post_api_events_by_event_id_actions_mark_everything_as_not_for_sale_with_http_info(event_id, post_api_events_by_event_id_actions_mark_everything_as_not_for_sale_request, opts)
+      nil
+    end
+
+    # Mark every object of the event not for sale
+    # Seats.io &#x60;markEverythingAsNotForSale&#x60;: every seat and GA area of the event goes off sale in **one SQL transaction** (the event row lock serializes it with other for-sale changes; all or nothing). Holds on the objects are released after COMMIT, then one cache invalidate and one &#x60;for_sale&#x60; realtime message. Sold seats stay sold. Audited (&#x60;inventory.for_sale.mark_everything_not_for_sale&#x60;), in the event log and the &#x60;event.for_sale_changed&#x60; webhook (&#x60;event.for.sale.config.updated&#x60; alias). Season behaviour as POST …/for-sale/apply (&#x60;cascadeSeason&#x60;, &#x60;forSalePropagated&#x60;). Response as PUT …/inventory/for-sale (&#x60;changedSeats&#x60;, &#x60;changedGaAreas&#x60;, &#x60;seatsNotForSale&#x60;, &#x60;gaAreasNotForSale&#x60;, &#x60;releasedSeatHolds&#x60;, &#x60;clearedGaHoldAreas&#x60;).
+    # @param event_id [String] 
+    # @param post_api_events_by_event_id_actions_mark_everything_as_not_for_sale_request [PostApiEventsByEventIdActionsMarkEverythingAsNotForSaleRequest] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Required on transactional routes. Reuse the same key for every retry of one logical operation; the API replays the stored outcome.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def post_api_events_by_event_id_actions_mark_everything_as_not_for_sale_with_http_info(event_id, post_api_events_by_event_id_actions_mark_everything_as_not_for_sale_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EventsApi.post_api_events_by_event_id_actions_mark_everything_as_not_for_sale ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling EventsApi.post_api_events_by_event_id_actions_mark_everything_as_not_for_sale"
+      end
+      # verify the required parameter 'post_api_events_by_event_id_actions_mark_everything_as_not_for_sale_request' is set
+      if @api_client.config.client_side_validation && post_api_events_by_event_id_actions_mark_everything_as_not_for_sale_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_events_by_event_id_actions_mark_everything_as_not_for_sale_request' when calling EventsApi.post_api_events_by_event_id_actions_mark_everything_as_not_for_sale"
+      end
+      if @api_client.config.client_side_validation && !opts[:'idempotency_key'].nil? && opts[:'idempotency_key'].to_s.length > 255
+        fail ArgumentError, 'invalid value for "opts[:"idempotency_key"]" when calling EventsApi.post_api_events_by_event_id_actions_mark_everything_as_not_for_sale, the character length must be smaller than or equal to 255.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'idempotency_key'].nil? && opts[:'idempotency_key'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"idempotency_key"]" when calling EventsApi.post_api_events_by_event_id_actions_mark_everything_as_not_for_sale, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/events/{eventId}/actions/mark-everything-as-not-for-sale'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json', 'multipart/form-data', 'text/plain'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(post_api_events_by_event_id_actions_mark_everything_as_not_for_sale_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"EventsApi.post_api_events_by_event_id_actions_mark_everything_as_not_for_sale",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EventsApi#post_api_events_by_event_id_actions_mark_everything_as_not_for_sale\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Move the event to a new copy of its chart
     # Copies the event's current chart (published seat/GA templates, layout and draft) into a new published chart and repoints the event to it in one transaction, so the event's map can be edited without affecting other events. Seats, holds, sales and orders are never touched (seat ids are unchanged). Refuses with 409 `structural_mismatch` (`orphanedObjects`: labels) when a sold, held or pending seat — or a GA area with sales — has no counterpart in the chart, and with 409 `chart_not_published` when there is nothing to copy. Counts against the plan chart limit. Response `{ eventId, previousChartId, chartId, chartName }`.
     # @param event_id [String] 
@@ -5668,23 +7139,25 @@ module SeatsChart
     end
 
     # Publish draft map to live seats
-    # Promotes draft → `seats` + `event_layouts`, invalidates map cache. Blocks publish if draft removes sold seats.  The draft is validated with the same rules the designer runs: duplicate seat labels within a section, seats without a category (when categories exist), empty labels, overlapping seats and tables with fewer than 2 seats are **errors** and return `422 { error: \"validation_failed\", issues: [{ code, severity, objectIds, message }] }`. Warnings (one-seat row gaps) do not block and are returned in `warnings`.  Every successful publish appends an immutable version (`version`; `sameAsVersion` names an earlier version with identical content). The map that was live before the first recorded publish becomes the `baseline` version 1. See `GET /api/events/:eventId/map/versions`.
+    # Promotes draft → `seats` + `event_layouts`, invalidates map cache. Blocks publish if draft removes sold seats.  A draft that removes seats of active listings is refused with 409 `listing_objects_removed` (`listings`: id, key and `removedObjects` of each affected listing): withdraw or update those listings first, or publish with `withdrawAffectedListings: true` to withdraw them in the same transaction (409 `listing_has_holds` while any of their objects is held). Withdrawn listings are returned in `withdrawnListings` and recorded in the event log.  The draft is validated with the same rules the designer runs: duplicate seat labels within a section, seats without a category (when categories exist), empty labels, overlapping seats and tables with fewer than 2 seats are **errors** and return `422 { error: \"validation_failed\", issues: [{ code, severity, objectIds, message }] }`. Warnings (one-seat row gaps) do not block and are returned in `warnings`.  Every successful publish appends an immutable version (`version`; `sameAsVersion` names an earlier version with identical content). The map that was live before the first recorded publish becomes the `baseline` version 1. See `GET /api/events/:eventId/map/versions`.
     # @param event_id [String] 
+    # @param post_api_events_by_event_id_map_publish_request [PostApiEventsByEventIdMapPublishRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :idempotency_key Required on transactional routes. Reuse the same key for every retry of one logical operation; the API replays the stored outcome.
     # @return [nil]
-    def post_api_events_by_event_id_map_publish(event_id, opts = {})
-      post_api_events_by_event_id_map_publish_with_http_info(event_id, opts)
+    def post_api_events_by_event_id_map_publish(event_id, post_api_events_by_event_id_map_publish_request, opts = {})
+      post_api_events_by_event_id_map_publish_with_http_info(event_id, post_api_events_by_event_id_map_publish_request, opts)
       nil
     end
 
     # Publish draft map to live seats
-    # Promotes draft → &#x60;seats&#x60; + &#x60;event_layouts&#x60;, invalidates map cache. Blocks publish if draft removes sold seats.  The draft is validated with the same rules the designer runs: duplicate seat labels within a section, seats without a category (when categories exist), empty labels, overlapping seats and tables with fewer than 2 seats are **errors** and return &#x60;422 { error: \&quot;validation_failed\&quot;, issues: [{ code, severity, objectIds, message }] }&#x60;. Warnings (one-seat row gaps) do not block and are returned in &#x60;warnings&#x60;.  Every successful publish appends an immutable version (&#x60;version&#x60;; &#x60;sameAsVersion&#x60; names an earlier version with identical content). The map that was live before the first recorded publish becomes the &#x60;baseline&#x60; version 1. See &#x60;GET /api/events/:eventId/map/versions&#x60;.
+    # Promotes draft → &#x60;seats&#x60; + &#x60;event_layouts&#x60;, invalidates map cache. Blocks publish if draft removes sold seats.  A draft that removes seats of active listings is refused with 409 &#x60;listing_objects_removed&#x60; (&#x60;listings&#x60;: id, key and &#x60;removedObjects&#x60; of each affected listing): withdraw or update those listings first, or publish with &#x60;withdrawAffectedListings: true&#x60; to withdraw them in the same transaction (409 &#x60;listing_has_holds&#x60; while any of their objects is held). Withdrawn listings are returned in &#x60;withdrawnListings&#x60; and recorded in the event log.  The draft is validated with the same rules the designer runs: duplicate seat labels within a section, seats without a category (when categories exist), empty labels, overlapping seats and tables with fewer than 2 seats are **errors** and return &#x60;422 { error: \&quot;validation_failed\&quot;, issues: [{ code, severity, objectIds, message }] }&#x60;. Warnings (one-seat row gaps) do not block and are returned in &#x60;warnings&#x60;.  Every successful publish appends an immutable version (&#x60;version&#x60;; &#x60;sameAsVersion&#x60; names an earlier version with identical content). The map that was live before the first recorded publish becomes the &#x60;baseline&#x60; version 1. See &#x60;GET /api/events/:eventId/map/versions&#x60;.
     # @param event_id [String] 
+    # @param post_api_events_by_event_id_map_publish_request [PostApiEventsByEventIdMapPublishRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :idempotency_key Required on transactional routes. Reuse the same key for every retry of one logical operation; the API replays the stored outcome.
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
-    def post_api_events_by_event_id_map_publish_with_http_info(event_id, opts = {})
+    def post_api_events_by_event_id_map_publish_with_http_info(event_id, post_api_events_by_event_id_map_publish_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: EventsApi.post_api_events_by_event_id_map_publish ...'
       end
@@ -5700,6 +7173,10 @@ module SeatsChart
         fail ArgumentError, 'invalid value for "event_id" when calling EventsApi.post_api_events_by_event_id_map_publish, the character length must be great than or equal to 36.'
       end
 
+      # verify the required parameter 'post_api_events_by_event_id_map_publish_request' is set
+      if @api_client.config.client_side_validation && post_api_events_by_event_id_map_publish_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_events_by_event_id_map_publish_request' when calling EventsApi.post_api_events_by_event_id_map_publish"
+      end
       if @api_client.config.client_side_validation && !opts[:'idempotency_key'].nil? && opts[:'idempotency_key'].to_s.length > 255
         fail ArgumentError, 'invalid value for "opts[:"idempotency_key"]" when calling EventsApi.post_api_events_by_event_id_map_publish, the character length must be smaller than or equal to 255.'
       end
@@ -5718,13 +7195,18 @@ module SeatsChart
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/json', 'multipart/form-data', 'text/plain']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json', 'multipart/form-data', 'text/plain'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
       header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body]
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(post_api_events_by_event_id_map_publish_request)
 
       # return_type
       return_type = opts[:debug_return_type]
@@ -6260,23 +7742,23 @@ module SeatsChart
     # Save map draft (legacy path)
     # Alias for **`PUT /map/draft`**. Does **not** publish to buyers — use **`POST /map/publish`**.
     # @param event_id [String] 
-    # @param post_api_charts_by_chart_id_actions_validate_request [PostApiChartsByChartIdActionsValidateRequest] 
+    # @param put_api_charts_by_chart_id_map_draft_request [PutApiChartsByChartIdMapDraftRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :idempotency_key Required on transactional routes. Reuse the same key for every retry of one logical operation; the API replays the stored outcome.
     # @return [nil]
-    def put_api_events_by_event_id_map(event_id, post_api_charts_by_chart_id_actions_validate_request, opts = {})
-      put_api_events_by_event_id_map_with_http_info(event_id, post_api_charts_by_chart_id_actions_validate_request, opts)
+    def put_api_events_by_event_id_map(event_id, put_api_charts_by_chart_id_map_draft_request, opts = {})
+      put_api_events_by_event_id_map_with_http_info(event_id, put_api_charts_by_chart_id_map_draft_request, opts)
       nil
     end
 
     # Save map draft (legacy path)
     # Alias for **&#x60;PUT /map/draft&#x60;**. Does **not** publish to buyers — use **&#x60;POST /map/publish&#x60;**.
     # @param event_id [String] 
-    # @param post_api_charts_by_chart_id_actions_validate_request [PostApiChartsByChartIdActionsValidateRequest] 
+    # @param put_api_charts_by_chart_id_map_draft_request [PutApiChartsByChartIdMapDraftRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :idempotency_key Required on transactional routes. Reuse the same key for every retry of one logical operation; the API replays the stored outcome.
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
-    def put_api_events_by_event_id_map_with_http_info(event_id, post_api_charts_by_chart_id_actions_validate_request, opts = {})
+    def put_api_events_by_event_id_map_with_http_info(event_id, put_api_charts_by_chart_id_map_draft_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: EventsApi.put_api_events_by_event_id_map ...'
       end
@@ -6292,9 +7774,9 @@ module SeatsChart
         fail ArgumentError, 'invalid value for "event_id" when calling EventsApi.put_api_events_by_event_id_map, the character length must be great than or equal to 36.'
       end
 
-      # verify the required parameter 'post_api_charts_by_chart_id_actions_validate_request' is set
-      if @api_client.config.client_side_validation && post_api_charts_by_chart_id_actions_validate_request.nil?
-        fail ArgumentError, "Missing the required parameter 'post_api_charts_by_chart_id_actions_validate_request' when calling EventsApi.put_api_events_by_event_id_map"
+      # verify the required parameter 'put_api_charts_by_chart_id_map_draft_request' is set
+      if @api_client.config.client_side_validation && put_api_charts_by_chart_id_map_draft_request.nil?
+        fail ArgumentError, "Missing the required parameter 'put_api_charts_by_chart_id_map_draft_request' when calling EventsApi.put_api_events_by_event_id_map"
       end
       if @api_client.config.client_side_validation && !opts[:'idempotency_key'].nil? && opts[:'idempotency_key'].to_s.length > 255
         fail ArgumentError, 'invalid value for "opts[:"idempotency_key"]" when calling EventsApi.put_api_events_by_event_id_map, the character length must be smaller than or equal to 255.'
@@ -6323,7 +7805,7 @@ module SeatsChart
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(post_api_charts_by_chart_id_actions_validate_request)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(put_api_charts_by_chart_id_map_draft_request)
 
       # return_type
       return_type = opts[:debug_return_type]
@@ -6351,23 +7833,23 @@ module SeatsChart
     # Save map draft (does not go live)
     # Persists designer changes to `event_map_drafts` only. B2C viewers keep reading the last published map until `POST .../map/publish`. With `baseDraftUpdatedAt` the save is conflict-safe: 409 `draft_conflict` (with the current `draftUpdatedAt`) when the draft changed since that version (designer autosave).
     # @param event_id [String] 
-    # @param post_api_charts_by_chart_id_actions_validate_request [PostApiChartsByChartIdActionsValidateRequest] 
+    # @param put_api_charts_by_chart_id_map_draft_request [PutApiChartsByChartIdMapDraftRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :idempotency_key Required on transactional routes. Reuse the same key for every retry of one logical operation; the API replays the stored outcome.
     # @return [nil]
-    def put_api_events_by_event_id_map_draft(event_id, post_api_charts_by_chart_id_actions_validate_request, opts = {})
-      put_api_events_by_event_id_map_draft_with_http_info(event_id, post_api_charts_by_chart_id_actions_validate_request, opts)
+    def put_api_events_by_event_id_map_draft(event_id, put_api_charts_by_chart_id_map_draft_request, opts = {})
+      put_api_events_by_event_id_map_draft_with_http_info(event_id, put_api_charts_by_chart_id_map_draft_request, opts)
       nil
     end
 
     # Save map draft (does not go live)
     # Persists designer changes to &#x60;event_map_drafts&#x60; only. B2C viewers keep reading the last published map until &#x60;POST .../map/publish&#x60;. With &#x60;baseDraftUpdatedAt&#x60; the save is conflict-safe: 409 &#x60;draft_conflict&#x60; (with the current &#x60;draftUpdatedAt&#x60;) when the draft changed since that version (designer autosave).
     # @param event_id [String] 
-    # @param post_api_charts_by_chart_id_actions_validate_request [PostApiChartsByChartIdActionsValidateRequest] 
+    # @param put_api_charts_by_chart_id_map_draft_request [PutApiChartsByChartIdMapDraftRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :idempotency_key Required on transactional routes. Reuse the same key for every retry of one logical operation; the API replays the stored outcome.
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
-    def put_api_events_by_event_id_map_draft_with_http_info(event_id, post_api_charts_by_chart_id_actions_validate_request, opts = {})
+    def put_api_events_by_event_id_map_draft_with_http_info(event_id, put_api_charts_by_chart_id_map_draft_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: EventsApi.put_api_events_by_event_id_map_draft ...'
       end
@@ -6383,9 +7865,9 @@ module SeatsChart
         fail ArgumentError, 'invalid value for "event_id" when calling EventsApi.put_api_events_by_event_id_map_draft, the character length must be great than or equal to 36.'
       end
 
-      # verify the required parameter 'post_api_charts_by_chart_id_actions_validate_request' is set
-      if @api_client.config.client_side_validation && post_api_charts_by_chart_id_actions_validate_request.nil?
-        fail ArgumentError, "Missing the required parameter 'post_api_charts_by_chart_id_actions_validate_request' when calling EventsApi.put_api_events_by_event_id_map_draft"
+      # verify the required parameter 'put_api_charts_by_chart_id_map_draft_request' is set
+      if @api_client.config.client_side_validation && put_api_charts_by_chart_id_map_draft_request.nil?
+        fail ArgumentError, "Missing the required parameter 'put_api_charts_by_chart_id_map_draft_request' when calling EventsApi.put_api_events_by_event_id_map_draft"
       end
       if @api_client.config.client_side_validation && !opts[:'idempotency_key'].nil? && opts[:'idempotency_key'].to_s.length > 255
         fail ArgumentError, 'invalid value for "opts[:"idempotency_key"]" when calling EventsApi.put_api_events_by_event_id_map_draft, the character length must be smaller than or equal to 255.'
@@ -6414,7 +7896,7 @@ module SeatsChart
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(post_api_charts_by_chart_id_actions_validate_request)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(put_api_charts_by_chart_id_map_draft_request)
 
       # return_type
       return_type = opts[:debug_return_type]