api-sdk-rb 1.11.66 → 1.11.111

data/docs/PartnerCustomization.md

@@ -39,8 +39,8 @@ instance = ApiSdkRb::PartnerCustomization.new(
   billing_cycle: annual,
   minimum_commitment_months: 12,
   support_sla: 99.9%,
-  contract_start_date: Mon Jan 01 02:00:00 EET 2024,
-  contract_end_date: Tue Dec 31 02:00:00 EET 2024,
+  contract_start_date: Mon Jan 01 01:00:00 CET 2024,
+  contract_end_date: Tue Dec 31 01:00:00 CET 2024,
   notes: Special pricing for strategic partner,
   is_active_contract: true,
   created_at: null,

data/docs/PartnerNotification.md

@@ -9,7 +9,7 @@
 | **title** | **String** | One line that says what happened |  |
 | **body** | **String** | A few sentences that say what happened and what to do about it |  |
 | **tone** | **String** | How serious it is |  |
-| **data** | **Hash<String, Object>** | The facts of the event, named in camelCase. An invoice event carries `invoiceNumber`, `subtotal`, `taxAmount`, `total`, `currency`, `dueDate`, `hostedInvoiceUrl` (the page where it is paid) and `purpose` (`contract`, or `extra_credits` for credits you bought on top of the contract: an unpaid invoice for extra credits never stops the account, the credits are just not added until it is paid); a payment adds `paidAt`, a failed payment `reason`, a reminder `daysUntilDue` or `daysOverdue`. A credits event carries `band` (`low` or `empty`), `balance` and `threshold`. `credits.managed_user_cap_reached` (one of your managed users used its monthly credits and a request was refused) goes to your webhook only when subscribed, once per managed user each month, and carries `managedUserId`, `externalId`, `monthlyCredits`, `creditsUsed`, `resetsAt` and `reachedAt`. A standing event carries `status`, `previousStatus` and `reason`; `partner.paused` with `status: payment_arrears` means that an overdue invoice stopped the account (nobody paused it, and `reason` names the invoice), and `partner.resumed` with `previousStatus: payment_arrears` means that its payment ended that. A storage event carries `reason` and `checkedAt`. Content events (`composition.created`, `composition.updated`, `widget.published`, `upload.created`, `entry.created`) go to your webhook only when subscribed; they do not appear in the dashboard list. `composition.created` carries `compositionId`, `widgetId`, `name`, `managedUserId`, `externalId` and `createdAt`; `composition.updated` carries `compositionId`, `widgetId`, `name`, `managedUserId`, `externalId`, `contentVersion` and `savedAt`, and is sent for the first save of a composition in each five minutes (read the composition for its current state); `widget.published` carries `widgetId`, `name`, `managedUserId`, `externalId`, `version` and `publishedAt`; `upload.created` carries `uploadId`, `name`, `mimeType`, `sizeBytes`, `address`, `managedUserId`, `externalId`, `purpose` and `createdAt`; `entry.created` carries `compositionId`, `table`, `entryId`, `createdAt` and `context` (the host attribution of the embedding page, or null), and none of the values the visitor entered: read those with the entries routes. Ignore an event type you do not know: more may be added. `sendPartnerNotificationTestEvent` sends a sample of every one of them. |  |
+| **data** | **Hash<String, Object>** | The facts of the event, named in camelCase. An invoice event carries `invoiceNumber`, `subtotal`, `taxAmount`, `total`, `currency`, `dueDate`, `hostedInvoiceUrl` (the page where it is paid) and `purpose` (`contract`, or `extra_credits` for credits you bought on top of the contract: an unpaid invoice for extra credits never stops the account, the credits are just not added until it is paid); a payment adds `paidAt`, a failed payment `reason`, a reminder `daysUntilDue` or `daysOverdue`. A credits event carries `band` (`low` or `empty`), `balance` and `threshold`. `credits.managed_user_cap_reached` (one of your managed users used its monthly credits and a request was refused) goes to your webhook only when subscribed, once per managed user each month, and carries `managedUserId`, `externalId`, `monthlyCredits`, `creditsUsed`, `resetsAt` and `reachedAt`. A standing event carries `status`, `previousStatus` and `reason`; `partner.paused` with `status: payment_arrears` means that an overdue invoice stopped the account (nobody paused it, and `reason` names the invoice), and `partner.resumed` with `previousStatus: payment_arrears` means that its payment ended that. A storage event carries `reason` and `checkedAt`. Content events (`composition.created`, `composition.updated`, `widget.published`, `upload.created`, `entry.created`, `workflow.created`, `workflow.published`, `workflow.state_changed`, `workflow.deleted`) go to your webhook only when subscribed; they do not appear in the dashboard list. `composition.created` carries `compositionId`, `widgetId`, `name`, `managedUserId`, `externalId` and `createdAt`; `composition.updated` carries `compositionId`, `widgetId`, `name`, `managedUserId`, `externalId`, `contentVersion` and `savedAt`, and is sent for the first save of a composition in each five minutes (read the composition for its current state); `widget.published` carries `widgetId`, `name`, `managedUserId`, `externalId`, `version` and `publishedAt`; `upload.created` carries `uploadId`, `name`, `mimeType`, `sizeBytes`, `address`, `managedUserId`, `externalId`, `purpose` and `createdAt`; `entry.created` carries `compositionId`, `table`, `entryId`, `createdAt` and `context` (the host attribution of the embedding page, or null), and none of the values the visitor entered: read those with the entries routes. The four workflow events are about the workflows your managed users make (only a workflow made for a managed user is told; one your own people made is not). `workflow.created` carries `workflowId`, `name`, `managedUserId`, `externalId`, `createdAt` and `presetKey` (the key you gave the starting point the workflow was started from with `setPartnerWorkflowPreset`, or null when it was drawn new or copied), and is sent for a copy of a workflow and for a start from a starting point too; `workflow.published` carries `workflowId`, `name`, `managedUserId`, `externalId`, `versionId`, `versionNumber` (1 for the first publication) and `publishedAt`; `workflow.state_changed` carries `workflowId`, `name`, `managedUserId`, `externalId`, `action` (`pause`, `resume`, `archive` or `unarchive`), `previousStatus` and `status` (each `draft`, `live`, `paused` or `archived`) and `changedAt`; `workflow.deleted` carries `workflowId`, `name`, `managedUserId`, `externalId`, `previousStatus` (the state it was in when it was deleted: `draft`, `live`, `paused` or `archived`) and `deletedAt`, and means that the workflow with its versions and counts is gone (the compositions it chained are not touched). Read the workflow for what it holds now (a deleted one is not found). Ignore an event type you do not know: more may be added. `sendPartnerNotificationTestEvent` sends a sample of every one of them. |  |
 | **created_at** | **Time** |  |  |
 
 ## Example

data/docs/PartnersApi.md

@@ -4,6 +4,7 @@ All URIs are relative to *https://api.widgetic.com/v1*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
+| [**confirm_partner_adapter_connection_0**](PartnersApi.md#confirm_partner_adapter_connection_0) | **POST** /partners/{partnerId}/adapter-connections/{adapterId}/{credentialKey}/confirm | Confirm a partner's adapter address with the code that was emailed to it |
 | [**create_partner_extra_credits_invoice_0**](PartnersApi.md#create_partner_extra_credits_invoice_0) | **POST** /partners/{partnerId}/credits/extra-invoice | Buy extra credits for a partner |
 | [**get_my_partners_0**](PartnersApi.md#get_my_partners_0) | **GET** /partners/mine | Find the partner you administer |
 | [**get_partner_adapter_connections_0**](PartnersApi.md#get_partner_adapter_connections_0) | **GET** /partners/{partnerId}/adapter-connections | See which adapter keys a partner has connected |
@@ -24,10 +25,12 @@ All URIs are relative to *https://api.widgetic.com/v1*
 | [**list_partner_notification_deliveries_0**](PartnersApi.md#list_partner_notification_deliveries_0) | **GET** /partners/{partnerId}/notifications/deliveries | How your notifications reached you |
 | [**list_partner_notifications_0**](PartnersApi.md#list_partner_notifications_0) | **GET** /partners/{partnerId}/notifications | What your partner account was told |
 | [**list_partner_presets_0**](PartnersApi.md#list_partner_presets_0) | **GET** /partners/{partnerId}/presets | List the widgets a partner offers as presets |
+| [**list_partner_workflow_presets_0**](PartnersApi.md#list_partner_workflow_presets_0) | **GET** /partners/{partnerId}/workflow-presets | List the workflows a partner offers as places to start |
 | [**remove_partner_adapter_connection_0**](PartnersApi.md#remove_partner_adapter_connection_0) | **DELETE** /partners/{partnerId}/adapter-connections/{adapterId}/{credentialKey} | Remove an adapter key from a partner |
 | [**remove_partner_data_database_0**](PartnersApi.md#remove_partner_data_database_0) | **DELETE** /partners/{partnerId}/data-database | Stop keeping the data of a partner's compositions in its own database |
 | [**remove_partner_preset_0**](PartnersApi.md#remove_partner_preset_0) | **DELETE** /partners/{partnerId}/presets/{key} | Take a widget off the partner's presets |
 | [**remove_partner_storage_destination_0**](PartnersApi.md#remove_partner_storage_destination_0) | **DELETE** /partners/{partnerId}/storage | Stop storing a partner's uploaded files in its own bucket |
+| [**remove_partner_workflow_preset_0**](PartnersApi.md#remove_partner_workflow_preset_0) | **DELETE** /partners/{partnerId}/workflow-presets/{key} | Stop offering a workflow as a place to start |
 | [**replay_partner_notification_delivery_0**](PartnersApi.md#replay_partner_notification_delivery_0) | **POST** /partners/{partnerId}/notifications/deliveries/{deliveryId}/replay | Send a webhook delivery again |
 | [**rotate_partner_entry_context_secret_0**](PartnersApi.md#rotate_partner_entry_context_secret_0) | **POST** /partners/{partnerId}/entry-context-signing/secret | Make a secret to sign the context of your embeds |
 | [**rotate_partner_webhook_secret_0**](PartnersApi.md#rotate_partner_webhook_secret_0) | **POST** /partners/{partnerId}/notifications/webhook-secret | Make a new secret for your webhook |
@@ -37,19 +40,95 @@ All URIs are relative to *https://api.widgetic.com/v1*
 | [**set_partner_design_defaults_0**](PartnersApi.md#set_partner_design_defaults_0) | **PUT** /partners/{partnerId}/design-defaults | Set or clear partner-wide design defaults |
 | [**set_partner_preset_0**](PartnersApi.md#set_partner_preset_0) | **PUT** /partners/{partnerId}/presets/{key} | Make a widget a preset, or replace a preset |
 | [**set_partner_storage_destination_0**](PartnersApi.md#set_partner_storage_destination_0) | **PUT** /partners/{partnerId}/storage | Set where a partner's uploaded files are stored |
+| [**set_partner_workflow_preset_0**](PartnersApi.md#set_partner_workflow_preset_0) | **PUT** /partners/{partnerId}/workflow-presets/{key} | Offer a workflow as a place to start, or replace what a key offers |
 | [**update_partner_entry_context_signing_0**](PartnersApi.md#update_partner_entry_context_signing_0) | **PUT** /partners/{partnerId}/entry-context-signing | Require a signed context, or stop requiring it |
 | [**update_partner_notification_settings_0**](PartnersApi.md#update_partner_notification_settings_0) | **PUT** /partners/{partnerId}/notifications/settings | Choose where your notifications go |
 | [**verify_partner_data_database_0**](PartnersApi.md#verify_partner_data_database_0) | **POST** /partners/{partnerId}/data-database/verify | Check that a partner's own database still works |
 | [**verify_partner_storage_destination_0**](PartnersApi.md#verify_partner_storage_destination_0) | **POST** /partners/{partnerId}/storage/verify | Check that a partner's storage destination still works |
 
 
+## confirm_partner_adapter_connection_0
+
+> <SetUserAdapterConnection200Response> confirm_partner_adapter_connection_0(partner_id, adapter_id, credential_key, confirm_adapter_connection_request)
+
+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. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'api-sdk-rb'
+# setup authorization
+ApiSdkRb.configure do |config|
+  # Configure Bearer authorization (JWT): apiKeyAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = ApiSdkRb::PartnersApi.new
+partner_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | The partner that keeps the address
+adapter_id = 'adapter_id_example' # String | The adapter the address is for
+credential_key = 'credential_key_example' # String | The credential's name within the adapter
+confirm_adapter_connection_request = ApiSdkRb::ConfirmAdapterConnectionRequest.new({code: '123456'}) # ConfirmAdapterConnectionRequest | 
+
+begin
+  # Confirm a partner's adapter address with the code that was emailed to it
+  result = api_instance.confirm_partner_adapter_connection_0(partner_id, adapter_id, credential_key, confirm_adapter_connection_request)
+  p result
+rescue ApiSdkRb::ApiError => e
+  puts "Error when calling PartnersApi->confirm_partner_adapter_connection_0: #{e}"
+end
+```
+
+#### Using the confirm_partner_adapter_connection_0_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SetUserAdapterConnection200Response>, Integer, Hash)> confirm_partner_adapter_connection_0_with_http_info(partner_id, adapter_id, credential_key, confirm_adapter_connection_request)
+
+```ruby
+begin
+  # Confirm a partner's adapter address with the code that was emailed to it
+  data, status_code, headers = api_instance.confirm_partner_adapter_connection_0_with_http_info(partner_id, adapter_id, credential_key, confirm_adapter_connection_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SetUserAdapterConnection200Response>
+rescue ApiSdkRb::ApiError => e
+  puts "Error when calling PartnersApi->confirm_partner_adapter_connection_0_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **partner_id** | **String** | The partner that keeps the address |  |
+| **adapter_id** | **String** | The adapter the address is for |  |
+| **credential_key** | **String** | The credential&#39;s name within the adapter |  |
+| **confirm_adapter_connection_request** | [**ConfirmAdapterConnectionRequest**](ConfirmAdapterConnectionRequest.md) |  |  |
+
+### Return type
+
+[**SetUserAdapterConnection200Response**](SetUserAdapterConnection200Response.md)
+
+### Authorization
+
+[apiKeyAuth](../README.md#apiKeyAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## create_partner_extra_credits_invoice_0
 
 > <PartnerExtraCreditsInvoiceResponse> create_partner_extra_credits_invoice_0(partner_id, idempotency_key, request_extra_credits)
 
 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`. 
 
 ### Examples
 
@@ -1488,6 +1567,75 @@ end
 - **Accept**: application/json
 
 
+## list_partner_workflow_presets_0
+
+> <ListPartnerWorkflowPresets200Response> list_partner_workflow_presets_0(partner_id)
+
+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. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'api-sdk-rb'
+# setup authorization
+ApiSdkRb.configure do |config|
+  # Configure Bearer authorization (JWT): apiKeyAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = ApiSdkRb::PartnersApi.new
+partner_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | The partner whose starting points to list
+
+begin
+  # List the workflows a partner offers as places to start
+  result = api_instance.list_partner_workflow_presets_0(partner_id)
+  p result
+rescue ApiSdkRb::ApiError => e
+  puts "Error when calling PartnersApi->list_partner_workflow_presets_0: #{e}"
+end
+```
+
+#### Using the list_partner_workflow_presets_0_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ListPartnerWorkflowPresets200Response>, Integer, Hash)> list_partner_workflow_presets_0_with_http_info(partner_id)
+
+```ruby
+begin
+  # List the workflows a partner offers as places to start
+  data, status_code, headers = api_instance.list_partner_workflow_presets_0_with_http_info(partner_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ListPartnerWorkflowPresets200Response>
+rescue ApiSdkRb::ApiError => e
+  puts "Error when calling PartnersApi->list_partner_workflow_presets_0_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **partner_id** | **String** | The partner whose starting points to list |  |
+
+### Return type
+
+[**ListPartnerWorkflowPresets200Response**](ListPartnerWorkflowPresets200Response.md)
+
+### Authorization
+
+[apiKeyAuth](../README.md#apiKeyAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## remove_partner_adapter_connection_0
 
 > <RemoveUserAdapterConnection200Response> remove_partner_adapter_connection_0(partner_id, adapter_id, credential_key)
@@ -1770,6 +1918,77 @@ end
 - **Accept**: application/json
 
 
+## remove_partner_workflow_preset_0
+
+> <RemovePartnerWorkflowPreset200Response> remove_partner_workflow_preset_0(partner_id, key)
+
+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`. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'api-sdk-rb'
+# setup authorization
+ApiSdkRb.configure do |config|
+  # Configure Bearer authorization (JWT): apiKeyAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = ApiSdkRb::PartnersApi.new
+partner_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | The partner whose starting point to remove
+key = 'key_example' # String | The key of the starting point to remove
+
+begin
+  # Stop offering a workflow as a place to start
+  result = api_instance.remove_partner_workflow_preset_0(partner_id, key)
+  p result
+rescue ApiSdkRb::ApiError => e
+  puts "Error when calling PartnersApi->remove_partner_workflow_preset_0: #{e}"
+end
+```
+
+#### Using the remove_partner_workflow_preset_0_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<RemovePartnerWorkflowPreset200Response>, Integer, Hash)> remove_partner_workflow_preset_0_with_http_info(partner_id, key)
+
+```ruby
+begin
+  # Stop offering a workflow as a place to start
+  data, status_code, headers = api_instance.remove_partner_workflow_preset_0_with_http_info(partner_id, key)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <RemovePartnerWorkflowPreset200Response>
+rescue ApiSdkRb::ApiError => e
+  puts "Error when calling PartnersApi->remove_partner_workflow_preset_0_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **partner_id** | **String** | The partner whose starting point to remove |  |
+| **key** | **String** | The key of the starting point to remove |  |
+
+### Return type
+
+[**RemovePartnerWorkflowPreset200Response**](RemovePartnerWorkflowPreset200Response.md)
+
+### Authorization
+
+[apiKeyAuth](../README.md#apiKeyAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## replay_partner_notification_delivery_0
 
 > <PartnerNotificationDeliveryResponse> replay_partner_notification_delivery_0(partner_id, delivery_id, idempotency_key)
@@ -2064,7 +2283,7 @@ 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. 
 
 ### Examples
 
@@ -2419,6 +2638,79 @@ end
 - **Accept**: application/json
 
 
+## set_partner_workflow_preset_0
+
+> <SetPartnerWorkflowPreset200Response> set_partner_workflow_preset_0(partner_id, key, offer_workflow_preset_request)
+
+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. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'api-sdk-rb'
+# setup authorization
+ApiSdkRb.configure do |config|
+  # Configure Bearer authorization (JWT): apiKeyAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = ApiSdkRb::PartnersApi.new
+partner_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | The partner whose starting point to set
+key = 'key_example' # String | The name your code and the picker use for the starting point
+offer_workflow_preset_request = ApiSdkRb::OfferWorkflowPresetRequest.new({workflow_id: 'workflow_id_example'}) # OfferWorkflowPresetRequest | 
+
+begin
+  # Offer a workflow as a place to start, or replace what a key offers
+  result = api_instance.set_partner_workflow_preset_0(partner_id, key, offer_workflow_preset_request)
+  p result
+rescue ApiSdkRb::ApiError => e
+  puts "Error when calling PartnersApi->set_partner_workflow_preset_0: #{e}"
+end
+```
+
+#### Using the set_partner_workflow_preset_0_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SetPartnerWorkflowPreset200Response>, Integer, Hash)> set_partner_workflow_preset_0_with_http_info(partner_id, key, offer_workflow_preset_request)
+
+```ruby
+begin
+  # Offer a workflow as a place to start, or replace what a key offers
+  data, status_code, headers = api_instance.set_partner_workflow_preset_0_with_http_info(partner_id, key, offer_workflow_preset_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SetPartnerWorkflowPreset200Response>
+rescue ApiSdkRb::ApiError => e
+  puts "Error when calling PartnersApi->set_partner_workflow_preset_0_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **partner_id** | **String** | The partner whose starting point to set |  |
+| **key** | **String** | The name your code and the picker use for the starting point |  |
+| **offer_workflow_preset_request** | [**OfferWorkflowPresetRequest**](OfferWorkflowPresetRequest.md) |  |  |
+
+### Return type
+
+[**SetPartnerWorkflowPreset200Response**](SetPartnerWorkflowPreset200Response.md)
+
+### Authorization
+
+[apiKeyAuth](../README.md#apiKeyAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## update_partner_entry_context_signing_0
 
 > <PartnerEntryContextSigningResponse> update_partner_entry_context_signing_0(partner_id, update_partner_entry_context_signing_request, opts)

data/docs/PatchBrandKitAssetRequest.md

@@ -0,0 +1,24 @@
+# ApiSdkRb::PatchBrandKitAssetRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **name** | **String** | Icon rename | [optional] |
+| **family** | **String** | Font family relabel | [optional] |
+| **weight** | **Integer** |  | [optional] |
+| **style** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'api-sdk-rb'
+
+instance = ApiSdkRb::PatchBrandKitAssetRequest.new(
+  name: null,
+  family: null,
+  weight: null,
+  style: null
+)
+```
+

data/docs/PatchBrandKitRequest.md

@@ -0,0 +1,28 @@
+# ApiSdkRb::PatchBrandKitRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **colors** | [**Array<BrandColor>**](BrandColor.md) | The whole list of colors (it replaces the saved list). | [optional] |
+| **fonts** | [**PatchBrandKitRequestFonts**](PatchBrandKitRequestFonts.md) |  | [optional] |
+| **spacing** | [**PatchBrandKitRequestSpacing**](PatchBrandKitRequestSpacing.md) |  | [optional] |
+| **corner_radius** | **Integer** | One corner radius in pixels for the whole kit; the small, medium and large radii are made from it. 0 gives square corners. A radius step sent in `spacing` wins over the one made from this value. | [optional] |
+| **instructions** | **String** | The kit owner's style notes (see `tokens.instructions`). An empty string removes them. | [optional] |
+| **expected_version** | **Integer** | Refuse the change with a 409 when the kit was saved again since this version was read. | [optional] |
+
+## Example
+
+```ruby
+require 'api-sdk-rb'
+
+instance = ApiSdkRb::PatchBrandKitRequest.new(
+  colors: null,
+  fonts: null,
+  spacing: null,
+  corner_radius: null,
+  instructions: null,
+  expected_version: null
+)
+```
+

data/docs/PatchBrandKitRequestFonts.md

@@ -0,0 +1,24 @@
+# ApiSdkRb::PatchBrandKitRequestFonts
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **title** | [**BrandFont**](BrandFont.md) |  | [optional] |
+| **subtitle** | [**BrandFont**](BrandFont.md) |  | [optional] |
+| **body** | [**BrandFont**](BrandFont.md) |  | [optional] |
+| **caption** | [**BrandFont**](BrandFont.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'api-sdk-rb'
+
+instance = ApiSdkRb::PatchBrandKitRequestFonts.new(
+  title: null,
+  subtitle: null,
+  body: null,
+  caption: null
+)
+```
+

data/docs/PatchBrandKitRequestSpacing.md

@@ -0,0 +1,32 @@
+# ApiSdkRb::PatchBrandKitRequestSpacing
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **xs** | **Integer** |  | [optional] |
+| **s** | **Integer** |  | [optional] |
+| **m** | **Integer** |  | [optional] |
+| **l** | **Integer** |  | [optional] |
+| **xl** | **Integer** |  | [optional] |
+| **radius_s** | **Integer** |  | [optional] |
+| **radius_m** | **Integer** |  | [optional] |
+| **radius_l** | **Integer** |  | [optional] |
+
+## Example
+
+```ruby
+require 'api-sdk-rb'
+
+instance = ApiSdkRb::PatchBrandKitRequestSpacing.new(
+  xs: null,
+  s: null,
+  m: null,
+  l: null,
+  xl: null,
+  radius_s: null,
+  radius_m: null,
+  radius_l: null
+)
+```
+

data/docs/PostBrandKitIconRequest.md

@@ -0,0 +1,20 @@
+# ApiSdkRb::PostBrandKitIconRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **name** | **String** |  |  |
+| **svg** | **String** |  |  |
+
+## Example
+
+```ruby
+require 'api-sdk-rb'
+
+instance = ApiSdkRb::PostBrandKitIconRequest.new(
+  name: null,
+  svg: null
+)
+```
+