seatschart 0.2.0 → 0.3.0

data/lib/seatschart/api/sandboxes_api.rb

@@ -0,0 +1,672 @@
+=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 SandboxesApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Delete a sandbox
+    # Deletes the sandbox for good in one transaction: its data (as a reset) and its configuration (API keys, webhooks, members, invitations, embed domains). Its keys and sessions stop working at once; members whose default workspace it was default to this workspace. Unlike production workspaces (soft delete), a sandbox is hard-deleted. Irreversible. Callers: a dashboard session of the **production** workspace (any member reads; admins change) or an API key of it (`read` reads; changes need a full-access key). Sandbox keys and sessions get 403 `ERR_SANDBOX_SCOPE`: a sandbox can never act on its production workspace or on another sandbox, and production keys never work inside a sandbox (each workspace has its own keys).
+    # @param sandbox_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 [DeleteApiSandboxesBySandboxId200Response]
+    def delete_api_sandboxes_by_sandbox_id(sandbox_id, opts = {})
+      data, _status_code, _headers = delete_api_sandboxes_by_sandbox_id_with_http_info(sandbox_id, opts)
+      data
+    end
+
+    # Delete a sandbox
+    # Deletes the sandbox for good in one transaction: its data (as a reset) and its configuration (API keys, webhooks, members, invitations, embed domains). Its keys and sessions stop working at once; members whose default workspace it was default to this workspace. Unlike production workspaces (soft delete), a sandbox is hard-deleted. Irreversible. Callers: a dashboard session of the **production** workspace (any member reads; admins change) or an API key of it (`read` reads; changes need a full-access key). Sandbox keys and sessions get 403 `ERR_SANDBOX_SCOPE`: a sandbox can never act on its production workspace or on another sandbox, and production keys never work inside a sandbox (each workspace has its own keys).
+    # @param sandbox_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<(DeleteApiSandboxesBySandboxId200Response, Integer, Hash)>] DeleteApiSandboxesBySandboxId200Response data, response status code and response headers
+    def delete_api_sandboxes_by_sandbox_id_with_http_info(sandbox_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxesApi.delete_api_sandboxes_by_sandbox_id ...'
+      end
+      # verify the required parameter 'sandbox_id' is set
+      if @api_client.config.client_side_validation && sandbox_id.nil?
+        fail ArgumentError, "Missing the required parameter 'sandbox_id' when calling SandboxesApi.delete_api_sandboxes_by_sandbox_id"
+      end
+      if @api_client.config.client_side_validation && sandbox_id.to_s.length > 128
+        fail ArgumentError, 'invalid value for "sandbox_id" when calling SandboxesApi.delete_api_sandboxes_by_sandbox_id, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && sandbox_id.to_s.length < 1
+        fail ArgumentError, 'invalid value for "sandbox_id" when calling SandboxesApi.delete_api_sandboxes_by_sandbox_id, the character length must be great 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 SandboxesApi.delete_api_sandboxes_by_sandbox_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 SandboxesApi.delete_api_sandboxes_by_sandbox_id, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/sandboxes/{sandboxId}'.sub('{' + 'sandboxId' + '}', CGI.escape(sandbox_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] || 'DeleteApiSandboxesBySandboxId200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"SandboxesApi.delete_api_sandboxes_by_sandbox_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: SandboxesApi#delete_api_sandboxes_by_sandbox_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List the sandboxes of this workspace
+    # Sandboxes of the calling production workspace (oldest first) with this month's usage (shown, never billed) and the rate limits they run at. Callers: a dashboard session of the **production** workspace (any member reads; admins change) or an API key of it (`read` reads; changes need a full-access key). Sandbox keys and sessions get 403 `ERR_SANDBOX_SCOPE`: a sandbox can never act on its production workspace or on another sandbox, and production keys never work inside a sandbox (each workspace has its own keys).
+    # @param [Hash] opts the optional parameters
+    # @return [GetApiSandboxes200Response]
+    def get_api_sandboxes(opts = {})
+      data, _status_code, _headers = get_api_sandboxes_with_http_info(opts)
+      data
+    end
+
+    # List the sandboxes of this workspace
+    # Sandboxes of the calling production workspace (oldest first) with this month&#39;s usage (shown, never billed) and the rate limits they run at. Callers: a dashboard session of the **production** workspace (any member reads; admins change) or an API key of it (&#x60;read&#x60; reads; changes need a full-access key). Sandbox keys and sessions get 403 &#x60;ERR_SANDBOX_SCOPE&#x60;: a sandbox can never act on its production workspace or on another sandbox, and production keys never work inside a sandbox (each workspace has its own keys).
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(GetApiSandboxes200Response, Integer, Hash)>] GetApiSandboxes200Response data, response status code and response headers
+    def get_api_sandboxes_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxesApi.get_api_sandboxes ...'
+      end
+      # resource path
+      local_var_path = '/api/sandboxes'
+
+      # 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']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GetApiSandboxes200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"SandboxesApi.get_api_sandboxes",
+        :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: SandboxesApi#get_api_sandboxes\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get a sandbox
+    # One sandbox of this workspace (404 for any other id). Callers: a dashboard session of the **production** workspace (any member reads; admins change) or an API key of it (`read` reads; changes need a full-access key). Sandbox keys and sessions get 403 `ERR_SANDBOX_SCOPE`: a sandbox can never act on its production workspace or on another sandbox, and production keys never work inside a sandbox (each workspace has its own keys).
+    # @param sandbox_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [GetApiSandboxes200ResponseItemsInner]
+    def get_api_sandboxes_by_sandbox_id(sandbox_id, opts = {})
+      data, _status_code, _headers = get_api_sandboxes_by_sandbox_id_with_http_info(sandbox_id, opts)
+      data
+    end
+
+    # Get a sandbox
+    # One sandbox of this workspace (404 for any other id). Callers: a dashboard session of the **production** workspace (any member reads; admins change) or an API key of it (&#x60;read&#x60; reads; changes need a full-access key). Sandbox keys and sessions get 403 &#x60;ERR_SANDBOX_SCOPE&#x60;: a sandbox can never act on its production workspace or on another sandbox, and production keys never work inside a sandbox (each workspace has its own keys).
+    # @param sandbox_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(GetApiSandboxes200ResponseItemsInner, Integer, Hash)>] GetApiSandboxes200ResponseItemsInner data, response status code and response headers
+    def get_api_sandboxes_by_sandbox_id_with_http_info(sandbox_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxesApi.get_api_sandboxes_by_sandbox_id ...'
+      end
+      # verify the required parameter 'sandbox_id' is set
+      if @api_client.config.client_side_validation && sandbox_id.nil?
+        fail ArgumentError, "Missing the required parameter 'sandbox_id' when calling SandboxesApi.get_api_sandboxes_by_sandbox_id"
+      end
+      if @api_client.config.client_side_validation && sandbox_id.to_s.length > 128
+        fail ArgumentError, 'invalid value for "sandbox_id" when calling SandboxesApi.get_api_sandboxes_by_sandbox_id, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && sandbox_id.to_s.length < 1
+        fail ArgumentError, 'invalid value for "sandbox_id" when calling SandboxesApi.get_api_sandboxes_by_sandbox_id, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/sandboxes/{sandboxId}'.sub('{' + 'sandboxId' + '}', CGI.escape(sandbox_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']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GetApiSandboxes200ResponseItemsInner'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"SandboxesApi.get_api_sandboxes_by_sandbox_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: SandboxesApi#get_api_sandboxes_by_sandbox_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Create a sandbox
+    # Creates an isolated sandbox of this workspace: a workspace of its own (`kind: sandbox`) with its own charts, events, seasons, holds, orders, ticket buyer ids, webhooks and API keys (`sk_test_…`). It is never billed: its usage is shown but not counted against the plan, it has no chart or event caps, webhooks are marked sandbox, billing emails are suppressed and other emails are marked, and buyers see a small Sandbox ribbon. Every member of this workspace becomes a member with the same role, and the team keeps following: members who join later get access with their role, role changes apply and members removed from this workspace lose its sandboxes. At most 10 per workspace (409 `sandbox_limit_reached`). Optionally copies charts (and their events). Callers: a dashboard session of the **production** workspace (any member reads; admins change) or an API key of it (`read` reads; changes need a full-access key). Sandbox keys and sessions get 403 `ERR_SANDBOX_SCOPE`: a sandbox can never act on its production workspace or on another sandbox, and production keys never work inside a sandbox (each workspace has its own keys).
+    # @param post_api_sandboxes_request [PostApiSandboxesRequest] 
+    # @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 [PostApiSandboxes201Response]
+    def post_api_sandboxes(post_api_sandboxes_request, opts = {})
+      data, _status_code, _headers = post_api_sandboxes_with_http_info(post_api_sandboxes_request, opts)
+      data
+    end
+
+    # Create a sandbox
+    # Creates an isolated sandbox of this workspace: a workspace of its own (&#x60;kind: sandbox&#x60;) with its own charts, events, seasons, holds, orders, ticket buyer ids, webhooks and API keys (&#x60;sk_test_…&#x60;). It is never billed: its usage is shown but not counted against the plan, it has no chart or event caps, webhooks are marked sandbox, billing emails are suppressed and other emails are marked, and buyers see a small Sandbox ribbon. Every member of this workspace becomes a member with the same role, and the team keeps following: members who join later get access with their role, role changes apply and members removed from this workspace lose its sandboxes. At most 10 per workspace (409 &#x60;sandbox_limit_reached&#x60;). Optionally copies charts (and their events). Callers: a dashboard session of the **production** workspace (any member reads; admins change) or an API key of it (&#x60;read&#x60; reads; changes need a full-access key). Sandbox keys and sessions get 403 &#x60;ERR_SANDBOX_SCOPE&#x60;: a sandbox can never act on its production workspace or on another sandbox, and production keys never work inside a sandbox (each workspace has its own keys).
+    # @param post_api_sandboxes_request [PostApiSandboxesRequest] 
+    # @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<(PostApiSandboxes201Response, Integer, Hash)>] PostApiSandboxes201Response data, response status code and response headers
+    def post_api_sandboxes_with_http_info(post_api_sandboxes_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxesApi.post_api_sandboxes ...'
+      end
+      # verify the required parameter 'post_api_sandboxes_request' is set
+      if @api_client.config.client_side_validation && post_api_sandboxes_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_sandboxes_request' when calling SandboxesApi.post_api_sandboxes"
+      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 SandboxesApi.post_api_sandboxes, 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 SandboxesApi.post_api_sandboxes, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/sandboxes'
+
+      # 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_sandboxes_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'PostApiSandboxes201Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"SandboxesApi.post_api_sandboxes",
+        :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: SandboxesApi#post_api_sandboxes\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Copy charts (and events) from production into a sandbox
+    # Copies charts of this workspace into the sandbox (the WP18 cross-workspace copy): a published chart becomes a published copy with fresh object ids, a draft-only chart a draft; tags travel with them. With `includeEvents`, the events of each published chart are copied too, with their for-sale configuration and every object available. Chart and event keys are kept when the sandbox does not use them yet (`keyConflicts` lists the others, copied without a key), so the same integration code runs against both workspaces. Sandbox copies never share ids or secrets with production. Callers: a dashboard session of the **production** workspace (any member reads; admins change) or an API key of it (`read` reads; changes need a full-access key). Sandbox keys and sessions get 403 `ERR_SANDBOX_SCOPE`: a sandbox can never act on its production workspace or on another sandbox, and production keys never work inside a sandbox (each workspace has its own keys).
+    # @param sandbox_id [String] 
+    # @param post_api_sandboxes_by_sandbox_id_actions_copy_from_production_request [PostApiSandboxesBySandboxIdActionsCopyFromProductionRequest] 
+    # @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 [PostApiSandboxesBySandboxIdActionsCopyFromProduction200Response]
+    def post_api_sandboxes_by_sandbox_id_actions_copy_from_production(sandbox_id, post_api_sandboxes_by_sandbox_id_actions_copy_from_production_request, opts = {})
+      data, _status_code, _headers = post_api_sandboxes_by_sandbox_id_actions_copy_from_production_with_http_info(sandbox_id, post_api_sandboxes_by_sandbox_id_actions_copy_from_production_request, opts)
+      data
+    end
+
+    # Copy charts (and events) from production into a sandbox
+    # Copies charts of this workspace into the sandbox (the WP18 cross-workspace copy): a published chart becomes a published copy with fresh object ids, a draft-only chart a draft; tags travel with them. With &#x60;includeEvents&#x60;, the events of each published chart are copied too, with their for-sale configuration and every object available. Chart and event keys are kept when the sandbox does not use them yet (&#x60;keyConflicts&#x60; lists the others, copied without a key), so the same integration code runs against both workspaces. Sandbox copies never share ids or secrets with production. Callers: a dashboard session of the **production** workspace (any member reads; admins change) or an API key of it (&#x60;read&#x60; reads; changes need a full-access key). Sandbox keys and sessions get 403 &#x60;ERR_SANDBOX_SCOPE&#x60;: a sandbox can never act on its production workspace or on another sandbox, and production keys never work inside a sandbox (each workspace has its own keys).
+    # @param sandbox_id [String] 
+    # @param post_api_sandboxes_by_sandbox_id_actions_copy_from_production_request [PostApiSandboxesBySandboxIdActionsCopyFromProductionRequest] 
+    # @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<(PostApiSandboxesBySandboxIdActionsCopyFromProduction200Response, Integer, Hash)>] PostApiSandboxesBySandboxIdActionsCopyFromProduction200Response data, response status code and response headers
+    def post_api_sandboxes_by_sandbox_id_actions_copy_from_production_with_http_info(sandbox_id, post_api_sandboxes_by_sandbox_id_actions_copy_from_production_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_copy_from_production ...'
+      end
+      # verify the required parameter 'sandbox_id' is set
+      if @api_client.config.client_side_validation && sandbox_id.nil?
+        fail ArgumentError, "Missing the required parameter 'sandbox_id' when calling SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_copy_from_production"
+      end
+      if @api_client.config.client_side_validation && sandbox_id.to_s.length > 128
+        fail ArgumentError, 'invalid value for "sandbox_id" when calling SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_copy_from_production, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && sandbox_id.to_s.length < 1
+        fail ArgumentError, 'invalid value for "sandbox_id" when calling SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_copy_from_production, the character length must be great than or equal to 1.'
+      end
+
+      # verify the required parameter 'post_api_sandboxes_by_sandbox_id_actions_copy_from_production_request' is set
+      if @api_client.config.client_side_validation && post_api_sandboxes_by_sandbox_id_actions_copy_from_production_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_sandboxes_by_sandbox_id_actions_copy_from_production_request' when calling SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_copy_from_production"
+      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 SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_copy_from_production, 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 SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_copy_from_production, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/sandboxes/{sandboxId}/actions/copy-from-production'.sub('{' + 'sandboxId' + '}', CGI.escape(sandbox_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_sandboxes_by_sandbox_id_actions_copy_from_production_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'PostApiSandboxesBySandboxIdActionsCopyFromProduction200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_copy_from_production",
+        :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: SandboxesApi#post_api_sandboxes_by_sandbox_id_actions_copy_from_production\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Join a sandbox (dashboard)
+    # Adds the calling admin of the production workspace to one of its sandboxes (as admin; an existing membership is kept) so they can switch to it. Members are also added automatically (listing or reading sandboxes, and accepting an invitation), so this is rarely needed. Dashboard sessions only.
+    # @param sandbox_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 [PostApiSandboxesBySandboxIdActionsJoin200Response]
+    def post_api_sandboxes_by_sandbox_id_actions_join(sandbox_id, opts = {})
+      data, _status_code, _headers = post_api_sandboxes_by_sandbox_id_actions_join_with_http_info(sandbox_id, opts)
+      data
+    end
+
+    # Join a sandbox (dashboard)
+    # Adds the calling admin of the production workspace to one of its sandboxes (as admin; an existing membership is kept) so they can switch to it. Members are also added automatically (listing or reading sandboxes, and accepting an invitation), so this is rarely needed. Dashboard sessions only.
+    # @param sandbox_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<(PostApiSandboxesBySandboxIdActionsJoin200Response, Integer, Hash)>] PostApiSandboxesBySandboxIdActionsJoin200Response data, response status code and response headers
+    def post_api_sandboxes_by_sandbox_id_actions_join_with_http_info(sandbox_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_join ...'
+      end
+      # verify the required parameter 'sandbox_id' is set
+      if @api_client.config.client_side_validation && sandbox_id.nil?
+        fail ArgumentError, "Missing the required parameter 'sandbox_id' when calling SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_join"
+      end
+      if @api_client.config.client_side_validation && sandbox_id.to_s.length > 128
+        fail ArgumentError, 'invalid value for "sandbox_id" when calling SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_join, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && sandbox_id.to_s.length < 1
+        fail ArgumentError, 'invalid value for "sandbox_id" when calling SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_join, the character length must be great 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 SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_join, 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 SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_join, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/sandboxes/{sandboxId}/actions/join'.sub('{' + 'sandboxId' + '}', CGI.escape(sandbox_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] || 'PostApiSandboxesBySandboxIdActionsJoin200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_join",
+        :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: SandboxesApi#post_api_sandboxes_by_sandbox_id_actions_join\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Reset a sandbox
+    # Deletes **all data** of the sandbox in one transaction (all or nothing): orders, bookings, holds, events with their inventory, seasons, charts, listings, ticket buyer ids, usage, webhook deliveries and its audit log; live holds are cleared from the cache. Members, settings, the public key, embed domains, API keys (unless `rotateKeys`) and webhook endpoints (unless `keepWebhooks: false`) stay. A concurrent confirmation either commits before the reset (and is deleted) or fails after it. Irreversible. Callers: a dashboard session of the **production** workspace (any member reads; admins change) or an API key of it (`read` reads; changes need a full-access key). Sandbox keys and sessions get 403 `ERR_SANDBOX_SCOPE`: a sandbox can never act on its production workspace or on another sandbox, and production keys never work inside a sandbox (each workspace has its own keys).
+    # @param sandbox_id [String] 
+    # @param post_api_sandboxes_by_sandbox_id_actions_reset_request [PostApiSandboxesBySandboxIdActionsResetRequest] 
+    # @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 [PostApiSandboxesBySandboxIdActionsReset200Response]
+    def post_api_sandboxes_by_sandbox_id_actions_reset(sandbox_id, post_api_sandboxes_by_sandbox_id_actions_reset_request, opts = {})
+      data, _status_code, _headers = post_api_sandboxes_by_sandbox_id_actions_reset_with_http_info(sandbox_id, post_api_sandboxes_by_sandbox_id_actions_reset_request, opts)
+      data
+    end
+
+    # Reset a sandbox
+    # Deletes **all data** of the sandbox in one transaction (all or nothing): orders, bookings, holds, events with their inventory, seasons, charts, listings, ticket buyer ids, usage, webhook deliveries and its audit log; live holds are cleared from the cache. Members, settings, the public key, embed domains, API keys (unless &#x60;rotateKeys&#x60;) and webhook endpoints (unless &#x60;keepWebhooks: false&#x60;) stay. A concurrent confirmation either commits before the reset (and is deleted) or fails after it. Irreversible. Callers: a dashboard session of the **production** workspace (any member reads; admins change) or an API key of it (&#x60;read&#x60; reads; changes need a full-access key). Sandbox keys and sessions get 403 &#x60;ERR_SANDBOX_SCOPE&#x60;: a sandbox can never act on its production workspace or on another sandbox, and production keys never work inside a sandbox (each workspace has its own keys).
+    # @param sandbox_id [String] 
+    # @param post_api_sandboxes_by_sandbox_id_actions_reset_request [PostApiSandboxesBySandboxIdActionsResetRequest] 
+    # @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<(PostApiSandboxesBySandboxIdActionsReset200Response, Integer, Hash)>] PostApiSandboxesBySandboxIdActionsReset200Response data, response status code and response headers
+    def post_api_sandboxes_by_sandbox_id_actions_reset_with_http_info(sandbox_id, post_api_sandboxes_by_sandbox_id_actions_reset_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_reset ...'
+      end
+      # verify the required parameter 'sandbox_id' is set
+      if @api_client.config.client_side_validation && sandbox_id.nil?
+        fail ArgumentError, "Missing the required parameter 'sandbox_id' when calling SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_reset"
+      end
+      if @api_client.config.client_side_validation && sandbox_id.to_s.length > 128
+        fail ArgumentError, 'invalid value for "sandbox_id" when calling SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_reset, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && sandbox_id.to_s.length < 1
+        fail ArgumentError, 'invalid value for "sandbox_id" when calling SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_reset, the character length must be great than or equal to 1.'
+      end
+
+      # verify the required parameter 'post_api_sandboxes_by_sandbox_id_actions_reset_request' is set
+      if @api_client.config.client_side_validation && post_api_sandboxes_by_sandbox_id_actions_reset_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_sandboxes_by_sandbox_id_actions_reset_request' when calling SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_reset"
+      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 SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_reset, 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 SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_reset, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/sandboxes/{sandboxId}/actions/reset'.sub('{' + 'sandboxId' + '}', CGI.escape(sandbox_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_sandboxes_by_sandbox_id_actions_reset_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'PostApiSandboxesBySandboxIdActionsReset200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"SandboxesApi.post_api_sandboxes_by_sandbox_id_actions_reset",
+        :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: SandboxesApi#post_api_sandboxes_by_sandbox_id_actions_reset\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Create or rotate the sandbox admin key
+    # Mints a full-access `sk_test_…` key of the sandbox (secret returned once). It works only inside the sandbox: it can never read or change this workspace, another sandbox, or manage workspaces. `revokeExisting: true` rotates (revokes the other keys at once). Callers: a dashboard session of the **production** workspace (any member reads; admins change) or an API key of it (`read` reads; changes need a full-access key). Sandbox keys and sessions get 403 `ERR_SANDBOX_SCOPE`: a sandbox can never act on its production workspace or on another sandbox, and production keys never work inside a sandbox (each workspace has its own keys).
+    # @param sandbox_id [String] 
+    # @param post_api_sandboxes_by_sandbox_id_admin_key_request [PostApiSandboxesBySandboxIdAdminKeyRequest] 
+    # @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 [PostApiSandboxesBySandboxIdAdminKey201Response]
+    def post_api_sandboxes_by_sandbox_id_admin_key(sandbox_id, post_api_sandboxes_by_sandbox_id_admin_key_request, opts = {})
+      data, _status_code, _headers = post_api_sandboxes_by_sandbox_id_admin_key_with_http_info(sandbox_id, post_api_sandboxes_by_sandbox_id_admin_key_request, opts)
+      data
+    end
+
+    # Create or rotate the sandbox admin key
+    # Mints a full-access &#x60;sk_test_…&#x60; key of the sandbox (secret returned once). It works only inside the sandbox: it can never read or change this workspace, another sandbox, or manage workspaces. &#x60;revokeExisting: true&#x60; rotates (revokes the other keys at once). Callers: a dashboard session of the **production** workspace (any member reads; admins change) or an API key of it (&#x60;read&#x60; reads; changes need a full-access key). Sandbox keys and sessions get 403 &#x60;ERR_SANDBOX_SCOPE&#x60;: a sandbox can never act on its production workspace or on another sandbox, and production keys never work inside a sandbox (each workspace has its own keys).
+    # @param sandbox_id [String] 
+    # @param post_api_sandboxes_by_sandbox_id_admin_key_request [PostApiSandboxesBySandboxIdAdminKeyRequest] 
+    # @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<(PostApiSandboxesBySandboxIdAdminKey201Response, Integer, Hash)>] PostApiSandboxesBySandboxIdAdminKey201Response data, response status code and response headers
+    def post_api_sandboxes_by_sandbox_id_admin_key_with_http_info(sandbox_id, post_api_sandboxes_by_sandbox_id_admin_key_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxesApi.post_api_sandboxes_by_sandbox_id_admin_key ...'
+      end
+      # verify the required parameter 'sandbox_id' is set
+      if @api_client.config.client_side_validation && sandbox_id.nil?
+        fail ArgumentError, "Missing the required parameter 'sandbox_id' when calling SandboxesApi.post_api_sandboxes_by_sandbox_id_admin_key"
+      end
+      if @api_client.config.client_side_validation && sandbox_id.to_s.length > 128
+        fail ArgumentError, 'invalid value for "sandbox_id" when calling SandboxesApi.post_api_sandboxes_by_sandbox_id_admin_key, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && sandbox_id.to_s.length < 1
+        fail ArgumentError, 'invalid value for "sandbox_id" when calling SandboxesApi.post_api_sandboxes_by_sandbox_id_admin_key, the character length must be great than or equal to 1.'
+      end
+
+      # verify the required parameter 'post_api_sandboxes_by_sandbox_id_admin_key_request' is set
+      if @api_client.config.client_side_validation && post_api_sandboxes_by_sandbox_id_admin_key_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_sandboxes_by_sandbox_id_admin_key_request' when calling SandboxesApi.post_api_sandboxes_by_sandbox_id_admin_key"
+      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 SandboxesApi.post_api_sandboxes_by_sandbox_id_admin_key, 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 SandboxesApi.post_api_sandboxes_by_sandbox_id_admin_key, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/sandboxes/{sandboxId}/admin-key'.sub('{' + 'sandboxId' + '}', CGI.escape(sandbox_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_sandboxes_by_sandbox_id_admin_key_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'PostApiSandboxesBySandboxIdAdminKey201Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"SandboxesApi.post_api_sandboxes_by_sandbox_id_admin_key",
+        :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: SandboxesApi#post_api_sandboxes_by_sandbox_id_admin_key\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end