license_manager 0.1.0

data/lib/license_manager/api/licenses_api.rb

@@ -0,0 +1,885 @@
+=begin
+#LicenseManager API
+
+#Public API. Authenticate with an organization API key, or with a token scoped to a customer, license or machine on the endpoints that accept one.  ## Conventions  - **Errors** answer `{ \"error\": { \"code\", \"message\" } }`. Branch on `code`, which is stable, not on `message`. Each response lists the codes it can return, except `404`, which answers `not_found` unless it says otherwise. Unexpected errors answer `500` with `internal_error`. - **Validation** errors answer `422`, not `400`, with the `validation_error` code and an `issues` array giving the `path` and `message` of each invalid value. - **Unknown body fields are ignored**, not rejected: sending a field an endpoint doesn't accept, like `policyId` to `updateLicense`, changes nothing and doesn't fail. - **Strings** are trimmed before they're validated and stored. Emails are stored lower cased. - **Updates** only change the fields that are sent. A field sent as `null` is cleared, when it can be. - **Dates** can be sent with any offset, and are always returned in UTC, like `2026-01-15T09:30:00.000Z`. Calendar months and days are counted in UTC. - **Ids** are 8 letters and digits, after `test_` for test products and their resources. - **Lists** are paginated with `page` and `pageSize`. Items with the same value for the `sort` field are ordered by id, so pages are stable, but items created or deleted between two requests shift the pages. Items without a value for the `sort` field come last in ascending order, and first in descending order, unless the endpoint says otherwise. - **Test products** are sandboxes of a live product. Test API keys only reach test products, live API keys only live ones: the others answer `404`, as if they didn't exist. Sessions and tokens reach both.
+
+The version of the OpenAPI document: 1.0.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.26.0
+
+=end
+
+require 'cgi'
+
+module LicenseManager
+  class LicensesApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Create a license
+    # Without a `key`, the license gets a random one, like `7KQ2M-X9ZPA-H4TRC-WN6EY-B3JDF`: 5 groups of 5 characters separated by dashes, each character an upper case letter or a digit other than `O`, `0`, `I` and `1`. That's 32 possible characters encoding 5 bits each, for 125 random bits.  Without a `policyId`, the license follows the product's default policy.  Without an `expiresAt`, the license expires after the duration of its policy, or never when the policy has none. `expiresAt: null` makes it never expire.  Without a `price`, the price paid for the license is unknown: it's left out of the revenue stats.  The values of `maxVersion` left out are taken from the max version of the policy: its hard-coded version, or the times after the creation of the license its versions lock.  The license belongs to the product's customer with the given `email`, which is created when there's none.  With `sendKey: true`, the key is emailed to the customer once the license is created.  The license copies the settings of its policy when it's created: later changes to the policy don't affect it. Its key, policy and customer can't be changed afterwards.  **Required role permission**: `license:create` when called with a session, granted by the member's role. API keys aren't limited by roles.
+    # @param product_id [String] 
+    # @param create_license [CreateLicense] 
+    # @param [Hash] opts the optional parameters
+    # @return [License]
+    def create_license(product_id, create_license, opts = {})
+      data, _status_code, _headers = create_license_with_http_info(product_id, create_license, opts)
+      data
+    end
+
+    # Create a license
+    # Without a `key`, the license gets a random one, like `7KQ2M-X9ZPA-H4TRC-WN6EY-B3JDF`: 5 groups of 5 characters separated by dashes, each character an upper case letter or a digit other than `O`, `0`, `I` and `1`. That's 32 possible characters encoding 5 bits each, for 125 random bits.  Without a `policyId`, the license follows the product's default policy.  Without an `expiresAt`, the license expires after the duration of its policy, or never when the policy has none. `expiresAt: null` makes it never expire.  Without a `price`, the price paid for the license is unknown: it's left out of the revenue stats.  The values of `maxVersion` left out are taken from the max version of the policy: its hard-coded version, or the times after the creation of the license its versions lock.  The license belongs to the product's customer with the given `email`, which is created when there's none.  With `sendKey: true`, the key is emailed to the customer once the license is created.  The license copies the settings of its policy when it's created: later changes to the policy don't affect it. Its key, policy and customer can't be changed afterwards.  **Required role permission**: `license:create` when called with a session, granted by the member's role. API keys aren't limited by roles.
+    # @param product_id [String] 
+    # @param create_license [CreateLicense] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(License, Integer, Hash)>] License data, response status code and response headers
+    def create_license_with_http_info(product_id, create_license, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LicensesApi.create_license ...'
+      end
+      # verify the required parameter 'product_id' is set
+      if @api_client.config.client_side_validation && product_id.nil?
+        fail ArgumentError, "Missing the required parameter 'product_id' when calling LicensesApi.create_license"
+      end
+      # verify the required parameter 'create_license' is set
+      if @api_client.config.client_side_validation && create_license.nil?
+        fail ArgumentError, "Missing the required parameter 'create_license' when calling LicensesApi.create_license"
+      end
+      # resource path
+      local_var_path = '/v1/products/{productId}/licenses'.sub('{productId}', CGI.escape(product_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']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(create_license)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'License'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"LicensesApi.create_license",
+        :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: LicensesApi#create_license\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Delete a license
+    # Deletes the license along with its deactivated machines. A license used on active machines can't be deleted: deactivate them first. The tokens scoped to the license or its machines stop working, but the license tokens `validateKey` already returned stay valid until they expire. Its events can no longer be listed.  **Required role permission**: `license:delete` when called with a session, granted by the member's role. API keys aren't limited by roles.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def delete_license(id, opts = {})
+      delete_license_with_http_info(id, opts)
+      nil
+    end
+
+    # Delete a license
+    # Deletes the license along with its deactivated machines. A license used on active machines can&#39;t be deleted: deactivate them first. The tokens scoped to the license or its machines stop working, but the license tokens &#x60;validateKey&#x60; already returned stay valid until they expire. Its events can no longer be listed.  **Required role permission**: &#x60;license:delete&#x60; when called with a session, granted by the member&#39;s role. API keys aren&#39;t limited by roles.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def delete_license_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LicensesApi.delete_license ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling LicensesApi.delete_license"
+      end
+      # resource path
+      local_var_path = '/v1/licenses/{id}'.sub('{id}', CGI.escape(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']) 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]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"LicensesApi.delete_license",
+        :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: LicensesApi#delete_license\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get a license
+    # **Token access**: customer, license, machine tokens with the `license:read` permission (or the matching write one). A token reaches the license it's scoped to, the licenses of its customer, or the license of its machine.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [License]
+    def get_license(id, opts = {})
+      data, _status_code, _headers = get_license_with_http_info(id, opts)
+      data
+    end
+
+    # Get a license
+    # **Token access**: customer, license, machine tokens with the &#x60;license:read&#x60; permission (or the matching write one). A token reaches the license it&#39;s scoped to, the licenses of its customer, or the license of its machine.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(License, Integer, Hash)>] License data, response status code and response headers
+    def get_license_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LicensesApi.get_license ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling LicensesApi.get_license"
+      end
+      # resource path
+      local_var_path = '/v1/licenses/{id}'.sub('{id}', CGI.escape(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']) 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] || 'License'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey', 'token']
+
+      new_options = opts.merge(
+        :operation => :"LicensesApi.get_license",
+        :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: LicensesApi#get_license\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get the stats of a license
+    # Daily number of successful activations of the license over the last 90 days, today included, per machine and per version of the application. Days are in UTC.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [LicenseStats]
+    def get_license_stats(id, opts = {})
+      data, _status_code, _headers = get_license_stats_with_http_info(id, opts)
+      data
+    end
+
+    # Get the stats of a license
+    # Daily number of successful activations of the license over the last 90 days, today included, per machine and per version of the application. Days are in UTC.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(LicenseStats, Integer, Hash)>] LicenseStats data, response status code and response headers
+    def get_license_stats_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LicensesApi.get_license_stats ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling LicensesApi.get_license_stats"
+      end
+      # resource path
+      local_var_path = '/v1/licenses/{id}/stats'.sub('{id}', CGI.escape(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']) 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] || 'LicenseStats'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"LicensesApi.get_license_stats",
+        :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: LicensesApi#get_license_stats\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get the organization's signing key
+    # Public key verifying the license tokens returned by `validateKey`, to embed in applications. Created the first time it's needed, and never rotated. The organization has a single key, signing the tokens of its live and test products alike: check the tokens' `aud` to tell them apart.
+    # @param [Hash] opts the optional parameters
+    # @return [SigningKey]
+    def get_signing_key(opts = {})
+      data, _status_code, _headers = get_signing_key_with_http_info(opts)
+      data
+    end
+
+    # Get the organization&#39;s signing key
+    # Public key verifying the license tokens returned by &#x60;validateKey&#x60;, to embed in applications. Created the first time it&#39;s needed, and never rotated. The organization has a single key, signing the tokens of its live and test products alike: check the tokens&#39; &#x60;aud&#x60; to tell them apart.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SigningKey, Integer, Hash)>] SigningKey data, response status code and response headers
+    def get_signing_key_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LicensesApi.get_signing_key ...'
+      end
+      # resource path
+      local_var_path = '/v1/signing-key'
+
+      # 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']) 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] || 'SigningKey'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"LicensesApi.get_signing_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(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LicensesApi#get_signing_key\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List the licenses of a customer
+    # Sorting by `lastActivatedAt` puts the licenses never activated last in both orders. Sorting by `price` compares the amounts whatever their currency, and puts the licenses without a price last in both orders.  **Token access**: customer tokens with the `license:read` permission (or the matching write one). A customer token reaches its own licenses.
+    # @param customer_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :page Page to return. Pages are numbered from 1: &#x60;1&#x60; is the first page. A page past the last one returns an empty &#x60;data&#x60;, not an error. Defaults to &#x60;1&#x60;. (default to 1)
+    # @option opts [Integer] :page_size Maximum number of items per page, from 1 to 100. Every page holds this many items except the last one, which can hold fewer. Defaults to &#x60;20&#x60;. (default to 20)
+    # @option opts [String] :sort Field to sort by, prefixed with &#x60;-&#x60; for descending order. Defaults to &#x60;-createdAt&#x60;. (default to '-createdAt')
+    # @option opts [String] :search Case-insensitive text the key contains.
+    # @option opts [String] :key Only returns the license with this exact key, case included. Keys of test products start with &#x60;TEST-&#x60;.
+    # @option opts [String] :policy_id Only returns the licenses following this policy.
+    # @option opts [String] :machine_version Only returns the licenses with at least one active machine running this version of the product.
+    # @option opts [LicenseStatus] :status Only returns the licenses with this status.
+    # @option opts [Time] :created_from Only returns the licenses created at or after this date.
+    # @option opts [Time] :created_to Only returns the licenses created at or before this date.
+    # @option opts [Time] :last_activated_from Only returns the licenses last activated at or after this date. Licenses never activated are left out.
+    # @option opts [Time] :last_activated_to Only returns the licenses last activated at or before this date. Licenses never activated are left out.
+    # @option opts [String] :never_activated &#x60;true&#x60; only returns the licenses never activated, &#x60;false&#x60; only the ones activated at least once.
+    # @option opts [Time] :expires_from Only returns the licenses expiring at or after this date. Licenses that never expire are left out.
+    # @option opts [Time] :expires_to Only returns the licenses expiring at or before this date. Licenses that never expire are left out.
+    # @option opts [String] :never_expires &#x60;true&#x60; only returns the licenses that never expire, &#x60;false&#x60; only the ones with an expiration date.
+    # @option opts [String] :currency Only returns the licenses paid in this currency.
+    # @option opts [Float] :price Only returns the licenses paid exactly this amount, in major units of its currency: combine with &#x60;currency&#x60; to compare amounts of one currency. Licenses without a price are left out.
+    # @option opts [Float] :price_min Only returns the licenses paid at least this amount, in major units of its currency: combine with &#x60;currency&#x60; to compare amounts of one currency. Licenses without a price are left out.
+    # @option opts [Float] :price_max Only returns the licenses paid at most this amount, in major units of its currency: combine with &#x60;currency&#x60; to compare amounts of one currency. Licenses without a price are left out.
+    # @option opts [String] :has_price &#x60;true&#x60; only returns the licenses with a price, &#x60;false&#x60; only the ones without.
+    # @return [LicenseList]
+    def list_customer_licenses(customer_id, opts = {})
+      data, _status_code, _headers = list_customer_licenses_with_http_info(customer_id, opts)
+      data
+    end
+
+    # List the licenses of a customer
+    # Sorting by &#x60;lastActivatedAt&#x60; puts the licenses never activated last in both orders. Sorting by &#x60;price&#x60; compares the amounts whatever their currency, and puts the licenses without a price last in both orders.  **Token access**: customer tokens with the &#x60;license:read&#x60; permission (or the matching write one). A customer token reaches its own licenses.
+    # @param customer_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :page Page to return. Pages are numbered from 1: &#x60;1&#x60; is the first page. A page past the last one returns an empty &#x60;data&#x60;, not an error. Defaults to &#x60;1&#x60;. (default to 1)
+    # @option opts [Integer] :page_size Maximum number of items per page, from 1 to 100. Every page holds this many items except the last one, which can hold fewer. Defaults to &#x60;20&#x60;. (default to 20)
+    # @option opts [String] :sort Field to sort by, prefixed with &#x60;-&#x60; for descending order. Defaults to &#x60;-createdAt&#x60;. (default to '-createdAt')
+    # @option opts [String] :search Case-insensitive text the key contains.
+    # @option opts [String] :key Only returns the license with this exact key, case included. Keys of test products start with &#x60;TEST-&#x60;.
+    # @option opts [String] :policy_id Only returns the licenses following this policy.
+    # @option opts [String] :machine_version Only returns the licenses with at least one active machine running this version of the product.
+    # @option opts [LicenseStatus] :status Only returns the licenses with this status.
+    # @option opts [Time] :created_from Only returns the licenses created at or after this date.
+    # @option opts [Time] :created_to Only returns the licenses created at or before this date.
+    # @option opts [Time] :last_activated_from Only returns the licenses last activated at or after this date. Licenses never activated are left out.
+    # @option opts [Time] :last_activated_to Only returns the licenses last activated at or before this date. Licenses never activated are left out.
+    # @option opts [String] :never_activated &#x60;true&#x60; only returns the licenses never activated, &#x60;false&#x60; only the ones activated at least once.
+    # @option opts [Time] :expires_from Only returns the licenses expiring at or after this date. Licenses that never expire are left out.
+    # @option opts [Time] :expires_to Only returns the licenses expiring at or before this date. Licenses that never expire are left out.
+    # @option opts [String] :never_expires &#x60;true&#x60; only returns the licenses that never expire, &#x60;false&#x60; only the ones with an expiration date.
+    # @option opts [String] :currency Only returns the licenses paid in this currency.
+    # @option opts [Float] :price Only returns the licenses paid exactly this amount, in major units of its currency: combine with &#x60;currency&#x60; to compare amounts of one currency. Licenses without a price are left out.
+    # @option opts [Float] :price_min Only returns the licenses paid at least this amount, in major units of its currency: combine with &#x60;currency&#x60; to compare amounts of one currency. Licenses without a price are left out.
+    # @option opts [Float] :price_max Only returns the licenses paid at most this amount, in major units of its currency: combine with &#x60;currency&#x60; to compare amounts of one currency. Licenses without a price are left out.
+    # @option opts [String] :has_price &#x60;true&#x60; only returns the licenses with a price, &#x60;false&#x60; only the ones without.
+    # @return [Array<(LicenseList, Integer, Hash)>] LicenseList data, response status code and response headers
+    def list_customer_licenses_with_http_info(customer_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LicensesApi.list_customer_licenses ...'
+      end
+      # verify the required parameter 'customer_id' is set
+      if @api_client.config.client_side_validation && customer_id.nil?
+        fail ArgumentError, "Missing the required parameter 'customer_id' when calling LicensesApi.list_customer_licenses"
+      end
+      if @api_client.config.client_side_validation && !opts[:'page'].nil? && opts[:'page'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"page"]" when calling LicensesApi.list_customer_licenses, must be greater than or equal to 1.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'page_size'].nil? && opts[:'page_size'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"page_size"]" when calling LicensesApi.list_customer_licenses, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'page_size'].nil? && opts[:'page_size'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"page_size"]" when calling LicensesApi.list_customer_licenses, must be greater than or equal to 1.'
+      end
+
+      allowable_values = ["key", "-key", "createdAt", "-createdAt", "expiresAt", "-expiresAt", "maxMachines", "-maxMachines", "maxOfflineDurationSeconds", "-maxOfflineDurationSeconds", "lastActivatedAt", "-lastActivatedAt", "lockMajorAt", "-lockMajorAt", "lockMinorAt", "-lockMinorAt", "updatedAt", "-updatedAt", "price", "-price", "unknown_default_open_api"]
+      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[:'search'].nil? && opts[:'search'].to_s.length > 200
+        fail ArgumentError, 'invalid value for "opts[:"search"]" when calling LicensesApi.list_customer_licenses, the character length must be smaller than or equal to 200.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'search'].nil? && opts[:'search'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"search"]" when calling LicensesApi.list_customer_licenses, the character length must be greater than or equal to 1.'
+      end
+
+      allowable_values = ["true", "false", "unknown_default_open_api"]
+      if @api_client.config.client_side_validation && opts[:'never_activated'] && !allowable_values.include?(opts[:'never_activated'])
+        fail ArgumentError, "invalid value for \"never_activated\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["true", "false", "unknown_default_open_api"]
+      if @api_client.config.client_side_validation && opts[:'never_expires'] && !allowable_values.include?(opts[:'never_expires'])
+        fail ArgumentError, "invalid value for \"never_expires\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["true", "false", "unknown_default_open_api"]
+      if @api_client.config.client_side_validation && opts[:'has_price'] && !allowable_values.include?(opts[:'has_price'])
+        fail ArgumentError, "invalid value for \"has_price\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/v1/customers/{customerId}/licenses'.sub('{customerId}', CGI.escape(customer_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'page'] = opts[:'page'] if !opts[:'page'].nil?
+      query_params[:'pageSize'] = opts[:'page_size'] if !opts[:'page_size'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
+      query_params[:'search'] = opts[:'search'] if !opts[:'search'].nil?
+      query_params[:'key'] = opts[:'key'] if !opts[:'key'].nil?
+      query_params[:'policyId'] = opts[:'policy_id'] if !opts[:'policy_id'].nil?
+      query_params[:'machineVersion'] = opts[:'machine_version'] if !opts[:'machine_version'].nil?
+      query_params[:'status'] = opts[:'status'] if !opts[:'status'].nil?
+      query_params[:'createdFrom'] = opts[:'created_from'] if !opts[:'created_from'].nil?
+      query_params[:'createdTo'] = opts[:'created_to'] if !opts[:'created_to'].nil?
+      query_params[:'lastActivatedFrom'] = opts[:'last_activated_from'] if !opts[:'last_activated_from'].nil?
+      query_params[:'lastActivatedTo'] = opts[:'last_activated_to'] if !opts[:'last_activated_to'].nil?
+      query_params[:'neverActivated'] = opts[:'never_activated'] if !opts[:'never_activated'].nil?
+      query_params[:'expiresFrom'] = opts[:'expires_from'] if !opts[:'expires_from'].nil?
+      query_params[:'expiresTo'] = opts[:'expires_to'] if !opts[:'expires_to'].nil?
+      query_params[:'neverExpires'] = opts[:'never_expires'] if !opts[:'never_expires'].nil?
+      query_params[:'currency'] = opts[:'currency'] if !opts[:'currency'].nil?
+      query_params[:'price'] = opts[:'price'] if !opts[:'price'].nil?
+      query_params[:'priceMin'] = opts[:'price_min'] if !opts[:'price_min'].nil?
+      query_params[:'priceMax'] = opts[:'price_max'] if !opts[:'price_max'].nil?
+      query_params[:'hasPrice'] = opts[:'has_price'] if !opts[:'has_price'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) 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] || 'LicenseList'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey', 'token']
+
+      new_options = opts.merge(
+        :operation => :"LicensesApi.list_customer_licenses",
+        :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: LicensesApi#list_customer_licenses\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List the licenses of a product
+    # Sorting by `lastActivatedAt` puts the licenses never activated last in both orders. Sorting by `price` compares the amounts whatever their currency, and puts the licenses without a price last in both orders.
+    # @param product_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :page Page to return. Pages are numbered from 1: &#x60;1&#x60; is the first page. A page past the last one returns an empty &#x60;data&#x60;, not an error. Defaults to &#x60;1&#x60;. (default to 1)
+    # @option opts [Integer] :page_size Maximum number of items per page, from 1 to 100. Every page holds this many items except the last one, which can hold fewer. Defaults to &#x60;20&#x60;. (default to 20)
+    # @option opts [String] :sort Field to sort by, prefixed with &#x60;-&#x60; for descending order. Defaults to &#x60;-createdAt&#x60;. (default to '-createdAt')
+    # @option opts [String] :search Case-insensitive text the key contains.
+    # @option opts [String] :key Only returns the license with this exact key, case included. Keys of test products start with &#x60;TEST-&#x60;.
+    # @option opts [String] :policy_id Only returns the licenses following this policy.
+    # @option opts [String] :customer_id Only returns the licenses of this customer.
+    # @option opts [String] :machine_version Only returns the licenses with at least one active machine running this version of the product.
+    # @option opts [LicenseStatus] :status Only returns the licenses with this status.
+    # @option opts [Time] :created_from Only returns the licenses created at or after this date.
+    # @option opts [Time] :created_to Only returns the licenses created at or before this date.
+    # @option opts [Time] :last_activated_from Only returns the licenses last activated at or after this date. Licenses never activated are left out.
+    # @option opts [Time] :last_activated_to Only returns the licenses last activated at or before this date. Licenses never activated are left out.
+    # @option opts [String] :never_activated &#x60;true&#x60; only returns the licenses never activated, &#x60;false&#x60; only the ones activated at least once.
+    # @option opts [Time] :expires_from Only returns the licenses expiring at or after this date. Licenses that never expire are left out.
+    # @option opts [Time] :expires_to Only returns the licenses expiring at or before this date. Licenses that never expire are left out.
+    # @option opts [String] :never_expires &#x60;true&#x60; only returns the licenses that never expire, &#x60;false&#x60; only the ones with an expiration date.
+    # @option opts [String] :currency Only returns the licenses paid in this currency.
+    # @option opts [Float] :price Only returns the licenses paid exactly this amount, in major units of its currency: combine with &#x60;currency&#x60; to compare amounts of one currency. Licenses without a price are left out.
+    # @option opts [Float] :price_min Only returns the licenses paid at least this amount, in major units of its currency: combine with &#x60;currency&#x60; to compare amounts of one currency. Licenses without a price are left out.
+    # @option opts [Float] :price_max Only returns the licenses paid at most this amount, in major units of its currency: combine with &#x60;currency&#x60; to compare amounts of one currency. Licenses without a price are left out.
+    # @option opts [String] :has_price &#x60;true&#x60; only returns the licenses with a price, &#x60;false&#x60; only the ones without.
+    # @return [LicenseList]
+    def list_licenses(product_id, opts = {})
+      data, _status_code, _headers = list_licenses_with_http_info(product_id, opts)
+      data
+    end
+
+    # List the licenses of a product
+    # Sorting by &#x60;lastActivatedAt&#x60; puts the licenses never activated last in both orders. Sorting by &#x60;price&#x60; compares the amounts whatever their currency, and puts the licenses without a price last in both orders.
+    # @param product_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :page Page to return. Pages are numbered from 1: &#x60;1&#x60; is the first page. A page past the last one returns an empty &#x60;data&#x60;, not an error. Defaults to &#x60;1&#x60;. (default to 1)
+    # @option opts [Integer] :page_size Maximum number of items per page, from 1 to 100. Every page holds this many items except the last one, which can hold fewer. Defaults to &#x60;20&#x60;. (default to 20)
+    # @option opts [String] :sort Field to sort by, prefixed with &#x60;-&#x60; for descending order. Defaults to &#x60;-createdAt&#x60;. (default to '-createdAt')
+    # @option opts [String] :search Case-insensitive text the key contains.
+    # @option opts [String] :key Only returns the license with this exact key, case included. Keys of test products start with &#x60;TEST-&#x60;.
+    # @option opts [String] :policy_id Only returns the licenses following this policy.
+    # @option opts [String] :customer_id Only returns the licenses of this customer.
+    # @option opts [String] :machine_version Only returns the licenses with at least one active machine running this version of the product.
+    # @option opts [LicenseStatus] :status Only returns the licenses with this status.
+    # @option opts [Time] :created_from Only returns the licenses created at or after this date.
+    # @option opts [Time] :created_to Only returns the licenses created at or before this date.
+    # @option opts [Time] :last_activated_from Only returns the licenses last activated at or after this date. Licenses never activated are left out.
+    # @option opts [Time] :last_activated_to Only returns the licenses last activated at or before this date. Licenses never activated are left out.
+    # @option opts [String] :never_activated &#x60;true&#x60; only returns the licenses never activated, &#x60;false&#x60; only the ones activated at least once.
+    # @option opts [Time] :expires_from Only returns the licenses expiring at or after this date. Licenses that never expire are left out.
+    # @option opts [Time] :expires_to Only returns the licenses expiring at or before this date. Licenses that never expire are left out.
+    # @option opts [String] :never_expires &#x60;true&#x60; only returns the licenses that never expire, &#x60;false&#x60; only the ones with an expiration date.
+    # @option opts [String] :currency Only returns the licenses paid in this currency.
+    # @option opts [Float] :price Only returns the licenses paid exactly this amount, in major units of its currency: combine with &#x60;currency&#x60; to compare amounts of one currency. Licenses without a price are left out.
+    # @option opts [Float] :price_min Only returns the licenses paid at least this amount, in major units of its currency: combine with &#x60;currency&#x60; to compare amounts of one currency. Licenses without a price are left out.
+    # @option opts [Float] :price_max Only returns the licenses paid at most this amount, in major units of its currency: combine with &#x60;currency&#x60; to compare amounts of one currency. Licenses without a price are left out.
+    # @option opts [String] :has_price &#x60;true&#x60; only returns the licenses with a price, &#x60;false&#x60; only the ones without.
+    # @return [Array<(LicenseList, Integer, Hash)>] LicenseList data, response status code and response headers
+    def list_licenses_with_http_info(product_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LicensesApi.list_licenses ...'
+      end
+      # verify the required parameter 'product_id' is set
+      if @api_client.config.client_side_validation && product_id.nil?
+        fail ArgumentError, "Missing the required parameter 'product_id' when calling LicensesApi.list_licenses"
+      end
+      if @api_client.config.client_side_validation && !opts[:'page'].nil? && opts[:'page'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"page"]" when calling LicensesApi.list_licenses, must be greater than or equal to 1.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'page_size'].nil? && opts[:'page_size'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"page_size"]" when calling LicensesApi.list_licenses, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'page_size'].nil? && opts[:'page_size'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"page_size"]" when calling LicensesApi.list_licenses, must be greater than or equal to 1.'
+      end
+
+      allowable_values = ["key", "-key", "createdAt", "-createdAt", "expiresAt", "-expiresAt", "maxMachines", "-maxMachines", "maxOfflineDurationSeconds", "-maxOfflineDurationSeconds", "lastActivatedAt", "-lastActivatedAt", "lockMajorAt", "-lockMajorAt", "lockMinorAt", "-lockMinorAt", "updatedAt", "-updatedAt", "price", "-price", "unknown_default_open_api"]
+      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[:'search'].nil? && opts[:'search'].to_s.length > 200
+        fail ArgumentError, 'invalid value for "opts[:"search"]" when calling LicensesApi.list_licenses, the character length must be smaller than or equal to 200.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'search'].nil? && opts[:'search'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"search"]" when calling LicensesApi.list_licenses, the character length must be greater than or equal to 1.'
+      end
+
+      allowable_values = ["true", "false", "unknown_default_open_api"]
+      if @api_client.config.client_side_validation && opts[:'never_activated'] && !allowable_values.include?(opts[:'never_activated'])
+        fail ArgumentError, "invalid value for \"never_activated\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["true", "false", "unknown_default_open_api"]
+      if @api_client.config.client_side_validation && opts[:'never_expires'] && !allowable_values.include?(opts[:'never_expires'])
+        fail ArgumentError, "invalid value for \"never_expires\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["true", "false", "unknown_default_open_api"]
+      if @api_client.config.client_side_validation && opts[:'has_price'] && !allowable_values.include?(opts[:'has_price'])
+        fail ArgumentError, "invalid value for \"has_price\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/v1/products/{productId}/licenses'.sub('{productId}', CGI.escape(product_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'page'] = opts[:'page'] if !opts[:'page'].nil?
+      query_params[:'pageSize'] = opts[:'page_size'] if !opts[:'page_size'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
+      query_params[:'search'] = opts[:'search'] if !opts[:'search'].nil?
+      query_params[:'key'] = opts[:'key'] if !opts[:'key'].nil?
+      query_params[:'policyId'] = opts[:'policy_id'] if !opts[:'policy_id'].nil?
+      query_params[:'customerId'] = opts[:'customer_id'] if !opts[:'customer_id'].nil?
+      query_params[:'machineVersion'] = opts[:'machine_version'] if !opts[:'machine_version'].nil?
+      query_params[:'status'] = opts[:'status'] if !opts[:'status'].nil?
+      query_params[:'createdFrom'] = opts[:'created_from'] if !opts[:'created_from'].nil?
+      query_params[:'createdTo'] = opts[:'created_to'] if !opts[:'created_to'].nil?
+      query_params[:'lastActivatedFrom'] = opts[:'last_activated_from'] if !opts[:'last_activated_from'].nil?
+      query_params[:'lastActivatedTo'] = opts[:'last_activated_to'] if !opts[:'last_activated_to'].nil?
+      query_params[:'neverActivated'] = opts[:'never_activated'] if !opts[:'never_activated'].nil?
+      query_params[:'expiresFrom'] = opts[:'expires_from'] if !opts[:'expires_from'].nil?
+      query_params[:'expiresTo'] = opts[:'expires_to'] if !opts[:'expires_to'].nil?
+      query_params[:'neverExpires'] = opts[:'never_expires'] if !opts[:'never_expires'].nil?
+      query_params[:'currency'] = opts[:'currency'] if !opts[:'currency'].nil?
+      query_params[:'price'] = opts[:'price'] if !opts[:'price'].nil?
+      query_params[:'priceMin'] = opts[:'price_min'] if !opts[:'price_min'].nil?
+      query_params[:'priceMax'] = opts[:'price_max'] if !opts[:'price_max'].nil?
+      query_params[:'hasPrice'] = opts[:'has_price'] if !opts[:'has_price'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) 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] || 'LicenseList'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"LicensesApi.list_licenses",
+        :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: LicensesApi#list_licenses\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Email license keys to their customers
+    # Emails each customer the keys of its licenses among `ids`, with their expiration date: one email per customer, whatever their number of licenses. The licenses can belong to different products of the organization.  Test products only email the members of the organization, so testing never emails real customers: nothing is sent when a license of a test product belongs to a customer whose email isn't a member's.  **Required role permission**: `license:send` when called with a session, granted by the member's role. API keys aren't limited by roles.
+    # @param send_license_keys [SendLicenseKeys] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def send_license_keys(send_license_keys, opts = {})
+      send_license_keys_with_http_info(send_license_keys, opts)
+      nil
+    end
+
+    # Email license keys to their customers
+    # Emails each customer the keys of its licenses among &#x60;ids&#x60;, with their expiration date: one email per customer, whatever their number of licenses. The licenses can belong to different products of the organization.  Test products only email the members of the organization, so testing never emails real customers: nothing is sent when a license of a test product belongs to a customer whose email isn&#39;t a member&#39;s.  **Required role permission**: &#x60;license:send&#x60; when called with a session, granted by the member&#39;s role. API keys aren&#39;t limited by roles.
+    # @param send_license_keys [SendLicenseKeys] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def send_license_keys_with_http_info(send_license_keys, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LicensesApi.send_license_keys ...'
+      end
+      # verify the required parameter 'send_license_keys' is set
+      if @api_client.config.client_side_validation && send_license_keys.nil?
+        fail ArgumentError, "Missing the required parameter 'send_license_keys' when calling LicensesApi.send_license_keys"
+      end
+      # resource path
+      local_var_path = '/v1/licenses/send-keys'
+
+      # 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']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(send_license_keys)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"LicensesApi.send_license_keys",
+        :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: LicensesApi#send_license_keys\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Update a license
+    # The key, policy and customer of a license can't be changed: sending them does nothing.  The changes apply to the next validations of the key, not to the license tokens `validateKey` already returned, which stay valid until they expire. Lowering `maxMachines` doesn't deactivate machines: the ones already active keep validating, and new ones are refused until enough are deactivated.  **Required role permission**: `license:update` when called with a session, granted by the member's role. API keys aren't limited by roles.
+    # @param id [String] 
+    # @param update_license [UpdateLicense] 
+    # @param [Hash] opts the optional parameters
+    # @return [License]
+    def update_license(id, update_license, opts = {})
+      data, _status_code, _headers = update_license_with_http_info(id, update_license, opts)
+      data
+    end
+
+    # Update a license
+    # The key, policy and customer of a license can&#39;t be changed: sending them does nothing.  The changes apply to the next validations of the key, not to the license tokens &#x60;validateKey&#x60; already returned, which stay valid until they expire. Lowering &#x60;maxMachines&#x60; doesn&#39;t deactivate machines: the ones already active keep validating, and new ones are refused until enough are deactivated.  **Required role permission**: &#x60;license:update&#x60; when called with a session, granted by the member&#39;s role. API keys aren&#39;t limited by roles.
+    # @param id [String] 
+    # @param update_license [UpdateLicense] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(License, Integer, Hash)>] License data, response status code and response headers
+    def update_license_with_http_info(id, update_license, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LicensesApi.update_license ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling LicensesApi.update_license"
+      end
+      # verify the required parameter 'update_license' is set
+      if @api_client.config.client_side_validation && update_license.nil?
+        fail ArgumentError, "Missing the required parameter 'update_license' when calling LicensesApi.update_license"
+      end
+      # resource path
+      local_var_path = '/v1/licenses/{id}'.sub('{id}', CGI.escape(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']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(update_license)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'License'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"LicensesApi.update_license",
+        :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: LicensesApi#update_license\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Validate a license key
+    # Checks the license key of the product on a machine and returns a token the application can verify offline with the organization's public key. Doesn't need authentication.  The license must allow the `version`: up to its `maxVersion.version` when it has one, like `\"2.3\"` for every 2.3.z version and older. Its `maxVersion.lockMajorAt` and `maxVersion.lockMinorAt` are enforced once they hard-code `maxVersion.version`, within the hour they're reached. When it doesn't, the error's `latestAllowedVersion` is the latest release of the product the license allows, so the application can offer to install it.  The machine with the `fingerprint` is created when the license has none, and activated when it's deactivated, unless the license is already active on its maximum number of machines. A machine that's already active is never refused for the maximum number of machines, even when it was lowered below the number of active machines. Its `version`, and its `name` and `platform` when given, are updated: they can't be cleared.  The checks run in this order, and the first one failing answers: the license has expired, then it doesn't allow the version, then it's on its maximum number of machines. Each failure is recorded as a `license.validation_failed` event, except for keys that don't exist.  Changes to the license, like deactivating the machine or shortening its expiration, don't revoke the tokens already returned: the application only sees them when it validates its key again, at the latest when its token expires.
+    # @param product_id [String] 
+    # @param validate_key [ValidateKey] 
+    # @param [Hash] opts the optional parameters
+    # @return [LicenseToken]
+    def validate_key(product_id, validate_key, opts = {})
+      data, _status_code, _headers = validate_key_with_http_info(product_id, validate_key, opts)
+      data
+    end
+
+    # Validate a license key
+    # Checks the license key of the product on a machine and returns a token the application can verify offline with the organization&#39;s public key. Doesn&#39;t need authentication.  The license must allow the &#x60;version&#x60;: up to its &#x60;maxVersion.version&#x60; when it has one, like &#x60;\&quot;2.3\&quot;&#x60; for every 2.3.z version and older. Its &#x60;maxVersion.lockMajorAt&#x60; and &#x60;maxVersion.lockMinorAt&#x60; are enforced once they hard-code &#x60;maxVersion.version&#x60;, within the hour they&#39;re reached. When it doesn&#39;t, the error&#39;s &#x60;latestAllowedVersion&#x60; is the latest release of the product the license allows, so the application can offer to install it.  The machine with the &#x60;fingerprint&#x60; is created when the license has none, and activated when it&#39;s deactivated, unless the license is already active on its maximum number of machines. A machine that&#39;s already active is never refused for the maximum number of machines, even when it was lowered below the number of active machines. Its &#x60;version&#x60;, and its &#x60;name&#x60; and &#x60;platform&#x60; when given, are updated: they can&#39;t be cleared.  The checks run in this order, and the first one failing answers: the license has expired, then it doesn&#39;t allow the version, then it&#39;s on its maximum number of machines. Each failure is recorded as a &#x60;license.validation_failed&#x60; event, except for keys that don&#39;t exist.  Changes to the license, like deactivating the machine or shortening its expiration, don&#39;t revoke the tokens already returned: the application only sees them when it validates its key again, at the latest when its token expires.
+    # @param product_id [String] 
+    # @param validate_key [ValidateKey] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(LicenseToken, Integer, Hash)>] LicenseToken data, response status code and response headers
+    def validate_key_with_http_info(product_id, validate_key, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LicensesApi.validate_key ...'
+      end
+      # verify the required parameter 'product_id' is set
+      if @api_client.config.client_side_validation && product_id.nil?
+        fail ArgumentError, "Missing the required parameter 'product_id' when calling LicensesApi.validate_key"
+      end
+      # verify the required parameter 'validate_key' is set
+      if @api_client.config.client_side_validation && validate_key.nil?
+        fail ArgumentError, "Missing the required parameter 'validate_key' when calling LicensesApi.validate_key"
+      end
+      # resource path
+      local_var_path = '/v1/products/{productId}/validate-key'.sub('{productId}', CGI.escape(product_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']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(validate_key)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LicenseToken'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"LicensesApi.validate_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: LicensesApi#validate_key\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end