seatschart 0.1.0

data/lib/seatschart/api/charts_api.rb

@@ -0,0 +1,4195 @@
+=begin
+#SeatsChart API
+
+#Seat inventory and locking API for B2B2C integrations. Authenticate using `x-api-key` (partners) or `Authorization: Bearer` with an HS256 JWT.
+
+The version of the OpenAPI document: 1.0.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.11.0
+
+=end
+
+require 'cgi'
+
+module SeatsChart
+  class ChartsApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Delete chart permanently
+    # Permanently deletes a chart with its layout, draft, templates, tags and version history. Only archived charts that no event references can be deleted: `409 ERR_CHART_NOT_ARCHIVED` — archive it first (`POST /api/charts/:chartId/actions/archive`); `409 ERR_CHART_HAS_EVENTS` (`params.eventCount`) — keep it archived (events keep working) or delete the events. Requires the `content_delete` permission (dashboard admin / map editor; not available to partner API keys).
+    # @param chart_id [String] 
+    # @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 delete_api_charts_by_chart_id(chart_id, opts = {})
+      delete_api_charts_by_chart_id_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Delete chart permanently
+    # Permanently deletes a chart with its layout, draft, templates, tags and version history. Only archived charts that no event references can be deleted: `409 ERR_CHART_NOT_ARCHIVED` — archive it first (`POST /api/charts/:chartId/actions/archive`); `409 ERR_CHART_HAS_EVENTS` (`params.eventCount`) — keep it archived (events keep working) or delete the events. Requires the `content_delete` permission (dashboard admin / map editor; not available to partner API keys).
+    # @param chart_id [String] 
+    # @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 delete_api_charts_by_chart_id_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.delete_api_charts_by_chart_id ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.delete_api_charts_by_chart_id"
+      end
+      if @api_client.config.client_side_validation && chart_id.to_s.length > 36
+        fail ArgumentError, 'invalid value for "chart_id" when calling ChartsApi.delete_api_charts_by_chart_id, the character length must be smaller than or equal to 36.'
+      end
+
+      if @api_client.config.client_side_validation && chart_id.to_s.length < 36
+        fail ArgumentError, 'invalid value for "chart_id" when calling ChartsApi.delete_api_charts_by_chart_id, the character length must be great than or equal to 36.'
+      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 ChartsApi.delete_api_charts_by_chart_id, 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 ChartsApi.delete_api_charts_by_chart_id, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/charts/{chartId}'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      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]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ChartsApi.delete_api_charts_by_chart_id",
+        :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(:DELETE, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ChartsApi#delete_api_charts_by_chart_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Revoke every public preview link of a chart
+    # Rotates the chart's preview secret: all links issued before stop working (within ~15 s on every API instance).
+    # @param chart_id [String] 
+    # @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 delete_api_charts_by_chart_id_preview_link(chart_id, opts = {})
+      delete_api_charts_by_chart_id_preview_link_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Revoke every public preview link of a chart
+    # Rotates the chart&#39;s preview secret: all links issued before stop working (within ~15 s on every API instance).
+    # @param chart_id [String] 
+    # @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 delete_api_charts_by_chart_id_preview_link_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.delete_api_charts_by_chart_id_preview_link ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.delete_api_charts_by_chart_id_preview_link"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.delete_api_charts_by_chart_id_preview_link, must conform to the pattern #{pattern}."
+      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 ChartsApi.delete_api_charts_by_chart_id_preview_link, 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 ChartsApi.delete_api_charts_by_chart_id_preview_link, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/charts/{chartId}/preview-link'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      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]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ChartsApi.delete_api_charts_by_chart_id_preview_link",
+        :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(:DELETE, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ChartsApi#delete_api_charts_by_chart_id_preview_link\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List charts
+    # Without query parameters, returns the legacy `{ charts }` shape (newest draft first, at most 200 rows, archived charts hidden); its items carry `publishedValidation` (stored counts of the published map, what event creation checks). When `limit`, `cursor`, `q`, `archived`, `tag`, `sort` or `expand` is sent, returns a cursor page `{ items, nextCursor }` (stable across pages, no row cap). Pass `nextCursor` back as `cursor` with the same filters until it is null. Paginated items add `eventCount`, `recentEvents` (up to 3 `{ id, name, date, status: upcoming | past | ended }`: upcoming soonest first, then past most recent first, then ended), `archivedAt`, `createdAt`, `tags`, `latestVersion`, `hasThumbnail` and `thumbnailUrl` (authenticated relative path, null until first publish) and omit `mapTemplate` (no layout geometry is read). `validation` `{ errors, warnings, issues: [{ code, severity, count, message }] }` holds the per-rule counts stored at the last draft save / publish under the current workspace severity (null when never computed); the rules are not re-run. Archived charts are hidden unless `archived=true|all`.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Float] :limit Page size (1..100, default 20).
+    # @option opts [String] :cursor Opaque &#x60;nextCursor&#x60; value from the previous page.
+    # @option opts [String] :q Case-insensitive substring match on the chart name, or the exact chart key.
+    # @option opts [String] :archived &#x60;false&#x60; (default) hides archived charts, &#x60;true&#x60; returns only archived charts, &#x60;all&#x60; returns both.
+    # @option opts [String] :tag Comma-separated tags (case-insensitive, at most 5); a chart must carry all of them.
+    # @option opts [String] :sort &#x60;name&#x60; (default): name A→Z. &#x60;recent&#x60;: last draft save / publish first, then creation time.
+    # @option opts [String] :expand Comma-separated. &#x60;events&#x60; adds &#x60;events[]&#x60; (&#x60;{ id, key, name, date, isInThePast }&#x60;, soonest first, at most 100 per chart; &#x60;eventCount&#x60; has the total). &#x60;validation&#x60; is accepted for seats.io compatibility (&#x60;validation&#x60; is always part of paginated items).
+    # @return [nil]
+    def get_api_charts(opts = {})
+      get_api_charts_with_http_info(opts)
+      nil
+    end
+
+    # List charts
+    # Without query parameters, returns the legacy &#x60;{ charts }&#x60; shape (newest draft first, at most 200 rows, archived charts hidden); its items carry &#x60;publishedValidation&#x60; (stored counts of the published map, what event creation checks). When &#x60;limit&#x60;, &#x60;cursor&#x60;, &#x60;q&#x60;, &#x60;archived&#x60;, &#x60;tag&#x60;, &#x60;sort&#x60; or &#x60;expand&#x60; is sent, returns a cursor page &#x60;{ items, nextCursor }&#x60; (stable across pages, no row cap). Pass &#x60;nextCursor&#x60; back as &#x60;cursor&#x60; with the same filters until it is null. Paginated items add &#x60;eventCount&#x60;, &#x60;recentEvents&#x60; (up to 3 &#x60;{ id, name, date, status: upcoming | past | ended }&#x60;: upcoming soonest first, then past most recent first, then ended), &#x60;archivedAt&#x60;, &#x60;createdAt&#x60;, &#x60;tags&#x60;, &#x60;latestVersion&#x60;, &#x60;hasThumbnail&#x60; and &#x60;thumbnailUrl&#x60; (authenticated relative path, null until first publish) and omit &#x60;mapTemplate&#x60; (no layout geometry is read). &#x60;validation&#x60; &#x60;{ errors, warnings, issues: [{ code, severity, count, message }] }&#x60; holds the per-rule counts stored at the last draft save / publish under the current workspace severity (null when never computed); the rules are not re-run. Archived charts are hidden unless &#x60;archived&#x3D;true|all&#x60;.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Float] :limit Page size (1..100, default 20).
+    # @option opts [String] :cursor Opaque &#x60;nextCursor&#x60; value from the previous page.
+    # @option opts [String] :q Case-insensitive substring match on the chart name, or the exact chart key.
+    # @option opts [String] :archived &#x60;false&#x60; (default) hides archived charts, &#x60;true&#x60; returns only archived charts, &#x60;all&#x60; returns both.
+    # @option opts [String] :tag Comma-separated tags (case-insensitive, at most 5); a chart must carry all of them.
+    # @option opts [String] :sort &#x60;name&#x60; (default): name A→Z. &#x60;recent&#x60;: last draft save / publish first, then creation time.
+    # @option opts [String] :expand Comma-separated. &#x60;events&#x60; adds &#x60;events[]&#x60; (&#x60;{ id, key, name, date, isInThePast }&#x60;, soonest first, at most 100 per chart; &#x60;eventCount&#x60; has the total). &#x60;validation&#x60; is accepted for seats.io compatibility (&#x60;validation&#x60; is always part of paginated items).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts ...'
+      end
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling ChartsApi.get_api_charts, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling ChartsApi.get_api_charts, must be greater than or equal to 1.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'cursor'].nil? && opts[:'cursor'].to_s.length > 512
+        fail ArgumentError, 'invalid value for "opts[:"cursor"]" when calling ChartsApi.get_api_charts, the character length must be smaller than or equal to 512.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'cursor'].nil? && opts[:'cursor'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"cursor"]" when calling ChartsApi.get_api_charts, the character length must be great than or equal to 1.'
+      end
+
+      pattern = Regexp.new(/^[A-Za-z0-9_-]+$/)
+      if @api_client.config.client_side_validation && !opts[:'cursor'].nil? && opts[:'cursor'] !~ pattern
+        fail ArgumentError, "invalid value for 'opts[:\"cursor\"]' when calling ChartsApi.get_api_charts, must conform to the pattern #{pattern}."
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'q'].nil? && opts[:'q'].to_s.length > 128
+        fail ArgumentError, 'invalid value for "opts[:"q"]" when calling ChartsApi.get_api_charts, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'q'].nil? && opts[:'q'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"q"]" when calling ChartsApi.get_api_charts, the character length must be great than or equal to 1.'
+      end
+
+      allowable_values = ["false", "true", "all"]
+      if @api_client.config.client_side_validation && opts[:'archived'] && !allowable_values.include?(opts[:'archived'])
+        fail ArgumentError, "invalid value for \"archived\", must be one of #{allowable_values}"
+      end
+      if @api_client.config.client_side_validation && !opts[:'tag'].nil? && opts[:'tag'].to_s.length > 256
+        fail ArgumentError, 'invalid value for "opts[:"tag"]" when calling ChartsApi.get_api_charts, the character length must be smaller than or equal to 256.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'tag'].nil? && opts[:'tag'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"tag"]" when calling ChartsApi.get_api_charts, the character length must be great than or equal to 1.'
+      end
+
+      allowable_values = ["name", "recent"]
+      if @api_client.config.client_side_validation && opts[:'sort'] && !allowable_values.include?(opts[:'sort'])
+        fail ArgumentError, "invalid value for \"sort\", must be one of #{allowable_values}"
+      end
+      if @api_client.config.client_side_validation && !opts[:'expand'].nil? && opts[:'expand'].to_s.length > 64
+        fail ArgumentError, 'invalid value for "opts[:"expand"]" when calling ChartsApi.get_api_charts, the character length must be smaller than or equal to 64.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'expand'].nil? && opts[:'expand'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"expand"]" when calling ChartsApi.get_api_charts, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/charts'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'cursor'] = opts[:'cursor'] if !opts[:'cursor'].nil?
+      query_params[:'q'] = opts[:'q'] if !opts[:'q'].nil?
+      query_params[:'archived'] = opts[:'archived'] if !opts[:'archived'].nil?
+      query_params[:'tag'] = opts[:'tag'] if !opts[:'tag'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
+      query_params[:'expand'] = opts[:'expand'] if !opts[:'expand'].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 => :"ChartsApi.get_api_charts",
+        :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: ChartsApi#get_api_charts\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Retrieve one chart
+    # Returns chart `key`, name and publication metadata: `publishedAt`, `draftUpdatedAt`, `isPublished`, `hasUnpublishedDraft`, `hasDraft`, published seat / GA template counts and the number of events using it, plus `archivedAt`, `createdAt`, `tags`, `latestVersion`, `hasThumbnail` and `thumbnailUrl`. Archived charts are still returned. Geometry blobs are never returned — use the map / draft endpoints. `?expand=zones` adds the zones of the published chart (`&version=draft`: of the draft; empty when that version does not exist). The path accepts the chart key. 404 when the chart belongs to another tenant.
+    # @param chart_id [String] Chart id (UUID) or chart key.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :expand &#x60;zones&#x60; adds &#x60;zones[]&#x60; (same items as GET /charts/{chartId}/zones) of the version selected by &#x60;version&#x60;.
+    # @option opts [String] :version &#x60;published&#x60; or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id(chart_id, opts = {})
+      get_api_charts_by_chart_id_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Retrieve one chart
+    # Returns chart &#x60;key&#x60;, name and publication metadata: &#x60;publishedAt&#x60;, &#x60;draftUpdatedAt&#x60;, &#x60;isPublished&#x60;, &#x60;hasUnpublishedDraft&#x60;, &#x60;hasDraft&#x60;, published seat / GA template counts and the number of events using it, plus &#x60;archivedAt&#x60;, &#x60;createdAt&#x60;, &#x60;tags&#x60;, &#x60;latestVersion&#x60;, &#x60;hasThumbnail&#x60; and &#x60;thumbnailUrl&#x60;. Archived charts are still returned. Geometry blobs are never returned — use the map / draft endpoints. &#x60;?expand&#x3D;zones&#x60; adds the zones of the published chart (&#x60;&amp;version&#x3D;draft&#x60;: of the draft; empty when that version does not exist). The path accepts the chart key. 404 when the chart belongs to another tenant.
+    # @param chart_id [String] Chart id (UUID) or chart key.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :expand &#x60;zones&#x60; adds &#x60;zones[]&#x60; (same items as GET /charts/{chartId}/zones) of the version selected by &#x60;version&#x60;.
+    # @option opts [String] :version &#x60;published&#x60; or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id, must conform to the pattern #{pattern}."
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'expand'].nil? && opts[:'expand'].to_s.length > 64
+        fail ArgumentError, 'invalid value for "opts[:"expand"]" when calling ChartsApi.get_api_charts_by_chart_id, the character length must be smaller than or equal to 64.'
+      end
+
+      pattern = Regexp.new(/^[A-Za-z,]*$/)
+      if @api_client.config.client_side_validation && !opts[:'expand'].nil? && opts[:'expand'] !~ pattern
+        fail ArgumentError, "invalid value for 'opts[:\"expand\"]' when calling ChartsApi.get_api_charts_by_chart_id, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'expand'] = opts[:'expand'] if !opts[:'expand'].nil?
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id",
+        :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: ChartsApi#get_api_charts_by_chart_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List the categories of a chart
+    # Categories (`{ id, name, color, ticketTypes, seatCount, gaAreaCount }`) of the draft, else the published map (`source` tells which). `?version=published` reads the published chart even while a draft exists; `?version=draft` reads only the draft (404 `draft_not_found` / `not_published` when that version does not exist). Requires read access.
+    # @param chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; or &#x60;draft&#x60;. Omitted: the draft when there is one, else the published map.
+    # @return [nil]
+    def get_api_charts_by_chart_id_categories(chart_id, opts = {})
+      get_api_charts_by_chart_id_categories_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # List the categories of a chart
+    # Categories (&#x60;{ id, name, color, ticketTypes, seatCount, gaAreaCount }&#x60;) of the draft, else the published map (&#x60;source&#x60; tells which). &#x60;?version&#x3D;published&#x60; reads the published chart even while a draft exists; &#x60;?version&#x3D;draft&#x60; reads only the draft (404 &#x60;draft_not_found&#x60; / &#x60;not_published&#x60; when that version does not exist). Requires read access.
+    # @param chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; or &#x60;draft&#x60;. Omitted: the draft when there is one, else the published map.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_categories_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_categories ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_categories"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_categories, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/categories'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_categories",
+        :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: ChartsApi#get_api_charts_by_chart_id_categories\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Read one version of a chart map
+    # Returns the **published** chart map by default (`seats`, `shapes`, `referenceImage`, `backgroundImage`, `meta`), even while an unpublished draft exists (`meta.hasUnpublishedDraft` tells). `?version=draft` returns the draft only (404 `draft_not_found` without one; requires map authoring access, like `GET /charts/{chartId}/map/draft`, which falls back to the published map). 404 `not_published` for a chart that was never published. Validate a version with `POST /charts/{chartId}/actions/validate?version=published|draft`. Requires read access.
+    # @param chart_id [String] Chart id (UUID) or chart key.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_map(chart_id, opts = {})
+      get_api_charts_by_chart_id_map_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Read one version of a chart map
+    # Returns the **published** chart map by default (&#x60;seats&#x60;, &#x60;shapes&#x60;, &#x60;referenceImage&#x60;, &#x60;backgroundImage&#x60;, &#x60;meta&#x60;), even while an unpublished draft exists (&#x60;meta.hasUnpublishedDraft&#x60; tells). &#x60;?version&#x3D;draft&#x60; returns the draft only (404 &#x60;draft_not_found&#x60; without one; requires map authoring access, like &#x60;GET /charts/{chartId}/map/draft&#x60;, which falls back to the published map). 404 &#x60;not_published&#x60; for a chart that was never published. Validate a version with &#x60;POST /charts/{chartId}/actions/validate?version&#x3D;published|draft&#x60;. Requires read access.
+    # @param chart_id [String] Chart id (UUID) or chart key.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_map_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_map ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_map"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_map, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/map'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_map",
+        :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: ChartsApi#get_api_charts_by_chart_id_map\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Load chart map draft for designer
+    # @param chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_api_charts_by_chart_id_map_draft(chart_id, opts = {})
+      get_api_charts_by_chart_id_map_draft_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Load chart map draft for designer
+    # @param chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_map_draft_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_map_draft ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_map_draft"
+      end
+      if @api_client.config.client_side_validation && chart_id.to_s.length > 36
+        fail ArgumentError, 'invalid value for "chart_id" when calling ChartsApi.get_api_charts_by_chart_id_map_draft, the character length must be smaller than or equal to 36.'
+      end
+
+      if @api_client.config.client_side_validation && chart_id.to_s.length < 36
+        fail ArgumentError, 'invalid value for "chart_id" when calling ChartsApi.get_api_charts_by_chart_id_map_draft, the character length must be great than or equal to 36.'
+      end
+
+      # resource path
+      local_var_path = '/api/charts/{chartId}/map/draft'.sub('{' + 'chartId' + '}', CGI.escape(chart_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 => :"ChartsApi.get_api_charts_by_chart_id_map_draft",
+        :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: ChartsApi#get_api_charts_by_chart_id_map_draft\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart report by category (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :category Only this category bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_by_category_csv(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_by_category_csv_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart report by category (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :category Only this category bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_by_category_csv_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_by_category_csv ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_category_csv"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_category_csv, must conform to the pattern #{pattern}."
+      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 ChartsApi.get_api_charts_by_chart_id_reports_by_category_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 ChartsApi.get_api_charts_by_chart_id_reports_by_category_csv, the character length must be great than or equal to 1.'
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/by-category.csv'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'category'] = opts[:'category'] if !opts[:'category'].nil?
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_by_category_csv",
+        :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: ChartsApi#get_api_charts_by_chart_id_reports_by_category_csv\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart report by category
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :category Only this category bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_by_category_json(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_by_category_json_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart report by category
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :category Only this category bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_by_category_json_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_by_category_json ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_category_json, must conform to the pattern #{pattern}."
+      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 ChartsApi.get_api_charts_by_chart_id_reports_by_category_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 ChartsApi.get_api_charts_by_chart_id_reports_by_category_json, the character length must be great than or equal to 1.'
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/by-category.json'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'category'] = opts[:'category'] if !opts[:'category'].nil?
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_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: ChartsApi#get_api_charts_by_chart_id_reports_by_category_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart report by category key (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :category_key Only this categoryKey bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_by_category_key_csv(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_by_category_key_csv_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart report by category key (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :category_key Only this categoryKey bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_by_category_key_csv_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_by_category_key_csv ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_category_key_csv"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_category_key_csv, must conform to the pattern #{pattern}."
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'category_key'].nil? && opts[:'category_key'].to_s.length > 128
+        fail ArgumentError, 'invalid value for "opts[:"category_key"]" when calling ChartsApi.get_api_charts_by_chart_id_reports_by_category_key_csv, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'category_key'].nil? && opts[:'category_key'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"category_key"]" when calling ChartsApi.get_api_charts_by_chart_id_reports_by_category_key_csv, the character length must be great than or equal to 1.'
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/by-category-key.csv'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'categoryKey'] = opts[:'category_key'] if !opts[:'category_key'].nil?
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_by_category_key_csv",
+        :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: ChartsApi#get_api_charts_by_chart_id_reports_by_category_key_csv\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart report by category key
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :category_key Only this categoryKey bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_by_category_key_json(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_by_category_key_json_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart report by category key
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :category_key Only this categoryKey bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_by_category_key_json_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_by_category_key_json ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_category_key_json, must conform to the pattern #{pattern}."
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'category_key'].nil? && opts[:'category_key'].to_s.length > 128
+        fail ArgumentError, 'invalid value for "opts[:"category_key"]" when calling ChartsApi.get_api_charts_by_chart_id_reports_by_category_key_json, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'category_key'].nil? && opts[:'category_key'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"category_key"]" when calling ChartsApi.get_api_charts_by_chart_id_reports_by_category_key_json, the character length must be great than or equal to 1.'
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/by-category-key.json'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'categoryKey'] = opts[:'category_key'] if !opts[:'category_key'].nil?
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_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: ChartsApi#get_api_charts_by_chart_id_reports_by_category_key_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart report by category label (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :category_label Only this categoryLabel bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_by_category_label_csv(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_by_category_label_csv_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart report by category label (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :category_label Only this categoryLabel bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_by_category_label_csv_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_by_category_label_csv ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_category_label_csv"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_category_label_csv, must conform to the pattern #{pattern}."
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'category_label'].nil? && opts[:'category_label'].to_s.length > 128
+        fail ArgumentError, 'invalid value for "opts[:"category_label"]" when calling ChartsApi.get_api_charts_by_chart_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_label'].nil? && opts[:'category_label'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"category_label"]" when calling ChartsApi.get_api_charts_by_chart_id_reports_by_category_label_csv, the character length must be great than or equal to 1.'
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/by-category-label.csv'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'categoryLabel'] = opts[:'category_label'] if !opts[:'category_label'].nil?
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_by_category_label_csv",
+        :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: ChartsApi#get_api_charts_by_chart_id_reports_by_category_label_csv\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart report by category label
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :category_label Only this categoryLabel bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_by_category_label_json(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_by_category_label_json_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart report by category label
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :category_label Only this categoryLabel bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_by_category_label_json_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_by_category_label_json ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_category_label_json, must conform to the pattern #{pattern}."
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'category_label'].nil? && opts[:'category_label'].to_s.length > 128
+        fail ArgumentError, 'invalid value for "opts[:"category_label"]" when calling ChartsApi.get_api_charts_by_chart_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_label'].nil? && opts[:'category_label'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"category_label"]" when calling ChartsApi.get_api_charts_by_chart_id_reports_by_category_label_json, the character length must be great than or equal to 1.'
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/by-category-label.json'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'categoryLabel'] = opts[:'category_label'] if !opts[:'category_label'].nil?
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_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: ChartsApi#get_api_charts_by_chart_id_reports_by_category_label_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart report by label (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :label Only this label bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_by_label_csv(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_by_label_csv_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart report by label (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :label Only this label bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_by_label_csv_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_by_label_csv ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_label_csv"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_label_csv, must conform to the pattern #{pattern}."
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'label'].nil? && opts[:'label'].to_s.length > 128
+        fail ArgumentError, 'invalid value for "opts[:"label"]" when calling ChartsApi.get_api_charts_by_chart_id_reports_by_label_csv, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'label'].nil? && opts[:'label'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"label"]" when calling ChartsApi.get_api_charts_by_chart_id_reports_by_label_csv, the character length must be great than or equal to 1.'
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/by-label.csv'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'label'] = opts[:'label'] if !opts[:'label'].nil?
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_by_label_csv",
+        :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: ChartsApi#get_api_charts_by_chart_id_reports_by_label_csv\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart report by label
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :label Only this label bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_by_label_json(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_by_label_json_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart report by label
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :label Only this label bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_by_label_json_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_by_label_json ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_label_json, must conform to the pattern #{pattern}."
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'label'].nil? && opts[:'label'].to_s.length > 128
+        fail ArgumentError, 'invalid value for "opts[:"label"]" when calling ChartsApi.get_api_charts_by_chart_id_reports_by_label_json, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'label'].nil? && opts[:'label'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"label"]" when calling ChartsApi.get_api_charts_by_chart_id_reports_by_label_json, the character length must be great than or equal to 1.'
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/by-label.json'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'label'] = opts[:'label'] if !opts[:'label'].nil?
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_by_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: ChartsApi#get_api_charts_by_chart_id_reports_by_label_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart report by object type (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :object_type Only this objectType bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_by_object_type_csv(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_by_object_type_csv_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart report by object type (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :object_type Only this objectType bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_by_object_type_csv_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_by_object_type_csv ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_object_type_csv"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_object_type_csv, must conform to the pattern #{pattern}."
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'object_type'].nil? && opts[:'object_type'].to_s.length > 128
+        fail ArgumentError, 'invalid value for "opts[:"object_type"]" when calling ChartsApi.get_api_charts_by_chart_id_reports_by_object_type_csv, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'object_type'].nil? && opts[:'object_type'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"object_type"]" when calling ChartsApi.get_api_charts_by_chart_id_reports_by_object_type_csv, the character length must be great than or equal to 1.'
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/by-object-type.csv'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'objectType'] = opts[:'object_type'] if !opts[:'object_type'].nil?
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_by_object_type_csv",
+        :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: ChartsApi#get_api_charts_by_chart_id_reports_by_object_type_csv\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart report by object type
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :object_type Only this objectType bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_by_object_type_json(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_by_object_type_json_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart report by object type
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :object_type Only this objectType bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_by_object_type_json_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_by_object_type_json ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_object_type_json, must conform to the pattern #{pattern}."
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'object_type'].nil? && opts[:'object_type'].to_s.length > 128
+        fail ArgumentError, 'invalid value for "opts[:"object_type"]" when calling ChartsApi.get_api_charts_by_chart_id_reports_by_object_type_json, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'object_type'].nil? && opts[:'object_type'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"object_type"]" when calling ChartsApi.get_api_charts_by_chart_id_reports_by_object_type_json, the character length must be great than or equal to 1.'
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/by-object-type.json'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'objectType'] = opts[:'object_type'] if !opts[:'object_type'].nil?
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_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: ChartsApi#get_api_charts_by_chart_id_reports_by_object_type_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart report by section (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :section Only this section bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_by_section_csv(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_by_section_csv_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart report by section (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :section Only this section bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_by_section_csv_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_by_section_csv ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_section_csv"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_section_csv, must conform to the pattern #{pattern}."
+      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 ChartsApi.get_api_charts_by_chart_id_reports_by_section_csv, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'section'].nil? && opts[:'section'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"section"]" when calling ChartsApi.get_api_charts_by_chart_id_reports_by_section_csv, the character length must be great than or equal to 1.'
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/by-section.csv'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'section'] = opts[:'section'] if !opts[:'section'].nil?
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_by_section_csv",
+        :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: ChartsApi#get_api_charts_by_chart_id_reports_by_section_csv\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart report by section
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :section Only this section bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_by_section_json(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_by_section_json_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart report by section
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :section Only this section bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_by_section_json_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_by_section_json ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_section_json, must conform to the pattern #{pattern}."
+      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 ChartsApi.get_api_charts_by_chart_id_reports_by_section_json, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'section'].nil? && opts[:'section'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"section"]" when calling ChartsApi.get_api_charts_by_chart_id_reports_by_section_json, the character length must be great than or equal to 1.'
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/by-section.json'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'section'] = opts[:'section'] if !opts[:'section'].nil?
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_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: ChartsApi#get_api_charts_by_chart_id_reports_by_section_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart report by zone (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :zone Only this zone bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_by_zone_csv(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_by_zone_csv_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart report by zone (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :zone Only this zone bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_by_zone_csv_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_by_zone_csv ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_zone_csv"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_zone_csv, must conform to the pattern #{pattern}."
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'zone'].nil? && opts[:'zone'].to_s.length > 128
+        fail ArgumentError, 'invalid value for "opts[:"zone"]" when calling ChartsApi.get_api_charts_by_chart_id_reports_by_zone_csv, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'zone'].nil? && opts[:'zone'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"zone"]" when calling ChartsApi.get_api_charts_by_chart_id_reports_by_zone_csv, the character length must be great than or equal to 1.'
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/by-zone.csv'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'zone'] = opts[:'zone'] if !opts[:'zone'].nil?
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_by_zone_csv",
+        :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: ChartsApi#get_api_charts_by_chart_id_reports_by_zone_csv\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart report by zone
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :zone Only this zone bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_by_zone_json(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_by_zone_json_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart report by zone
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :zone Only this zone bucket.
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_by_zone_json_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_by_zone_json ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_by_zone_json, must conform to the pattern #{pattern}."
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'zone'].nil? && opts[:'zone'].to_s.length > 128
+        fail ArgumentError, 'invalid value for "opts[:"zone"]" when calling ChartsApi.get_api_charts_by_chart_id_reports_by_zone_json, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'zone'].nil? && opts[:'zone'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"zone"]" when calling ChartsApi.get_api_charts_by_chart_id_reports_by_zone_json, the character length must be great than or equal to 1.'
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/by-zone.json'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'zone'] = opts[:'zone'] if !opts[:'zone'].nil?
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_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: ChartsApi#get_api_charts_by_chart_id_reports_by_zone_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart summary by category (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. Buckets: `count` (places), `objects`, `seats`, `gaPlaces`, `byCategory`, `bySection`, `byZone`, `byObjectType`; `totals` sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_summary_by_category_csv(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_summary_by_category_csv_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart summary by category (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. Buckets: &#x60;count&#x60; (places), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byObjectType&#x60;; &#x60;totals&#x60; sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_summary_by_category_csv_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_summary_by_category_csv ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_summary_by_category_csv"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_summary_by_category_csv, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/summary/by-category.csv'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_summary_by_category_csv",
+        :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: ChartsApi#get_api_charts_by_chart_id_reports_summary_by_category_csv\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart summary by category
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. Buckets: `count` (places), `objects`, `seats`, `gaPlaces`, `byCategory`, `bySection`, `byZone`, `byObjectType`; `totals` sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_summary_by_category_json(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_summary_by_category_json_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart summary by category
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. Buckets: &#x60;count&#x60; (places), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byObjectType&#x60;; &#x60;totals&#x60; sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_summary_by_category_json_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_summary_by_category_json ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_summary_by_category_json, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/summary/by-category.json'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_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: ChartsApi#get_api_charts_by_chart_id_reports_summary_by_category_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart summary by category key (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. Buckets: `count` (places), `objects`, `seats`, `gaPlaces`, `byCategory`, `bySection`, `byZone`, `byObjectType`; `totals` sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_summary_by_category_key_csv(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_summary_by_category_key_csv_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart summary by category key (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. Buckets: &#x60;count&#x60; (places), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byObjectType&#x60;; &#x60;totals&#x60; sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_summary_by_category_key_csv_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_summary_by_category_key_csv ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_summary_by_category_key_csv"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_summary_by_category_key_csv, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/summary/by-category-key.csv'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_summary_by_category_key_csv",
+        :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: ChartsApi#get_api_charts_by_chart_id_reports_summary_by_category_key_csv\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart summary by category key
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. Buckets: `count` (places), `objects`, `seats`, `gaPlaces`, `byCategory`, `bySection`, `byZone`, `byObjectType`; `totals` sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_summary_by_category_key_json(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_summary_by_category_key_json_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart summary by category key
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. Buckets: &#x60;count&#x60; (places), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byObjectType&#x60;; &#x60;totals&#x60; sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_summary_by_category_key_json_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_summary_by_category_key_json ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_summary_by_category_key_json, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/summary/by-category-key.json'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_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: ChartsApi#get_api_charts_by_chart_id_reports_summary_by_category_key_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart summary by category label (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. Buckets: `count` (places), `objects`, `seats`, `gaPlaces`, `byCategory`, `bySection`, `byZone`, `byObjectType`; `totals` sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_summary_by_category_label_csv(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_summary_by_category_label_csv_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart summary by category label (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. Buckets: &#x60;count&#x60; (places), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byObjectType&#x60;; &#x60;totals&#x60; sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_summary_by_category_label_csv_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_summary_by_category_label_csv ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_summary_by_category_label_csv"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_summary_by_category_label_csv, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/summary/by-category-label.csv'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_summary_by_category_label_csv",
+        :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: ChartsApi#get_api_charts_by_chart_id_reports_summary_by_category_label_csv\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart summary by category label
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. Buckets: `count` (places), `objects`, `seats`, `gaPlaces`, `byCategory`, `bySection`, `byZone`, `byObjectType`; `totals` sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_summary_by_category_label_json(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_summary_by_category_label_json_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart summary by category label
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. Buckets: &#x60;count&#x60; (places), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byObjectType&#x60;; &#x60;totals&#x60; sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_summary_by_category_label_json_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_summary_by_category_label_json ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_summary_by_category_label_json, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/summary/by-category-label.json'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_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: ChartsApi#get_api_charts_by_chart_id_reports_summary_by_category_label_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart summary by object type (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. Buckets: `count` (places), `objects`, `seats`, `gaPlaces`, `byCategory`, `bySection`, `byZone`, `byObjectType`; `totals` sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_summary_by_object_type_csv(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_summary_by_object_type_csv_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart summary by object type (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. Buckets: &#x60;count&#x60; (places), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byObjectType&#x60;; &#x60;totals&#x60; sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_summary_by_object_type_csv_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_summary_by_object_type_csv ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_summary_by_object_type_csv"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_summary_by_object_type_csv, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/summary/by-object-type.csv'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_summary_by_object_type_csv",
+        :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: ChartsApi#get_api_charts_by_chart_id_reports_summary_by_object_type_csv\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart summary by object type
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. Buckets: `count` (places), `objects`, `seats`, `gaPlaces`, `byCategory`, `bySection`, `byZone`, `byObjectType`; `totals` sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_summary_by_object_type_json(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_summary_by_object_type_json_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart summary by object type
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. Buckets: &#x60;count&#x60; (places), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byObjectType&#x60;; &#x60;totals&#x60; sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_summary_by_object_type_json_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_summary_by_object_type_json ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_summary_by_object_type_json, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/summary/by-object-type.json'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_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: ChartsApi#get_api_charts_by_chart_id_reports_summary_by_object_type_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart summary by section (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. Buckets: `count` (places), `objects`, `seats`, `gaPlaces`, `byCategory`, `bySection`, `byZone`, `byObjectType`; `totals` sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_summary_by_section_csv(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_summary_by_section_csv_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart summary by section (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. Buckets: &#x60;count&#x60; (places), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byObjectType&#x60;; &#x60;totals&#x60; sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_summary_by_section_csv_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_summary_by_section_csv ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_summary_by_section_csv"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_summary_by_section_csv, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/summary/by-section.csv'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_summary_by_section_csv",
+        :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: ChartsApi#get_api_charts_by_chart_id_reports_summary_by_section_csv\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart summary by section
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. Buckets: `count` (places), `objects`, `seats`, `gaPlaces`, `byCategory`, `bySection`, `byZone`, `byObjectType`; `totals` sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_summary_by_section_json(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_summary_by_section_json_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart summary by section
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. Buckets: &#x60;count&#x60; (places), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byObjectType&#x60;; &#x60;totals&#x60; sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_summary_by_section_json_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_summary_by_section_json ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_summary_by_section_json, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/summary/by-section.json'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_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: ChartsApi#get_api_charts_by_chart_id_reports_summary_by_section_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart summary by zone (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. Buckets: `count` (places), `objects`, `seats`, `gaPlaces`, `byCategory`, `bySection`, `byZone`, `byObjectType`; `totals` sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_summary_by_zone_csv(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_summary_by_zone_csv_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart summary by zone (CSV)
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. Buckets: &#x60;count&#x60; (places), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byObjectType&#x60;; &#x60;totals&#x60; sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_summary_by_zone_csv_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_summary_by_zone_csv ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_summary_by_zone_csv"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_summary_by_zone_csv, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/summary/by-zone.csv'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_summary_by_zone_csv",
+        :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: ChartsApi#get_api_charts_by_chart_id_reports_summary_by_zone_csv\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart summary by zone
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: `objectId`, `label`, `objectType`, `category`, `section`, `zone`, `capacity` (1 per seat, places per GA area), `price` (catalog cents; null for GA), `categoryKey` (chart category id of `category`; the value itself when no category defines it). `published` is false when the chart has never been published (no rows). `?version=draft` reports the unpublished designer draft instead (404 `draft_not_found` when the chart has none): it reads only the draft row, never the published geometry or its caches; `version` echoes the reported version. Buckets: `count` (places), `objects`, `seats`, `gaPlaces`, `byCategory`, `bySection`, `byZone`, `byObjectType`; `totals` sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_reports_summary_by_zone_json(chart_id, opts = {})
+      get_api_charts_by_chart_id_reports_summary_by_zone_json_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart summary by zone
+    # Reads the published chart (seat and GA templates plus the published chart layout) — no event, no live state. Rows: &#x60;objectId&#x60;, &#x60;label&#x60;, &#x60;objectType&#x60;, &#x60;category&#x60;, &#x60;section&#x60;, &#x60;zone&#x60;, &#x60;capacity&#x60; (1 per seat, places per GA area), &#x60;price&#x60; (catalog cents; null for GA), &#x60;categoryKey&#x60; (chart category id of &#x60;category&#x60;; the value itself when no category defines it). &#x60;published&#x60; is false when the chart has never been published (no rows). &#x60;?version&#x3D;draft&#x60; reports the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when the chart has none): it reads only the draft row, never the published geometry or its caches; &#x60;version&#x60; echoes the reported version. Buckets: &#x60;count&#x60; (places), &#x60;objects&#x60;, &#x60;seats&#x60;, &#x60;gaPlaces&#x60;, &#x60;byCategory&#x60;, &#x60;bySection&#x60;, &#x60;byZone&#x60;, &#x60;byObjectType&#x60;; &#x60;totals&#x60; sums every bucket. 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 chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; (default) or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_reports_summary_by_zone_json_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_reports_summary_by_zone_json ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_reports_summary_by_zone_json, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/reports/summary/by-zone.json'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_reports_summary_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: ChartsApi#get_api_charts_by_chart_id_reports_summary_by_zone_json\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart thumbnail
+    # Preview image of a published version: the WebP/PNG the designer rendered at publish time, or a server-side placeholder (PNG: zone / section / GA outlines, decorative shapes and category-coloured seat dots; first floor of multi-floor maps) until a render is attached. `X-Thumbnail-Source` says which. With `?version=N` a designer thumbnail is served `Cache-Control: private, max-age=31536000, immutable`; placeholders are cached for 5 minutes. Without `version` the latest published state is returned with `no-cache` and an `ETag` (send `If-None-Match` for `304`). 404 when the chart was never published.
+    # @param chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Float] :version Version number (1-based).
+    # @return [nil]
+    def get_api_charts_by_chart_id_thumbnail(chart_id, opts = {})
+      get_api_charts_by_chart_id_thumbnail_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Chart thumbnail
+    # Preview image of a published version: the WebP/PNG the designer rendered at publish time, or a server-side placeholder (PNG: zone / section / GA outlines, decorative shapes and category-coloured seat dots; first floor of multi-floor maps) until a render is attached. &#x60;X-Thumbnail-Source&#x60; says which. With &#x60;?version&#x3D;N&#x60; a designer thumbnail is served &#x60;Cache-Control: private, max-age&#x3D;31536000, immutable&#x60;; placeholders are cached for 5 minutes. Without &#x60;version&#x60; the latest published state is returned with &#x60;no-cache&#x60; and an &#x60;ETag&#x60; (send &#x60;If-None-Match&#x60; for &#x60;304&#x60;). 404 when the chart was never published.
+    # @param chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Float] :version Version number (1-based).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_thumbnail_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_thumbnail ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_thumbnail"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_thumbnail, must conform to the pattern #{pattern}."
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'version'].nil? && opts[:'version'] > 2147483647
+        fail ArgumentError, 'invalid value for "opts[:"version"]" when calling ChartsApi.get_api_charts_by_chart_id_thumbnail, must be smaller than or equal to 2147483647.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'version'].nil? && opts[:'version'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"version"]" when calling ChartsApi.get_api_charts_by_chart_id_thumbnail, must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/charts/{chartId}/thumbnail'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_thumbnail",
+        :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: ChartsApi#get_api_charts_by_chart_id_thumbnail\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List published versions
+    # Immutable publish history, newest first, cursor-paginated (`limit` 1..100, default 20; pass `nextCursor` back as `cursor`). Every successful `POST /api/charts/:chartId/map/publish` appends one version. Snapshots are content-addressed: republishing or restoring identical content reuses the stored geometry (same `geometryHash`) instead of duplicating it. Charts published before history existed get a `baseline` version 1 on their next publish.
+    # @param chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Float] :limit Page size (1..100, default 20).
+    # @option opts [String] :cursor Opaque &#x60;nextCursor&#x60; value from the previous page.
+    # @return [GetApiChartsByChartIdVersions200Response]
+    def get_api_charts_by_chart_id_versions(chart_id, opts = {})
+      data, _status_code, _headers = get_api_charts_by_chart_id_versions_with_http_info(chart_id, opts)
+      data
+    end
+
+    # List published versions
+    # Immutable publish history, newest first, cursor-paginated (&#x60;limit&#x60; 1..100, default 20; pass &#x60;nextCursor&#x60; back as &#x60;cursor&#x60;). Every successful &#x60;POST /api/charts/:chartId/map/publish&#x60; appends one version. Snapshots are content-addressed: republishing or restoring identical content reuses the stored geometry (same &#x60;geometryHash&#x60;) instead of duplicating it. Charts published before history existed get a &#x60;baseline&#x60; version 1 on their next publish.
+    # @param chart_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Float] :limit Page size (1..100, default 20).
+    # @option opts [String] :cursor Opaque &#x60;nextCursor&#x60; value from the previous page.
+    # @return [Array<(GetApiChartsByChartIdVersions200Response, Integer, Hash)>] GetApiChartsByChartIdVersions200Response data, response status code and response headers
+    def get_api_charts_by_chart_id_versions_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_versions ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_versions"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_versions, must conform to the pattern #{pattern}."
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling ChartsApi.get_api_charts_by_chart_id_versions, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling ChartsApi.get_api_charts_by_chart_id_versions, must be greater than or equal to 1.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'cursor'].nil? && opts[:'cursor'].to_s.length > 512
+        fail ArgumentError, 'invalid value for "opts[:"cursor"]" when calling ChartsApi.get_api_charts_by_chart_id_versions, the character length must be smaller than or equal to 512.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'cursor'].nil? && opts[:'cursor'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"cursor"]" when calling ChartsApi.get_api_charts_by_chart_id_versions, the character length must be great than or equal to 1.'
+      end
+
+      pattern = Regexp.new(/^[A-Za-z0-9_-]+$/)
+      if @api_client.config.client_side_validation && !opts[:'cursor'].nil? && opts[:'cursor'] !~ pattern
+        fail ArgumentError, "invalid value for 'opts[:\"cursor\"]' when calling ChartsApi.get_api_charts_by_chart_id_versions, must conform to the pattern #{pattern}."
+      end
+
+      # resource path
+      local_var_path = '/api/charts/{chartId}/versions'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'cursor'] = opts[:'cursor'] if !opts[:'cursor'].nil?
+
+      # header parameters
+      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']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GetApiChartsByChartIdVersions200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ChartsApi.get_api_charts_by_chart_id_versions",
+        :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: ChartsApi#get_api_charts_by_chart_id_versions\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List the zones of a chart
+    # Zones (named areas above sections) of the **published** chart by default, in drawing order: `{ id, name, color, floorId, focalPoint, bounds, points }`. `focalPoint` is the zone's Best Available ranking origin (null: the chart focal point applies). `?version=draft` reads the unpublished designer draft instead (404 `draft_not_found` when there is none), so the published chart stays readable while a draft exists. Only the zone shapes are read (projected in PostgreSQL). Object counts per zone: `GET /charts/{chartId}/reports/by-zone.json`. Requires read access.
+    # @param chart_id [String] Chart id (UUID) or chart key.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [nil]
+    def get_api_charts_by_chart_id_zones(chart_id, opts = {})
+      get_api_charts_by_chart_id_zones_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # List the zones of a chart
+    # Zones (named areas above sections) of the **published** chart by default, in drawing order: &#x60;{ id, name, color, floorId, focalPoint, bounds, points }&#x60;. &#x60;focalPoint&#x60; is the zone&#39;s Best Available ranking origin (null: the chart focal point applies). &#x60;?version&#x3D;draft&#x60; reads the unpublished designer draft instead (404 &#x60;draft_not_found&#x60; when there is none), so the published chart stays readable while a draft exists. Only the zone shapes are read (projected in PostgreSQL). Object counts per zone: &#x60;GET /charts/{chartId}/reports/by-zone.json&#x60;. Requires read access.
+    # @param chart_id [String] Chart id (UUID) or chart key.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; or &#x60;draft&#x60; (the unpublished designer draft).
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_by_chart_id_zones_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_by_chart_id_zones ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_zones"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.get_api_charts_by_chart_id_zones, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/{chartId}/zones'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].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 => :"ChartsApi.get_api_charts_by_chart_id_zones",
+        :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: ChartsApi#get_api_charts_by_chart_id_zones\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List chart tags
+    # Every tag used by the tenant's charts with the number of charts carrying it, sorted case-insensitively (at most 500). Tags are case-insensitive: `VIP` and `vip` are the same tag; the returned spelling is the lexicographically smallest stored variant. Counts respect the `archived` filter (archived charts are excluded by default).
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :archived &#x60;false&#x60; (default) hides archived charts, &#x60;true&#x60; returns only archived charts, &#x60;all&#x60; returns both.
+    # @return [nil]
+    def get_api_charts_tags(opts = {})
+      get_api_charts_tags_with_http_info(opts)
+      nil
+    end
+
+    # List chart tags
+    # Every tag used by the tenant&#39;s charts with the number of charts carrying it, sorted case-insensitively (at most 500). Tags are case-insensitive: &#x60;VIP&#x60; and &#x60;vip&#x60; are the same tag; the returned spelling is the lexicographically smallest stored variant. Counts respect the &#x60;archived&#x60; filter (archived charts are excluded by default).
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :archived &#x60;false&#x60; (default) hides archived charts, &#x60;true&#x60; returns only archived charts, &#x60;all&#x60; returns both.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_charts_tags_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.get_api_charts_tags ...'
+      end
+      allowable_values = ["false", "true", "all"]
+      if @api_client.config.client_side_validation && opts[:'archived'] && !allowable_values.include?(opts[:'archived'])
+        fail ArgumentError, "invalid value for \"archived\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/charts/tags'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'archived'] = opts[:'archived'] if !opts[:'archived'].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 => :"ChartsApi.get_api_charts_tags",
+        :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: ChartsApi#get_api_charts_tags\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Update chart name or key
+    # Updates the display name and/or the partner `key` of a reusable seating chart (at least one of them). Keys are unique per workspace, URL-safe and never UUID-shaped; after a rename the old key stops resolving (every API instance within 5 s).
+    # @param chart_id [String] Chart id (UUID) or chart key.
+    # @param patch_api_charts_by_chart_id_request [PatchApiChartsByChartIdRequest] 
+    # @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 patch_api_charts_by_chart_id(chart_id, patch_api_charts_by_chart_id_request, opts = {})
+      patch_api_charts_by_chart_id_with_http_info(chart_id, patch_api_charts_by_chart_id_request, opts)
+      nil
+    end
+
+    # Update chart name or key
+    # Updates the display name and/or the partner &#x60;key&#x60; of a reusable seating chart (at least one of them). Keys are unique per workspace, URL-safe and never UUID-shaped; after a rename the old key stops resolving (every API instance within 5 s).
+    # @param chart_id [String] Chart id (UUID) or chart key.
+    # @param patch_api_charts_by_chart_id_request [PatchApiChartsByChartIdRequest] 
+    # @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 patch_api_charts_by_chart_id_with_http_info(chart_id, patch_api_charts_by_chart_id_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.patch_api_charts_by_chart_id ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.patch_api_charts_by_chart_id"
+      end
+      if @api_client.config.client_side_validation && chart_id.to_s.length > 36
+        fail ArgumentError, 'invalid value for "chart_id" when calling ChartsApi.patch_api_charts_by_chart_id, the character length must be smaller than or equal to 36.'
+      end
+
+      if @api_client.config.client_side_validation && chart_id.to_s.length < 36
+        fail ArgumentError, 'invalid value for "chart_id" when calling ChartsApi.patch_api_charts_by_chart_id, the character length must be great than or equal to 36.'
+      end
+
+      # verify the required parameter 'patch_api_charts_by_chart_id_request' is set
+      if @api_client.config.client_side_validation && patch_api_charts_by_chart_id_request.nil?
+        fail ArgumentError, "Missing the required parameter 'patch_api_charts_by_chart_id_request' when calling ChartsApi.patch_api_charts_by_chart_id"
+      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 ChartsApi.patch_api_charts_by_chart_id, 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 ChartsApi.patch_api_charts_by_chart_id, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/charts/{chartId}'.sub('{' + 'chartId' + '}', CGI.escape(chart_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(patch_api_charts_by_chart_id_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ChartsApi.patch_api_charts_by_chart_id",
+        :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(:PATCH, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ChartsApi#patch_api_charts_by_chart_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Create chart
+    # Creates a reusable seating chart. Optional in the same call: `key` (partner key, unique per workspace, usable wherever a chart id is accepted; 409 `chart_key_taken`), `venueType` (`simple` | `sections` | `zones`, the designer template) and `categories` (up to 128 `{ key?, label, color, accessible? }`; keys and labels unique, case-insensitive). With `venueType` or `categories` an initial draft holding them is written in the same transaction (`hasDraft: true`). Author geometry via `PUT /api/charts/:chartId/map/draft` and publish before attaching to events.
+    # @param post_api_charts_request [PostApiChartsRequest] 
+    # @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_charts(post_api_charts_request, opts = {})
+      post_api_charts_with_http_info(post_api_charts_request, opts)
+      nil
+    end
+
+    # Create chart
+    # Creates a reusable seating chart. Optional in the same call: &#x60;key&#x60; (partner key, unique per workspace, usable wherever a chart id is accepted; 409 &#x60;chart_key_taken&#x60;), &#x60;venueType&#x60; (&#x60;simple&#x60; | &#x60;sections&#x60; | &#x60;zones&#x60;, the designer template) and &#x60;categories&#x60; (up to 128 &#x60;{ key?, label, color, accessible? }&#x60;; keys and labels unique, case-insensitive). With &#x60;venueType&#x60; or &#x60;categories&#x60; an initial draft holding them is written in the same transaction (&#x60;hasDraft: true&#x60;). Author geometry via &#x60;PUT /api/charts/:chartId/map/draft&#x60; and publish before attaching to events.
+    # @param post_api_charts_request [PostApiChartsRequest] 
+    # @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_charts_with_http_info(post_api_charts_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.post_api_charts ...'
+      end
+      # verify the required parameter 'post_api_charts_request' is set
+      if @api_client.config.client_side_validation && post_api_charts_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_charts_request' when calling ChartsApi.post_api_charts"
+      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 ChartsApi.post_api_charts, 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 ChartsApi.post_api_charts, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/charts'
+
+      # 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_charts_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ChartsApi.post_api_charts",
+        :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: ChartsApi#post_api_charts\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Archive chart
+    # Soft-deletes a chart: it is hidden from `GET /api/charts` and `GET /api/charts/tags` unless `archived=true|all` is sent. Events created from the chart keep serving their maps and inventory unchanged, and the chart can still be opened, edited and published by id. Idempotent — archiving an archived chart keeps its original `archivedAt`. Permanent deletion (`DELETE /api/charts/:chartId`) is only allowed for archived charts without events.
+    # @param chart_id [String] 
+    # @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 [PostApiChartsByChartIdActionsArchive200Response]
+    def post_api_charts_by_chart_id_actions_archive(chart_id, opts = {})
+      data, _status_code, _headers = post_api_charts_by_chart_id_actions_archive_with_http_info(chart_id, opts)
+      data
+    end
+
+    # Archive chart
+    # Soft-deletes a chart: it is hidden from &#x60;GET /api/charts&#x60; and &#x60;GET /api/charts/tags&#x60; unless &#x60;archived&#x3D;true|all&#x60; is sent. Events created from the chart keep serving their maps and inventory unchanged, and the chart can still be opened, edited and published by id. Idempotent — archiving an archived chart keeps its original &#x60;archivedAt&#x60;. Permanent deletion (&#x60;DELETE /api/charts/:chartId&#x60;) is only allowed for archived charts without events.
+    # @param chart_id [String] 
+    # @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<(PostApiChartsByChartIdActionsArchive200Response, Integer, Hash)>] PostApiChartsByChartIdActionsArchive200Response data, response status code and response headers
+    def post_api_charts_by_chart_id_actions_archive_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.post_api_charts_by_chart_id_actions_archive ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.post_api_charts_by_chart_id_actions_archive"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.post_api_charts_by_chart_id_actions_archive, must conform to the pattern #{pattern}."
+      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 ChartsApi.post_api_charts_by_chart_id_actions_archive, 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 ChartsApi.post_api_charts_by_chart_id_actions_archive, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/charts/{chartId}/actions/archive'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      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']
+      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]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'PostApiChartsByChartIdActionsArchive200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ChartsApi.post_api_charts_by_chart_id_actions_archive",
+        :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: ChartsApi#post_api_charts_by_chart_id_actions_archive\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Copy a chart to another workspace
+    # Copies the chart (its draft, else the published map) into another workspace as a new **unpublished** chart with fresh object ids. Callers: a dashboard session, or a **workspace admin API key** (`POST /api/keys` with `workspaceAdmin: true`; a scoped key also needs `charts_write`) — other API keys get 403 `ERR_PARTNER_SCOPE`. The user (for a key: the admin it is bound to, re-checked on every call) must be an **admin of both workspaces** (403 `ERR_FORBIDDEN_ROLE`). The target must be active (409 `workspace_deactivated`) and within its plan's chart limit. Both workspaces get a `chart.copy_to_workspace` audit entry; the target also gets `chart.created`. Same workspace: use `POST /charts/{chartId}/duplicate` (400).
+    # @param chart_id [String] 
+    # @param post_api_charts_by_chart_id_actions_copy_to_workspace_request [PostApiChartsByChartIdActionsCopyToWorkspaceRequest] 
+    # @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_charts_by_chart_id_actions_copy_to_workspace(chart_id, post_api_charts_by_chart_id_actions_copy_to_workspace_request, opts = {})
+      post_api_charts_by_chart_id_actions_copy_to_workspace_with_http_info(chart_id, post_api_charts_by_chart_id_actions_copy_to_workspace_request, opts)
+      nil
+    end
+
+    # Copy a chart to another workspace
+    # Copies the chart (its draft, else the published map) into another workspace as a new **unpublished** chart with fresh object ids. Callers: a dashboard session, or a **workspace admin API key** (&#x60;POST /api/keys&#x60; with &#x60;workspaceAdmin: true&#x60;; a scoped key also needs &#x60;charts_write&#x60;) — other API keys get 403 &#x60;ERR_PARTNER_SCOPE&#x60;. The user (for a key: the admin it is bound to, re-checked on every call) must be an **admin of both workspaces** (403 &#x60;ERR_FORBIDDEN_ROLE&#x60;). The target must be active (409 &#x60;workspace_deactivated&#x60;) and within its plan&#39;s chart limit. Both workspaces get a &#x60;chart.copy_to_workspace&#x60; audit entry; the target also gets &#x60;chart.created&#x60;. Same workspace: use &#x60;POST /charts/{chartId}/duplicate&#x60; (400).
+    # @param chart_id [String] 
+    # @param post_api_charts_by_chart_id_actions_copy_to_workspace_request [PostApiChartsByChartIdActionsCopyToWorkspaceRequest] 
+    # @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_charts_by_chart_id_actions_copy_to_workspace_with_http_info(chart_id, post_api_charts_by_chart_id_actions_copy_to_workspace_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.post_api_charts_by_chart_id_actions_copy_to_workspace ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.post_api_charts_by_chart_id_actions_copy_to_workspace"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.post_api_charts_by_chart_id_actions_copy_to_workspace, must conform to the pattern #{pattern}."
+      end
+
+      # verify the required parameter 'post_api_charts_by_chart_id_actions_copy_to_workspace_request' is set
+      if @api_client.config.client_side_validation && post_api_charts_by_chart_id_actions_copy_to_workspace_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_charts_by_chart_id_actions_copy_to_workspace_request' when calling ChartsApi.post_api_charts_by_chart_id_actions_copy_to_workspace"
+      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 ChartsApi.post_api_charts_by_chart_id_actions_copy_to_workspace, 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 ChartsApi.post_api_charts_by_chart_id_actions_copy_to_workspace, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/charts/{chartId}/actions/copy-to-workspace'.sub('{' + 'chartId' + '}', CGI.escape(chart_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_charts_by_chart_id_actions_copy_to_workspace_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ChartsApi.post_api_charts_by_chart_id_actions_copy_to_workspace",
+        :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: ChartsApi#post_api_charts_by_chart_id_actions_copy_to_workspace\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Unarchive chart
+    # Returns an archived chart to the default chart lists. Idempotent for charts that are not archived.
+    # @param chart_id [String] 
+    # @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 [PostApiChartsByChartIdActionsArchive200Response]
+    def post_api_charts_by_chart_id_actions_unarchive(chart_id, opts = {})
+      data, _status_code, _headers = post_api_charts_by_chart_id_actions_unarchive_with_http_info(chart_id, opts)
+      data
+    end
+
+    # Unarchive chart
+    # Returns an archived chart to the default chart lists. Idempotent for charts that are not archived.
+    # @param chart_id [String] 
+    # @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<(PostApiChartsByChartIdActionsArchive200Response, Integer, Hash)>] PostApiChartsByChartIdActionsArchive200Response data, response status code and response headers
+    def post_api_charts_by_chart_id_actions_unarchive_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.post_api_charts_by_chart_id_actions_unarchive ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.post_api_charts_by_chart_id_actions_unarchive"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.post_api_charts_by_chart_id_actions_unarchive, must conform to the pattern #{pattern}."
+      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 ChartsApi.post_api_charts_by_chart_id_actions_unarchive, 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 ChartsApi.post_api_charts_by_chart_id_actions_unarchive, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/charts/{chartId}/actions/unarchive'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      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']
+      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]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'PostApiChartsByChartIdActionsArchive200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ChartsApi.post_api_charts_by_chart_id_actions_unarchive",
+        :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: ChartsApi#post_api_charts_by_chart_id_actions_unarchive\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Validate a chart map (dry run)
+    # Runs the exact validation that `POST /charts/{chartId}/map/publish` applies (payload limits, the designer rules at the workspace severity — see `GET /api/workspace/chart-validation` — and seat-id ownership) **without writing anything**. Without a body the current draft (or, when there is none, the published map) is validated; `?version=published` validates the published chart even while a draft exists and `?version=draft` only the draft (404 `not_published` / `draft_not_found` when that version does not exist). With a body `{ seats, shapes?, background?, reference? }` (same shape as PUT …/map/draft) that content is validated instead (`version` is ignored). Always 200 with `publishable`, counts and `issues[]` (`{ code, severity, objectIds, message, count }`). Requires read access.
+    # @param chart_id [String] 
+    # @param post_api_charts_by_chart_id_actions_validate_request [PostApiChartsByChartIdActionsValidateRequest] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; or &#x60;draft&#x60;. Omitted: the draft when there is one, else the published map.
+    # @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_charts_by_chart_id_actions_validate(chart_id, post_api_charts_by_chart_id_actions_validate_request, opts = {})
+      post_api_charts_by_chart_id_actions_validate_with_http_info(chart_id, post_api_charts_by_chart_id_actions_validate_request, opts)
+      nil
+    end
+
+    # Validate a chart map (dry run)
+    # Runs the exact validation that &#x60;POST /charts/{chartId}/map/publish&#x60; applies (payload limits, the designer rules at the workspace severity — see &#x60;GET /api/workspace/chart-validation&#x60; — and seat-id ownership) **without writing anything**. Without a body the current draft (or, when there is none, the published map) is validated; &#x60;?version&#x3D;published&#x60; validates the published chart even while a draft exists and &#x60;?version&#x3D;draft&#x60; only the draft (404 &#x60;not_published&#x60; / &#x60;draft_not_found&#x60; when that version does not exist). With a body &#x60;{ seats, shapes?, background?, reference? }&#x60; (same shape as PUT …/map/draft) that content is validated instead (&#x60;version&#x60; is ignored). Always 200 with &#x60;publishable&#x60;, counts and &#x60;issues[]&#x60; (&#x60;{ code, severity, objectIds, message, count }&#x60;). Requires read access.
+    # @param chart_id [String] 
+    # @param post_api_charts_by_chart_id_actions_validate_request [PostApiChartsByChartIdActionsValidateRequest] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :version &#x60;published&#x60; or &#x60;draft&#x60;. Omitted: the draft when there is one, else the published map.
+    # @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_charts_by_chart_id_actions_validate_with_http_info(chart_id, post_api_charts_by_chart_id_actions_validate_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.post_api_charts_by_chart_id_actions_validate ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.post_api_charts_by_chart_id_actions_validate"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.post_api_charts_by_chart_id_actions_validate, must conform to the pattern #{pattern}."
+      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 ChartsApi.post_api_charts_by_chart_id_actions_validate"
+      end
+      allowable_values = ["published", "draft"]
+      if @api_client.config.client_side_validation && opts[:'version'] && !allowable_values.include?(opts[:'version'])
+        fail ArgumentError, "invalid value for \"version\", must be one of #{allowable_values}"
+      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 ChartsApi.post_api_charts_by_chart_id_actions_validate, 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 ChartsApi.post_api_charts_by_chart_id_actions_validate, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/charts/{chartId}/actions/validate'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].nil?
+
+      # 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_charts_by_chart_id_actions_validate_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ChartsApi.post_api_charts_by_chart_id_actions_validate",
+        :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: ChartsApi#post_api_charts_by_chart_id_actions_validate\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Duplicate chart
+    # Creates a new unpublished chart draft copied from the source chart (seats, GA areas, shapes, images).
+    # @param chart_id [String] 
+    # @param post_api_charts_by_chart_id_duplicate_request [PostApiChartsByChartIdDuplicateRequest] 
+    # @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_charts_by_chart_id_duplicate(chart_id, post_api_charts_by_chart_id_duplicate_request, opts = {})
+      post_api_charts_by_chart_id_duplicate_with_http_info(chart_id, post_api_charts_by_chart_id_duplicate_request, opts)
+      nil
+    end
+
+    # Duplicate chart
+    # Creates a new unpublished chart draft copied from the source chart (seats, GA areas, shapes, images).
+    # @param chart_id [String] 
+    # @param post_api_charts_by_chart_id_duplicate_request [PostApiChartsByChartIdDuplicateRequest] 
+    # @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_charts_by_chart_id_duplicate_with_http_info(chart_id, post_api_charts_by_chart_id_duplicate_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.post_api_charts_by_chart_id_duplicate ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.post_api_charts_by_chart_id_duplicate"
+      end
+      if @api_client.config.client_side_validation && chart_id.to_s.length > 36
+        fail ArgumentError, 'invalid value for "chart_id" when calling ChartsApi.post_api_charts_by_chart_id_duplicate, the character length must be smaller than or equal to 36.'
+      end
+
+      if @api_client.config.client_side_validation && chart_id.to_s.length < 36
+        fail ArgumentError, 'invalid value for "chart_id" when calling ChartsApi.post_api_charts_by_chart_id_duplicate, the character length must be great than or equal to 36.'
+      end
+
+      # verify the required parameter 'post_api_charts_by_chart_id_duplicate_request' is set
+      if @api_client.config.client_side_validation && post_api_charts_by_chart_id_duplicate_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_charts_by_chart_id_duplicate_request' when calling ChartsApi.post_api_charts_by_chart_id_duplicate"
+      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 ChartsApi.post_api_charts_by_chart_id_duplicate, 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 ChartsApi.post_api_charts_by_chart_id_duplicate, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/charts/{chartId}/duplicate'.sub('{' + 'chartId' + '}', CGI.escape(chart_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_charts_by_chart_id_duplicate_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ChartsApi.post_api_charts_by_chart_id_duplicate",
+        :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: ChartsApi#post_api_charts_by_chart_id_duplicate\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Discard chart draft
+    # Throws away unpublished draft changes; `GET .../map/draft` then returns the published map again. The published map, versions and linked events are untouched. `409 ERR_DRAFT_NOTHING_TO_DISCARD` when the draft has no unpublished changes, `409 ERR_MAP_NEVER_PUBLISHED` when the chart was never published (there is no version to reset to).
+    # @param chart_id [String] 
+    # @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_charts_by_chart_id_map_draft_actions_discard(chart_id, opts = {})
+      post_api_charts_by_chart_id_map_draft_actions_discard_with_http_info(chart_id, opts)
+      nil
+    end
+
+    # Discard chart draft
+    # Throws away unpublished draft changes; &#x60;GET .../map/draft&#x60; then returns the published map again. The published map, versions and linked events are untouched. &#x60;409 ERR_DRAFT_NOTHING_TO_DISCARD&#x60; when the draft has no unpublished changes, &#x60;409 ERR_MAP_NEVER_PUBLISHED&#x60; when the chart was never published (there is no version to reset to).
+    # @param chart_id [String] 
+    # @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_charts_by_chart_id_map_draft_actions_discard_with_http_info(chart_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.post_api_charts_by_chart_id_map_draft_actions_discard ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.post_api_charts_by_chart_id_map_draft_actions_discard"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.post_api_charts_by_chart_id_map_draft_actions_discard, must conform to the pattern #{pattern}."
+      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 ChartsApi.post_api_charts_by_chart_id_map_draft_actions_discard, 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 ChartsApi.post_api_charts_by_chart_id_map_draft_actions_discard, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/charts/{chartId}/map/draft/actions/discard'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      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]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ChartsApi.post_api_charts_by_chart_id_map_draft_actions_discard",
+        :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: ChartsApi#post_api_charts_by_chart_id_map_draft_actions_discard\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Publish chart map template
+    # Promotes draft → `chart_seat_templates` + `chart_layouts`. Events clone templates on create.  The draft is validated with the same rules the designer runs, at the **workspace severity** (`GET /api/workspace/chart-validation`; rules set to `off` are skipped). Error-level issues return `422 { error: \"validation_failed\", issues: [{ code, severity, objectIds, message, count, scope? }] }` (warnings included); warning-level issues do not block and are returned in `warnings`. Per-rule counts are stored with the version, so `GET /api/charts` (`validation`) and event creation (409 `chart_invalid`) never re-run the rules.  Every successful publish appends an immutable version (`version`, `geometryHash`; `sameAsVersion` names an earlier version with identical content, e.g. after a restore). An optional JSON body `{ \"note\": \"...\" }` (≤ 280 chars) is stored on the version. See `GET /api/charts/:chartId/versions`. Emits the `chart.published` webhook. Use `POST /api/charts/:chartId/actions/validate` for a dry run.  With `{ \"autoPublish\": true }` (designer auto-publish, off by default) the publish only runs while no event uses the chart; otherwise 409 `{ code: \"ERR_AUTO_PUBLISH_CHART_HAS_EVENTS\", params: { eventCount } }`.
+    # @param chart_id [String] 
+    # @param post_api_charts_by_chart_id_map_publish_request [PostApiChartsByChartIdMapPublishRequest] 
+    # @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_charts_by_chart_id_map_publish(chart_id, post_api_charts_by_chart_id_map_publish_request, opts = {})
+      post_api_charts_by_chart_id_map_publish_with_http_info(chart_id, post_api_charts_by_chart_id_map_publish_request, opts)
+      nil
+    end
+
+    # Publish chart map template
+    # Promotes draft → &#x60;chart_seat_templates&#x60; + &#x60;chart_layouts&#x60;. Events clone templates on create.  The draft is validated with the same rules the designer runs, at the **workspace severity** (&#x60;GET /api/workspace/chart-validation&#x60;; rules set to &#x60;off&#x60; are skipped). Error-level issues return &#x60;422 { error: \&quot;validation_failed\&quot;, issues: [{ code, severity, objectIds, message, count, scope? }] }&#x60; (warnings included); warning-level issues do not block and are returned in &#x60;warnings&#x60;. Per-rule counts are stored with the version, so &#x60;GET /api/charts&#x60; (&#x60;validation&#x60;) and event creation (409 &#x60;chart_invalid&#x60;) never re-run the rules.  Every successful publish appends an immutable version (&#x60;version&#x60;, &#x60;geometryHash&#x60;; &#x60;sameAsVersion&#x60; names an earlier version with identical content, e.g. after a restore). An optional JSON body &#x60;{ \&quot;note\&quot;: \&quot;...\&quot; }&#x60; (≤ 280 chars) is stored on the version. See &#x60;GET /api/charts/:chartId/versions&#x60;. Emits the &#x60;chart.published&#x60; webhook. Use &#x60;POST /api/charts/:chartId/actions/validate&#x60; for a dry run.  With &#x60;{ \&quot;autoPublish\&quot;: true }&#x60; (designer auto-publish, off by default) the publish only runs while no event uses the chart; otherwise 409 &#x60;{ code: \&quot;ERR_AUTO_PUBLISH_CHART_HAS_EVENTS\&quot;, params: { eventCount } }&#x60;.
+    # @param chart_id [String] 
+    # @param post_api_charts_by_chart_id_map_publish_request [PostApiChartsByChartIdMapPublishRequest] 
+    # @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_charts_by_chart_id_map_publish_with_http_info(chart_id, post_api_charts_by_chart_id_map_publish_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.post_api_charts_by_chart_id_map_publish ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.post_api_charts_by_chart_id_map_publish"
+      end
+      if @api_client.config.client_side_validation && chart_id.to_s.length > 36
+        fail ArgumentError, 'invalid value for "chart_id" when calling ChartsApi.post_api_charts_by_chart_id_map_publish, the character length must be smaller than or equal to 36.'
+      end
+
+      if @api_client.config.client_side_validation && chart_id.to_s.length < 36
+        fail ArgumentError, 'invalid value for "chart_id" when calling ChartsApi.post_api_charts_by_chart_id_map_publish, the character length must be great than or equal to 36.'
+      end
+
+      # verify the required parameter 'post_api_charts_by_chart_id_map_publish_request' is set
+      if @api_client.config.client_side_validation && post_api_charts_by_chart_id_map_publish_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_charts_by_chart_id_map_publish_request' when calling ChartsApi.post_api_charts_by_chart_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 ChartsApi.post_api_charts_by_chart_id_map_publish, 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 ChartsApi.post_api_charts_by_chart_id_map_publish, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/charts/{chartId}/map/publish'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      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] || @api_client.object_to_http_body(post_api_charts_by_chart_id_map_publish_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ChartsApi.post_api_charts_by_chart_id_map_publish",
+        :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: ChartsApi#post_api_charts_by_chart_id_map_publish\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Create a public preview link
+    # Signed, expiring link to a read-only rendering of the chart's **published** geometry (no login, no event data, no prices — category names and colors only). Response `{ chartId, exp, signature, expiresAt, path }`; `path` is relative to the dashboard origin (`/preview/charts/{chartId}?exp=…&sig=…`). The signature is an HMAC with a per-chart secret; every link of a chart stays valid until it expires or DELETE revokes them all. 409 `chart_not_published` when the chart was never published.
+    # @param chart_id [String] 
+    # @param post_api_charts_by_chart_id_preview_link_request [PostApiChartsByChartIdPreviewLinkRequest] 
+    # @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_charts_by_chart_id_preview_link(chart_id, post_api_charts_by_chart_id_preview_link_request, opts = {})
+      post_api_charts_by_chart_id_preview_link_with_http_info(chart_id, post_api_charts_by_chart_id_preview_link_request, opts)
+      nil
+    end
+
+    # Create a public preview link
+    # Signed, expiring link to a read-only rendering of the chart&#39;s **published** geometry (no login, no event data, no prices — category names and colors only). Response &#x60;{ chartId, exp, signature, expiresAt, path }&#x60;; &#x60;path&#x60; is relative to the dashboard origin (&#x60;/preview/charts/{chartId}?exp&#x3D;…&amp;sig&#x3D;…&#x60;). The signature is an HMAC with a per-chart secret; every link of a chart stays valid until it expires or DELETE revokes them all. 409 &#x60;chart_not_published&#x60; when the chart was never published.
+    # @param chart_id [String] 
+    # @param post_api_charts_by_chart_id_preview_link_request [PostApiChartsByChartIdPreviewLinkRequest] 
+    # @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_charts_by_chart_id_preview_link_with_http_info(chart_id, post_api_charts_by_chart_id_preview_link_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.post_api_charts_by_chart_id_preview_link ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.post_api_charts_by_chart_id_preview_link"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.post_api_charts_by_chart_id_preview_link, must conform to the pattern #{pattern}."
+      end
+
+      # verify the required parameter 'post_api_charts_by_chart_id_preview_link_request' is set
+      if @api_client.config.client_side_validation && post_api_charts_by_chart_id_preview_link_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_charts_by_chart_id_preview_link_request' when calling ChartsApi.post_api_charts_by_chart_id_preview_link"
+      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 ChartsApi.post_api_charts_by_chart_id_preview_link, 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 ChartsApi.post_api_charts_by_chart_id_preview_link, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/charts/{chartId}/preview-link'.sub('{' + 'chartId' + '}', CGI.escape(chart_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_charts_by_chart_id_preview_link_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ChartsApi.post_api_charts_by_chart_id_preview_link",
+        :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: ChartsApi#post_api_charts_by_chart_id_preview_link\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Restore a version into the draft
+    # Overwrites the chart draft with the content of a published version (seats, shapes, categories, images). It never publishes: the live map and linked events are untouched until `POST /api/charts/:chartId/map/publish`, which runs the normal validation and records a new version. Any unpublished draft changes are replaced. Requires map authoring rights (admin / map editor dashboard role or `x-api-key`).
+    # @param chart_id [String] 
+    # @param version [Float] Version number (1-based).
+    # @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_charts_by_chart_id_versions_by_version_actions_restore_to_draft(chart_id, version, opts = {})
+      post_api_charts_by_chart_id_versions_by_version_actions_restore_to_draft_with_http_info(chart_id, version, opts)
+      nil
+    end
+
+    # Restore a version into the draft
+    # Overwrites the chart draft with the content of a published version (seats, shapes, categories, images). It never publishes: the live map and linked events are untouched until &#x60;POST /api/charts/:chartId/map/publish&#x60;, which runs the normal validation and records a new version. Any unpublished draft changes are replaced. Requires map authoring rights (admin / map editor dashboard role or &#x60;x-api-key&#x60;).
+    # @param chart_id [String] 
+    # @param version [Float] Version number (1-based).
+    # @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_charts_by_chart_id_versions_by_version_actions_restore_to_draft_with_http_info(chart_id, version, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.post_api_charts_by_chart_id_versions_by_version_actions_restore_to_draft ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.post_api_charts_by_chart_id_versions_by_version_actions_restore_to_draft"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.post_api_charts_by_chart_id_versions_by_version_actions_restore_to_draft, must conform to the pattern #{pattern}."
+      end
+
+      # verify the required parameter 'version' is set
+      if @api_client.config.client_side_validation && version.nil?
+        fail ArgumentError, "Missing the required parameter 'version' when calling ChartsApi.post_api_charts_by_chart_id_versions_by_version_actions_restore_to_draft"
+      end
+      if @api_client.config.client_side_validation && version > 2147483647
+        fail ArgumentError, 'invalid value for "version" when calling ChartsApi.post_api_charts_by_chart_id_versions_by_version_actions_restore_to_draft, must be smaller than or equal to 2147483647.'
+      end
+
+      if @api_client.config.client_side_validation && version < 1
+        fail ArgumentError, 'invalid value for "version" when calling ChartsApi.post_api_charts_by_chart_id_versions_by_version_actions_restore_to_draft, must be greater than or equal to 1.'
+      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 ChartsApi.post_api_charts_by_chart_id_versions_by_version_actions_restore_to_draft, 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 ChartsApi.post_api_charts_by_chart_id_versions_by_version_actions_restore_to_draft, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/charts/{chartId}/versions/{version}/actions/restore-to-draft'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s)).sub('{' + 'version' + '}', CGI.escape(version.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      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]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ChartsApi.post_api_charts_by_chart_id_versions_by_version_actions_restore_to_draft",
+        :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: ChartsApi#post_api_charts_by_chart_id_versions_by_version_actions_restore_to_draft\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Save chart map draft
+    # Saves the designer draft (`draftUpdatedAt` in the response). With `baseDraftUpdatedAt` the save is conflict-safe: 409 `draft_conflict` (with the current `draftUpdatedAt`) when the draft changed since that version — used by the designer autosave.
+    # @param chart_id [String] 
+    # @param post_api_charts_by_chart_id_actions_validate_request [PostApiChartsByChartIdActionsValidateRequest] 
+    # @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_charts_by_chart_id_map_draft(chart_id, post_api_charts_by_chart_id_actions_validate_request, opts = {})
+      put_api_charts_by_chart_id_map_draft_with_http_info(chart_id, post_api_charts_by_chart_id_actions_validate_request, opts)
+      nil
+    end
+
+    # Save chart map draft
+    # Saves the designer draft (&#x60;draftUpdatedAt&#x60; in the response). 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 — used by the designer autosave.
+    # @param chart_id [String] 
+    # @param post_api_charts_by_chart_id_actions_validate_request [PostApiChartsByChartIdActionsValidateRequest] 
+    # @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_charts_by_chart_id_map_draft_with_http_info(chart_id, post_api_charts_by_chart_id_actions_validate_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.put_api_charts_by_chart_id_map_draft ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.put_api_charts_by_chart_id_map_draft"
+      end
+      if @api_client.config.client_side_validation && chart_id.to_s.length > 36
+        fail ArgumentError, 'invalid value for "chart_id" when calling ChartsApi.put_api_charts_by_chart_id_map_draft, the character length must be smaller than or equal to 36.'
+      end
+
+      if @api_client.config.client_side_validation && chart_id.to_s.length < 36
+        fail ArgumentError, 'invalid value for "chart_id" when calling ChartsApi.put_api_charts_by_chart_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 ChartsApi.put_api_charts_by_chart_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 ChartsApi.put_api_charts_by_chart_id_map_draft, 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 ChartsApi.put_api_charts_by_chart_id_map_draft, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/charts/{chartId}/map/draft'.sub('{' + 'chartId' + '}', CGI.escape(chart_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_charts_by_chart_id_actions_validate_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ChartsApi.put_api_charts_by_chart_id_map_draft",
+        :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(:PUT, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ChartsApi#put_api_charts_by_chart_id_map_draft\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Replace chart tags
+    # Replaces every tag on the chart. Returns the stored tags sorted case-insensitively. `422 ERR_CHART_TAG_INVALID` for an empty / too long / comma-containing tag, `422 ERR_CHART_TAG_LIMIT` above 20 distinct tags. Filter lists with `GET /api/charts?tag=vip,arena`.
+    # @param chart_id [String] 
+    # @param put_api_charts_by_chart_id_tags_request [PutApiChartsByChartIdTagsRequest] 
+    # @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_charts_by_chart_id_tags(chart_id, put_api_charts_by_chart_id_tags_request, opts = {})
+      put_api_charts_by_chart_id_tags_with_http_info(chart_id, put_api_charts_by_chart_id_tags_request, opts)
+      nil
+    end
+
+    # Replace chart tags
+    # Replaces every tag on the chart. Returns the stored tags sorted case-insensitively. &#x60;422 ERR_CHART_TAG_INVALID&#x60; for an empty / too long / comma-containing tag, &#x60;422 ERR_CHART_TAG_LIMIT&#x60; above 20 distinct tags. Filter lists with &#x60;GET /api/charts?tag&#x3D;vip,arena&#x60;.
+    # @param chart_id [String] 
+    # @param put_api_charts_by_chart_id_tags_request [PutApiChartsByChartIdTagsRequest] 
+    # @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_charts_by_chart_id_tags_with_http_info(chart_id, put_api_charts_by_chart_id_tags_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.put_api_charts_by_chart_id_tags ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.put_api_charts_by_chart_id_tags"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.put_api_charts_by_chart_id_tags, must conform to the pattern #{pattern}."
+      end
+
+      # verify the required parameter 'put_api_charts_by_chart_id_tags_request' is set
+      if @api_client.config.client_side_validation && put_api_charts_by_chart_id_tags_request.nil?
+        fail ArgumentError, "Missing the required parameter 'put_api_charts_by_chart_id_tags_request' when calling ChartsApi.put_api_charts_by_chart_id_tags"
+      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 ChartsApi.put_api_charts_by_chart_id_tags, 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 ChartsApi.put_api_charts_by_chart_id_tags, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/charts/{chartId}/tags'.sub('{' + 'chartId' + '}', CGI.escape(chart_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(put_api_charts_by_chart_id_tags_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ChartsApi.put_api_charts_by_chart_id_tags",
+        :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(:PUT, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ChartsApi#put_api_charts_by_chart_id_tags\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Attach a rendered thumbnail to a version
+    # Stores the preview the designer renders at publish time (offscreen render of the stage, ~640px, WebP). Written through the map-asset storage (`MAP_ASSET_STORAGE_DIR` / R2) when configured, otherwise kept inline. Set once: `409 ERR_THUMBNAIL_EXISTS` when the version already has one (version thumbnails are immutable). A version still showing the server placeholder (published through the API, or a baseline) accepts a render at any time — the designer attaches one when it shows that published map. For a chart published before version history, attaching to version 1 first records its published state as the baseline version. Magic bytes must match the declared type (`400 ERR_THUMBNAIL_INVALID`).
+    # @param chart_id [String] 
+    # @param version [Float] Version number (1-based).
+    # @param put_api_charts_by_chart_id_versions_by_version_thumbnail_request [PutApiChartsByChartIdVersionsByVersionThumbnailRequest] 
+    # @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_charts_by_chart_id_versions_by_version_thumbnail(chart_id, version, put_api_charts_by_chart_id_versions_by_version_thumbnail_request, opts = {})
+      put_api_charts_by_chart_id_versions_by_version_thumbnail_with_http_info(chart_id, version, put_api_charts_by_chart_id_versions_by_version_thumbnail_request, opts)
+      nil
+    end
+
+    # Attach a rendered thumbnail to a version
+    # Stores the preview the designer renders at publish time (offscreen render of the stage, ~640px, WebP). Written through the map-asset storage (&#x60;MAP_ASSET_STORAGE_DIR&#x60; / R2) when configured, otherwise kept inline. Set once: &#x60;409 ERR_THUMBNAIL_EXISTS&#x60; when the version already has one (version thumbnails are immutable). A version still showing the server placeholder (published through the API, or a baseline) accepts a render at any time — the designer attaches one when it shows that published map. For a chart published before version history, attaching to version 1 first records its published state as the baseline version. Magic bytes must match the declared type (&#x60;400 ERR_THUMBNAIL_INVALID&#x60;).
+    # @param chart_id [String] 
+    # @param version [Float] Version number (1-based).
+    # @param put_api_charts_by_chart_id_versions_by_version_thumbnail_request [PutApiChartsByChartIdVersionsByVersionThumbnailRequest] 
+    # @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_charts_by_chart_id_versions_by_version_thumbnail_with_http_info(chart_id, version, put_api_charts_by_chart_id_versions_by_version_thumbnail_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ChartsApi.put_api_charts_by_chart_id_versions_by_version_thumbnail ...'
+      end
+      # verify the required parameter 'chart_id' is set
+      if @api_client.config.client_side_validation && chart_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chart_id' when calling ChartsApi.put_api_charts_by_chart_id_versions_by_version_thumbnail"
+      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 && chart_id !~ pattern
+        fail ArgumentError, "invalid value for 'chart_id' when calling ChartsApi.put_api_charts_by_chart_id_versions_by_version_thumbnail, must conform to the pattern #{pattern}."
+      end
+
+      # verify the required parameter 'version' is set
+      if @api_client.config.client_side_validation && version.nil?
+        fail ArgumentError, "Missing the required parameter 'version' when calling ChartsApi.put_api_charts_by_chart_id_versions_by_version_thumbnail"
+      end
+      if @api_client.config.client_side_validation && version > 2147483647
+        fail ArgumentError, 'invalid value for "version" when calling ChartsApi.put_api_charts_by_chart_id_versions_by_version_thumbnail, must be smaller than or equal to 2147483647.'
+      end
+
+      if @api_client.config.client_side_validation && version < 1
+        fail ArgumentError, 'invalid value for "version" when calling ChartsApi.put_api_charts_by_chart_id_versions_by_version_thumbnail, must be greater than or equal to 1.'
+      end
+
+      # verify the required parameter 'put_api_charts_by_chart_id_versions_by_version_thumbnail_request' is set
+      if @api_client.config.client_side_validation && put_api_charts_by_chart_id_versions_by_version_thumbnail_request.nil?
+        fail ArgumentError, "Missing the required parameter 'put_api_charts_by_chart_id_versions_by_version_thumbnail_request' when calling ChartsApi.put_api_charts_by_chart_id_versions_by_version_thumbnail"
+      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 ChartsApi.put_api_charts_by_chart_id_versions_by_version_thumbnail, 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 ChartsApi.put_api_charts_by_chart_id_versions_by_version_thumbnail, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/charts/{chartId}/versions/{version}/thumbnail'.sub('{' + 'chartId' + '}', CGI.escape(chart_id.to_s)).sub('{' + 'version' + '}', CGI.escape(version.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(put_api_charts_by_chart_id_versions_by_version_thumbnail_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ChartsApi.put_api_charts_by_chart_id_versions_by_version_thumbnail",
+        :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(:PUT, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ChartsApi#put_api_charts_by_chart_id_versions_by_version_thumbnail\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end