api-sdk-rb 1.11.66 → 1.11.111

data/lib/api-sdk-rb/api/partners_api.rb

@@ -19,8 +19,102 @@ module ApiSdkRb
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
+    # Confirm a partner's adapter address with the code that was emailed to it
+    # Some credentials are an email address Widgetic sends a widget's messages to (`confirmation: email_code` in `getPartnerAdapterConnections`). Saving one with `setPartnerAdapterConnection` emails a six-digit code to it; this gives the code back. Only then is the address used: until it is confirmed, the widgets of the partner's customers that need it are not charged and their visitors are told the feature is unavailable.  The code works for 30 minutes and for five wrong tries. After that, save the address again and a new code is emailed (not sooner than a minute after the last one). A code that is not made of digits is refused without counting as a try.  Confirming an address that is already confirmed answers 200 with the same state, so a retry of a request that went through is harmless. Saving a different address, or the same one before it was confirmed, starts again.  This needs an API key with full access. The caller must be the person who administers the partner, or a Widgetic administrator. 
+    # @param partner_id [String] The partner that keeps the address
+    # @param adapter_id [String] The adapter the address is for
+    # @param credential_key [String] The credential's name within the adapter
+    # @param confirm_adapter_connection_request [ConfirmAdapterConnectionRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [SetUserAdapterConnection200Response]
+    def confirm_partner_adapter_connection_0(partner_id, adapter_id, credential_key, confirm_adapter_connection_request, opts = {})
+      data, _status_code, _headers = confirm_partner_adapter_connection_0_with_http_info(partner_id, adapter_id, credential_key, confirm_adapter_connection_request, opts)
+      data
+    end
+
+    # Confirm a partner's adapter address with the code that was emailed to it
+    # Some credentials are an email address Widgetic sends a widget's messages to (`confirmation: email_code` in `getPartnerAdapterConnections`). Saving one with `setPartnerAdapterConnection` emails a six-digit code to it; this gives the code back. Only then is the address used: until it is confirmed, the widgets of the partner's customers that need it are not charged and their visitors are told the feature is unavailable.  The code works for 30 minutes and for five wrong tries. After that, save the address again and a new code is emailed (not sooner than a minute after the last one). A code that is not made of digits is refused without counting as a try.  Confirming an address that is already confirmed answers 200 with the same state, so a retry of a request that went through is harmless. Saving a different address, or the same one before it was confirmed, starts again.  This needs an API key with full access. The caller must be the person who administers the partner, or a Widgetic administrator. 
+    # @param partner_id [String] The partner that keeps the address
+    # @param adapter_id [String] The adapter the address is for
+    # @param credential_key [String] The credential's name within the adapter
+    # @param confirm_adapter_connection_request [ConfirmAdapterConnectionRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SetUserAdapterConnection200Response, Integer, Hash)>] SetUserAdapterConnection200Response data, response status code and response headers
+    def confirm_partner_adapter_connection_0_with_http_info(partner_id, adapter_id, credential_key, confirm_adapter_connection_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PartnersApi.confirm_partner_adapter_connection_0 ...'
+      end
+      # verify the required parameter 'partner_id' is set
+      if @api_client.config.client_side_validation && partner_id.nil?
+        fail ArgumentError, "Missing the required parameter 'partner_id' when calling PartnersApi.confirm_partner_adapter_connection_0"
+      end
+      # verify the required parameter 'adapter_id' is set
+      if @api_client.config.client_side_validation && adapter_id.nil?
+        fail ArgumentError, "Missing the required parameter 'adapter_id' when calling PartnersApi.confirm_partner_adapter_connection_0"
+      end
+      if @api_client.config.client_side_validation && adapter_id.to_s.length > 40
+        fail ArgumentError, 'invalid value for "adapter_id" when calling PartnersApi.confirm_partner_adapter_connection_0, the character length must be smaller than or equal to 40.'
+      end
+
+      # verify the required parameter 'credential_key' is set
+      if @api_client.config.client_side_validation && credential_key.nil?
+        fail ArgumentError, "Missing the required parameter 'credential_key' when calling PartnersApi.confirm_partner_adapter_connection_0"
+      end
+      if @api_client.config.client_side_validation && credential_key.to_s.length > 40
+        fail ArgumentError, 'invalid value for "credential_key" when calling PartnersApi.confirm_partner_adapter_connection_0, the character length must be smaller than or equal to 40.'
+      end
+
+      # verify the required parameter 'confirm_adapter_connection_request' is set
+      if @api_client.config.client_side_validation && confirm_adapter_connection_request.nil?
+        fail ArgumentError, "Missing the required parameter 'confirm_adapter_connection_request' when calling PartnersApi.confirm_partner_adapter_connection_0"
+      end
+      # resource path
+      local_var_path = '/partners/{partnerId}/adapter-connections/{adapterId}/{credentialKey}/confirm'.sub('{' + 'partnerId' + '}', CGI.escape(partner_id.to_s)).sub('{' + 'adapterId' + '}', CGI.escape(adapter_id.to_s)).sub('{' + 'credentialKey' + '}', CGI.escape(credential_key.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(confirm_adapter_connection_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SetUserAdapterConnection200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"PartnersApi.confirm_partner_adapter_connection_0",
+        :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: PartnersApi#confirm_partner_adapter_connection_0\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Buy extra credits for a partner
-    # Asks Widgetic for an invoice for extra credits, on top of the credits of the contract. Name the dollars; the invoice is for the most whole credits they buy at the **list price** of a credit (the price a contract may lower belongs to the contract), so it is never for more than you asked: 12.34 buys 123 credits and the invoice says 12.30. The smallest purchase is 10 dollars and one request buys at most 100000 (ask Widgetic for an invoice for more).  Pay the invoice with the link in the answer. When it is paid the credits are added **once, for good**, to the account of the person who administers the partner, which is the account everything the partner builds is charged to (`getPartnerCreditBalance` shows it). Extra credits **do not expire**, unlike the credits of a contract period, which end with it. Nothing is added before the invoice is paid, and an unpaid invoice for extra credits never stops the partner: only an unpaid invoice of the contract does (`payment_arrears`).  Allowed whatever the partner's standing: a partner that has run out of credits, or is stopped for an unpaid contract invoice, can still buy. No contract is needed.  An `Idempotency-Key` is required, and it is what makes a retry safe: the same key with the same body returns the invoice already issued, the same key with a different body is refused with 422, and a duplicate that arrives while the first is still running is refused with 409. Use one key per purchase you mean to make, and a new key for the next one. At most 10 requests an hour.  Who may ask: the person who administers the partner, or a Widgetic administrator. A key limited to scopes needs `billing:write`. 
+    # Asks Widgetic for an invoice for extra credits, on top of the credits of the contract. Name the dollars; the invoice is for the most whole credits they buy at the **list price** of a credit (the price a contract may lower belongs to the contract), so it is never for more than you asked: 12.34 buys 123 credits and the invoice says 12.30. The smallest purchase is 10 dollars and one request buys at most 100000 (ask Widgetic for an invoice for more).  Pay the invoice with the link in the answer. When it is paid the credits are added **once, for good**, to the account of the person who administers the partner, which is the account everything the partner builds is charged to (`getPartnerCreditBalance` shows it). Extra credits **do not expire**, unlike the credits of a contract period, which end with it. Nothing is added before the invoice is paid, and an unpaid invoice for extra credits never stops the partner: only an unpaid invoice of the contract does (`payment_arrears`).  Available only to partners that have an active paid contract in force with Widgetic (`NO_PAID_CONTRACT` when none is in force) and no overdue contract invoice (`CONTRACT_INVOICE_OVERDUE` while a contract invoice is past its due day). A partner that has run out of credits during its period can buy more at the list price.  An `Idempotency-Key` is required, and it is what makes a retry safe: the same key with the same body returns the invoice already issued, the same key with a different body is refused with 422, and a duplicate that arrives while the first is still running is refused with 409. Use one key per purchase you mean to make, and a new key for the next one. At most 10 requests an hour.  Who may ask: the person who administers the partner, or a Widgetic administrator. A key limited to scopes needs `billing:write`. 
     # @param partner_id [String] Partner ID
     # @param idempotency_key [String] A key of your own for this purchase, so that a retry cannot make a second invoice
     # @param request_extra_credits [RequestExtraCredits] 
@@ -32,7 +126,7 @@ module ApiSdkRb
     end
 
     # Buy extra credits for a partner
-    # Asks Widgetic for an invoice for extra credits, on top of the credits of the contract. Name the dollars; the invoice is for the most whole credits they buy at the **list price** of a credit (the price a contract may lower belongs to the contract), so it is never for more than you asked: 12.34 buys 123 credits and the invoice says 12.30. The smallest purchase is 10 dollars and one request buys at most 100000 (ask Widgetic for an invoice for more).  Pay the invoice with the link in the answer. When it is paid the credits are added **once, for good**, to the account of the person who administers the partner, which is the account everything the partner builds is charged to (&#x60;getPartnerCreditBalance&#x60; shows it). Extra credits **do not expire**, unlike the credits of a contract period, which end with it. Nothing is added before the invoice is paid, and an unpaid invoice for extra credits never stops the partner: only an unpaid invoice of the contract does (&#x60;payment_arrears&#x60;).  Allowed whatever the partner&#39;s standing: a partner that has run out of credits, or is stopped for an unpaid contract invoice, can still buy. No contract is needed.  An &#x60;Idempotency-Key&#x60; is required, and it is what makes a retry safe: the same key with the same body returns the invoice already issued, the same key with a different body is refused with 422, and a duplicate that arrives while the first is still running is refused with 409. Use one key per purchase you mean to make, and a new key for the next one. At most 10 requests an hour.  Who may ask: the person who administers the partner, or a Widgetic administrator. A key limited to scopes needs &#x60;billing:write&#x60;. 
+    # Asks Widgetic for an invoice for extra credits, on top of the credits of the contract. Name the dollars; the invoice is for the most whole credits they buy at the **list price** of a credit (the price a contract may lower belongs to the contract), so it is never for more than you asked: 12.34 buys 123 credits and the invoice says 12.30. The smallest purchase is 10 dollars and one request buys at most 100000 (ask Widgetic for an invoice for more).  Pay the invoice with the link in the answer. When it is paid the credits are added **once, for good**, to the account of the person who administers the partner, which is the account everything the partner builds is charged to (&#x60;getPartnerCreditBalance&#x60; shows it). Extra credits **do not expire**, unlike the credits of a contract period, which end with it. Nothing is added before the invoice is paid, and an unpaid invoice for extra credits never stops the partner: only an unpaid invoice of the contract does (&#x60;payment_arrears&#x60;).  Available only to partners that have an active paid contract in force with Widgetic (&#x60;NO_PAID_CONTRACT&#x60; when none is in force) and no overdue contract invoice (&#x60;CONTRACT_INVOICE_OVERDUE&#x60; while a contract invoice is past its due day). A partner that has run out of credits during its period can buy more at the list price.  An &#x60;Idempotency-Key&#x60; is required, and it is what makes a retry safe: the same key with the same body returns the invoice already issued, the same key with a different body is refused with 422, and a duplicate that arrives while the first is still running is refused with 409. Use one key per purchase you mean to make, and a new key for the next one. At most 10 requests an hour.  Who may ask: the person who administers the partner, or a Widgetic administrator. A key limited to scopes needs &#x60;billing:write&#x60;. 
     # @param partner_id [String] Partner ID
     # @param idempotency_key [String] A key of your own for this purchase, so that a retry cannot make a second invoice
     # @param request_extra_credits [RequestExtraCredits] 
@@ -1457,6 +1551,69 @@ module ApiSdkRb
       return data, status_code, headers
     end
 
+    # List the workflows a partner offers as places to start
+    # The partner's starting points, ordered by `position` and then by `key`: the published workflows it offers its managed users when they make a new workflow. Each says whether people can start from it now and, when they cannot, why. The list is the same for every managed user, and a managed user is shown only what is available.  A starting point is one of the partner account's own published workflows, built from compositions the account made for itself (not for a customer or a team) and from widgets the partner already offers as presets (`setPartnerPreset`), and it uses at most 10 widgets. A partner offers up to 50.  The caller must be the person who administers the partner (an API key of that account works), or a Widgetic administrator. 
+    # @param partner_id [String] The partner whose starting points to list
+    # @param [Hash] opts the optional parameters
+    # @return [ListPartnerWorkflowPresets200Response]
+    def list_partner_workflow_presets_0(partner_id, opts = {})
+      data, _status_code, _headers = list_partner_workflow_presets_0_with_http_info(partner_id, opts)
+      data
+    end
+
+    # List the workflows a partner offers as places to start
+    # The partner&#39;s starting points, ordered by &#x60;position&#x60; and then by &#x60;key&#x60;: the published workflows it offers its managed users when they make a new workflow. Each says whether people can start from it now and, when they cannot, why. The list is the same for every managed user, and a managed user is shown only what is available.  A starting point is one of the partner account&#39;s own published workflows, built from compositions the account made for itself (not for a customer or a team) and from widgets the partner already offers as presets (&#x60;setPartnerPreset&#x60;), and it uses at most 10 widgets. A partner offers up to 50.  The caller must be the person who administers the partner (an API key of that account works), or a Widgetic administrator. 
+    # @param partner_id [String] The partner whose starting points to list
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ListPartnerWorkflowPresets200Response, Integer, Hash)>] ListPartnerWorkflowPresets200Response data, response status code and response headers
+    def list_partner_workflow_presets_0_with_http_info(partner_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PartnersApi.list_partner_workflow_presets_0 ...'
+      end
+      # verify the required parameter 'partner_id' is set
+      if @api_client.config.client_side_validation && partner_id.nil?
+        fail ArgumentError, "Missing the required parameter 'partner_id' when calling PartnersApi.list_partner_workflow_presets_0"
+      end
+      # resource path
+      local_var_path = '/partners/{partnerId}/workflow-presets'.sub('{' + 'partnerId' + '}', CGI.escape(partner_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] || 'ListPartnerWorkflowPresets200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"PartnersApi.list_partner_workflow_presets_0",
+        :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: PartnersApi#list_partner_workflow_presets_0\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Remove an adapter key from a partner
     # Removes a key an adapter was given. The adapter stops working for the widgets of the partner's customers that need it: their visitors are told the feature is unavailable. Nothing else of the widgets changes, and connecting a key again brings them back.  Removing a key that is not connected answers 200 with `removed: false`: the state asked for is the state it is in. A key of an adapter that has since been retired from the catalog can still be removed.  This needs an API key with full access. The caller must be the person who administers the partner, or a Widgetic administrator. 
     # @param partner_id [String] The partner that keeps the key
@@ -1740,6 +1897,80 @@ module ApiSdkRb
       return data, status_code, headers
     end
 
+    # Stop offering a workflow as a place to start
+    # Removes the starting point under `key`. The workflow itself is not touched, and neither are the workflows people already started from it.  Removing a starting point the partner does not offer is not an error: the answer is `removed: false`. 
+    # @param partner_id [String] The partner whose starting point to remove
+    # @param key [String] The key of the starting point to remove
+    # @param [Hash] opts the optional parameters
+    # @return [RemovePartnerWorkflowPreset200Response]
+    def remove_partner_workflow_preset_0(partner_id, key, opts = {})
+      data, _status_code, _headers = remove_partner_workflow_preset_0_with_http_info(partner_id, key, opts)
+      data
+    end
+
+    # Stop offering a workflow as a place to start
+    # Removes the starting point under &#x60;key&#x60;. The workflow itself is not touched, and neither are the workflows people already started from it.  Removing a starting point the partner does not offer is not an error: the answer is &#x60;removed: false&#x60;. 
+    # @param partner_id [String] The partner whose starting point to remove
+    # @param key [String] The key of the starting point to remove
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(RemovePartnerWorkflowPreset200Response, Integer, Hash)>] RemovePartnerWorkflowPreset200Response data, response status code and response headers
+    def remove_partner_workflow_preset_0_with_http_info(partner_id, key, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PartnersApi.remove_partner_workflow_preset_0 ...'
+      end
+      # verify the required parameter 'partner_id' is set
+      if @api_client.config.client_side_validation && partner_id.nil?
+        fail ArgumentError, "Missing the required parameter 'partner_id' when calling PartnersApi.remove_partner_workflow_preset_0"
+      end
+      # verify the required parameter 'key' is set
+      if @api_client.config.client_side_validation && key.nil?
+        fail ArgumentError, "Missing the required parameter 'key' when calling PartnersApi.remove_partner_workflow_preset_0"
+      end
+      pattern = Regexp.new(/^[a-z0-9][a-z0-9_-]{0,63}$/)
+      if @api_client.config.client_side_validation && key !~ pattern
+        fail ArgumentError, "invalid value for 'key' when calling PartnersApi.remove_partner_workflow_preset_0, must conform to the pattern #{pattern}."
+      end
+
+      # resource path
+      local_var_path = '/partners/{partnerId}/workflow-presets/{key}'.sub('{' + 'partnerId' + '}', CGI.escape(partner_id.to_s)).sub('{' + 'key' + '}', CGI.escape(key.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] || 'RemovePartnerWorkflowPreset200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"PartnersApi.remove_partner_workflow_preset_0",
+        :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: PartnersApi#remove_partner_workflow_preset_0\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Send a webhook delivery again
     # Sends one earlier **webhook** delivery again to your **current** webhook address, with the same event `id` (`webhook-id`) as the original notification so a receiver that remembers ids can ignore a duplicate, and a new `createdAt` and signature made with your current secret. The attempt is recorded in the delivery log as a new row that points at the delivery you replayed.  Set a webhook address (and secret) under notification settings before you replay. Changing the settings needs an API key with full access. The caller must be the person who administers the partner, or a Widgetic administrator. 
     # @param partner_id [String] The partner whose delivery to replay
@@ -2090,7 +2321,7 @@ module ApiSdkRb
     end
 
     # Connect an adapter key to a partner
-    # Gives an adapter the key it needs to act through a service the partner has an account with, for the widgets of the customers the partner manages. Take the `adapterId` and `credentialKey` from `getPartnerAdapterConnections`. Saving a key that is already connected replaces it.  **What Widgetic does with it.** The key is stored encrypted, bound to this partner, this adapter and this credential, so that a stored value cannot be moved to another. It is never returned, never logged and never shown to a visitor of a widget or to your customers. A server of Widgetic opens it for the one call a widget makes through the adapter, uses it to call the provider on the partner's behalf, and discards it. To cut that off, remove the key here, or revoke it with the provider.  **What is checked.** That the adapter exists and takes this credential, that a partner may keep it (some are for an owner only) and that the text is one line of at most 2048 characters. Whether the provider accepts the key is not checked here: it shows the first time a widget uses it.  A widget whose adapter has no key connected is not charged and does not run that adapter: its visitors are told the feature is unavailable, and the partner is told once a day what to connect.  This needs an API key with full access. The caller must be the person who administers the partner, or a Widgetic administrator. A retry is harmless: saving the same key twice only refreshes when it was set. 
+    # Gives an adapter the key it needs to act through a service the partner has an account with, for the widgets of the customers the partner manages. Take the `adapterId` and `credentialKey` from `getPartnerAdapterConnections`. Saving a key that is already connected replaces it.  **What Widgetic does with it.** The key is stored encrypted, bound to this partner, this adapter and this credential, so that a stored value cannot be moved to another. It is never returned, never logged and never shown to a visitor of a widget or to your customers. A server of Widgetic opens it for the one call a widget makes through the adapter, uses it to call the provider on the partner's behalf, and discards it. To cut that off, remove the key here, or revoke it with the provider.  **What is checked.** That the adapter exists and takes this credential, that a partner may keep it (some are for an owner only) and that the text is one line of at most 2048 characters. Whether the provider accepts the key is not checked here: it shows the first time a widget uses it.  **An address that has to be confirmed.** Some credentials are not a key but the email address Widgetic sends a widget's messages to (`confirmation: email_code` in `getPartnerAdapterConnections`). Saving one checks that it is one email address and emails a six-digit code to it; the answer says `awaitingConfirmation: true`, and nothing is sent to the address until the code is given back with `confirmPartnerAdapterConnection`. Saving the same address again before it is confirmed emails a new code (not sooner than a minute after the last); saving the address that is already confirmed changes nothing. If the code cannot be emailed, nothing is saved.  A widget whose adapter has no key connected, or whose address is not confirmed yet, is not charged and does not run that adapter: its visitors are told the feature is unavailable, and the partner is told once a day what to do.  This needs an API key with full access. The caller must be the person who administers the partner, or a Widgetic administrator. A retry is harmless: saving the same key twice only refreshes when it was set. 
     # @param partner_id [String] The partner that keeps the key
     # @param adapter_id [String] The adapter the key is for
     # @param credential_key [String] The key&#39;s name within the adapter
@@ -2103,7 +2334,7 @@ module ApiSdkRb
     end
 
     # Connect an adapter key to a partner
-    # Gives an adapter the key it needs to act through a service the partner has an account with, for the widgets of the customers the partner manages. Take the &#x60;adapterId&#x60; and &#x60;credentialKey&#x60; from &#x60;getPartnerAdapterConnections&#x60;. Saving a key that is already connected replaces it.  **What Widgetic does with it.** The key is stored encrypted, bound to this partner, this adapter and this credential, so that a stored value cannot be moved to another. It is never returned, never logged and never shown to a visitor of a widget or to your customers. A server of Widgetic opens it for the one call a widget makes through the adapter, uses it to call the provider on the partner&#39;s behalf, and discards it. To cut that off, remove the key here, or revoke it with the provider.  **What is checked.** That the adapter exists and takes this credential, that a partner may keep it (some are for an owner only) and that the text is one line of at most 2048 characters. Whether the provider accepts the key is not checked here: it shows the first time a widget uses it.  A widget whose adapter has no key connected is not charged and does not run that adapter: its visitors are told the feature is unavailable, and the partner is told once a day what to connect.  This needs an API key with full access. The caller must be the person who administers the partner, or a Widgetic administrator. A retry is harmless: saving the same key twice only refreshes when it was set. 
+    # Gives an adapter the key it needs to act through a service the partner has an account with, for the widgets of the customers the partner manages. Take the &#x60;adapterId&#x60; and &#x60;credentialKey&#x60; from &#x60;getPartnerAdapterConnections&#x60;. Saving a key that is already connected replaces it.  **What Widgetic does with it.** The key is stored encrypted, bound to this partner, this adapter and this credential, so that a stored value cannot be moved to another. It is never returned, never logged and never shown to a visitor of a widget or to your customers. A server of Widgetic opens it for the one call a widget makes through the adapter, uses it to call the provider on the partner&#39;s behalf, and discards it. To cut that off, remove the key here, or revoke it with the provider.  **What is checked.** That the adapter exists and takes this credential, that a partner may keep it (some are for an owner only) and that the text is one line of at most 2048 characters. Whether the provider accepts the key is not checked here: it shows the first time a widget uses it.  **An address that has to be confirmed.** Some credentials are not a key but the email address Widgetic sends a widget&#39;s messages to (&#x60;confirmation: email_code&#x60; in &#x60;getPartnerAdapterConnections&#x60;). Saving one checks that it is one email address and emails a six-digit code to it; the answer says &#x60;awaitingConfirmation: true&#x60;, and nothing is sent to the address until the code is given back with &#x60;confirmPartnerAdapterConnection&#x60;. Saving the same address again before it is confirmed emails a new code (not sooner than a minute after the last); saving the address that is already confirmed changes nothing. If the code cannot be emailed, nothing is saved.  A widget whose adapter has no key connected, or whose address is not confirmed yet, is not charged and does not run that adapter: its visitors are told the feature is unavailable, and the partner is told once a day what to do.  This needs an API key with full access. The caller must be the person who administers the partner, or a Widgetic administrator. A retry is harmless: saving the same key twice only refreshes when it was set. 
     # @param partner_id [String] The partner that keeps the key
     # @param adapter_id [String] The adapter the key is for
     # @param credential_key [String] The key&#39;s name within the adapter
@@ -2490,6 +2721,91 @@ module ApiSdkRb
       return data, status_code, headers
     end
 
+    # Offer a workflow as a place to start, or replace what a key offers
+    # Offers one of the partner account's own published workflows to its managed users under `key`. If the partner already offers something under that key it is replaced, so sending the same request twice is safe. Saving replaces the whole starting point: a `title`, `description` or `position` you leave out goes back to its default.  Keys are 1 to 64 characters: lowercase letters, digits, hyphens and underscores, the first a letter or a digit.  A workflow is offered once. What people get is the workflow's live version as it is when they start, so publishing the workflow changes what new starts get; workflows people already started are never touched. The offer is refused, and `error.details.reason` says why, when the workflow:  - is not the partner account's own (a workflow of a team or of a customer, or of somebody else), or does not exist:   404, the same for both; - is archived (409 `workflow_archived`), or was never published (409 `workflow_not_published`); - shows no composition (422 `workflow_empty`), or a block shows a composition made for a customer or a team   (422 `composition_not_own`); - chains more than 10 widgets (422 `too_many_widgets`), or a widget that the partner does not offer as a preset   (422 `widget_not_preset`; `error.details.widgets` lists them, each with its `id` and `name`, so they can be offered   first with `setPartnerPreset`); - is already offered under another key (409 `workflow_already_offered`; `error.details.key` says which), or the   partner already offers 50 (409 `too_many_presets`).  The caller must be the person who administers the partner (an API key of that account works), or a Widgetic administrator, who offers the partner's workflow on its behalf. 
+    # @param partner_id [String] The partner whose starting point to set
+    # @param key [String] The name your code and the picker use for the starting point
+    # @param offer_workflow_preset_request [OfferWorkflowPresetRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [SetPartnerWorkflowPreset200Response]
+    def set_partner_workflow_preset_0(partner_id, key, offer_workflow_preset_request, opts = {})
+      data, _status_code, _headers = set_partner_workflow_preset_0_with_http_info(partner_id, key, offer_workflow_preset_request, opts)
+      data
+    end
+
+    # Offer a workflow as a place to start, or replace what a key offers
+    # Offers one of the partner account&#39;s own published workflows to its managed users under &#x60;key&#x60;. If the partner already offers something under that key it is replaced, so sending the same request twice is safe. Saving replaces the whole starting point: a &#x60;title&#x60;, &#x60;description&#x60; or &#x60;position&#x60; you leave out goes back to its default.  Keys are 1 to 64 characters: lowercase letters, digits, hyphens and underscores, the first a letter or a digit.  A workflow is offered once. What people get is the workflow&#39;s live version as it is when they start, so publishing the workflow changes what new starts get; workflows people already started are never touched. The offer is refused, and &#x60;error.details.reason&#x60; says why, when the workflow:  - is not the partner account&#39;s own (a workflow of a team or of a customer, or of somebody else), or does not exist:   404, the same for both; - is archived (409 &#x60;workflow_archived&#x60;), or was never published (409 &#x60;workflow_not_published&#x60;); - shows no composition (422 &#x60;workflow_empty&#x60;), or a block shows a composition made for a customer or a team   (422 &#x60;composition_not_own&#x60;); - chains more than 10 widgets (422 &#x60;too_many_widgets&#x60;), or a widget that the partner does not offer as a preset   (422 &#x60;widget_not_preset&#x60;; &#x60;error.details.widgets&#x60; lists them, each with its &#x60;id&#x60; and &#x60;name&#x60;, so they can be offered   first with &#x60;setPartnerPreset&#x60;); - is already offered under another key (409 &#x60;workflow_already_offered&#x60;; &#x60;error.details.key&#x60; says which), or the   partner already offers 50 (409 &#x60;too_many_presets&#x60;).  The caller must be the person who administers the partner (an API key of that account works), or a Widgetic administrator, who offers the partner&#39;s workflow on its behalf. 
+    # @param partner_id [String] The partner whose starting point to set
+    # @param key [String] The name your code and the picker use for the starting point
+    # @param offer_workflow_preset_request [OfferWorkflowPresetRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SetPartnerWorkflowPreset200Response, Integer, Hash)>] SetPartnerWorkflowPreset200Response data, response status code and response headers
+    def set_partner_workflow_preset_0_with_http_info(partner_id, key, offer_workflow_preset_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PartnersApi.set_partner_workflow_preset_0 ...'
+      end
+      # verify the required parameter 'partner_id' is set
+      if @api_client.config.client_side_validation && partner_id.nil?
+        fail ArgumentError, "Missing the required parameter 'partner_id' when calling PartnersApi.set_partner_workflow_preset_0"
+      end
+      # verify the required parameter 'key' is set
+      if @api_client.config.client_side_validation && key.nil?
+        fail ArgumentError, "Missing the required parameter 'key' when calling PartnersApi.set_partner_workflow_preset_0"
+      end
+      pattern = Regexp.new(/^[a-z0-9][a-z0-9_-]{0,63}$/)
+      if @api_client.config.client_side_validation && key !~ pattern
+        fail ArgumentError, "invalid value for 'key' when calling PartnersApi.set_partner_workflow_preset_0, must conform to the pattern #{pattern}."
+      end
+
+      # verify the required parameter 'offer_workflow_preset_request' is set
+      if @api_client.config.client_side_validation && offer_workflow_preset_request.nil?
+        fail ArgumentError, "Missing the required parameter 'offer_workflow_preset_request' when calling PartnersApi.set_partner_workflow_preset_0"
+      end
+      # resource path
+      local_var_path = '/partners/{partnerId}/workflow-presets/{key}'.sub('{' + 'partnerId' + '}', CGI.escape(partner_id.to_s)).sub('{' + 'key' + '}', CGI.escape(key.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(offer_workflow_preset_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SetPartnerWorkflowPreset200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"PartnersApi.set_partner_workflow_preset_0",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PUT, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PartnersApi#set_partner_workflow_preset_0\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Require a signed context, or stop requiring it
     # Chooses what the gateway does with an entry whose `context` carries no valid signature.  With `required: false` (the default) an entry that carries a signature is checked and refused when the signature is wrong or out of date, and an entry that carries none is accepted, as it always was. With `required: true` an entry without a valid signature is refused with 403 `CONTEXT_SIGNATURE_REQUIRED`: use it once every page of yours that embeds a composition signs its context.  Signatures cannot be required before you have made a secret (`rotatePartnerEntryContextSecret`): the answer is 409, so that you cannot lock your own compositions out of taking entries. The change reaches every part of the gateway within a minute.  Saving the same choice twice leaves the same state, so a retry is harmless and `Idempotency-Key` is optional. This needs an API key with full access. The caller must be the person who administers the partner, or a Widgetic administrator. 
     # @param partner_id [String] The partner whose context signing to change