ultracart_api 4.1.200 → 4.1.201

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c31b64268acb1092ec9ac34c018320da17be12077a1811a22dcfb40f8b2951a
-  data.tar.gz: c0d2caf53984e3f593ea2ee5b09c9e2eec11dca7a501323fc16405720c4b8fb7
+  metadata.gz: 8eb0f77a073bc3b2d2b66f254190227539e919cfcae97ee88d4844a410922d84
+  data.tar.gz: 936959c530a9c85860e0c5e45d2a7ab24e85a101580f77dbd957ec0806923ccf
 SHA512:
-  metadata.gz: 90e7180843483a64e17e273243889cb86e5450737eaa9a1e85cdca19fa0abaeb316bb018ab759619122a5b08fe16faf8b4284bcac3bd2ac3bb4293221fed5ccc
-  data.tar.gz: ee10c6be44c3e4d95fe1b834ce9d8de9eb729873f7a4ce5cf639ffc64ebf40271d2bdef860eb9b0c90ef0b31cd204c6ff9e789fcee684441610ba0cccdf1dae6
+  metadata.gz: 492a6776f33223e9f198c4c8185a67b60f67ce0b13d3557b0d4d82b3c8aad2b36994799103b5026676701fbde6703284558280e42aa1ea47cf745fbf0788e62d
+  data.tar.gz: 5bcb498157c133ff90e73a6df2cbfe3d3ee2cd508a374df95d2322d21266477df836b3d6957a12c4b13993f7aad4cb119e0a49295488b4adaef669be521bb45b

data/README.md

@@ -7,7 +7,7 @@ Note: Every method has a sample for every language.  See https://github.com/Ultr
 This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: 2.0.0
-- Package version: 4.1.200
+- Package version: 4.1.201
 - Build package: org.openapitools.codegen.languages.RubyClientCodegen
 - For more information, please visit [http://www.ultracart.com/api/](http://www.ultracart.com/api/)
 
@@ -16,7 +16,7 @@ This SDK is automatically generated by the [OpenAPI Generator](https://openapi-g
 gemfile:
 
 ```shell
-gem 'ultracart_api', '4.1.200'
+gem 'ultracart_api', '4.1.201'
 ```
 
 install:
@@ -521,6 +521,8 @@ Class | Method | HTTP request | Description
 *UltracartClient::SfvbApi* | [**get_sfvb_container**](docs/SfvbApi.md#get_sfvb_container) | **GET** /sfvb/storefronts/{storefront_oid}/containers/{owner_type}/{owner_object_id} | Read a container stored outside the file system
 *UltracartClient::SfvbApi* | [**get_sfvb_container_version**](docs/SfvbApi.md#get_sfvb_container_version) | **GET** /sfvb/storefronts/{storefront_oid}/container_versions/{container_history_oid} | Read the CJSON stored in one container history entry
 *UltracartClient::SfvbApi* | [**get_sfvb_element**](docs/SfvbApi.md#get_sfvb_element) | **GET** /sfvb/elements/{element_type} | Configuration schema and field card for one element type
+*UltracartClient::SfvbApi* | [**get_sfvb_events**](docs/SfvbApi.md#get_sfvb_events) | **GET** /sfvb/events | Replay events
+*UltracartClient::SfvbApi* | [**get_sfvb_events_authorization**](docs/SfvbApi.md#get_sfvb_events_authorization) | **PUT** /sfvb/events/auth | Open the event stream
 *UltracartClient::SfvbApi* | [**get_sfvb_experiment**](docs/SfvbApi.md#get_sfvb_experiment) | **GET** /sfvb/storefronts/{storefront_oid}/experiments/{experiment_oid} | Read one experiment and its statistics
 *UltracartClient::SfvbApi* | [**get_sfvb_experiment_objectives**](docs/SfvbApi.md#get_sfvb_experiment_objectives) | **GET** /sfvb/storefronts/{storefront_oid}/experiments/objectives | List the objectives an experiment can optimize
 *UltracartClient::SfvbApi* | [**get_sfvb_file_content**](docs/SfvbApi.md#get_sfvb_file_content) | **GET** /sfvb/storefronts/{storefront_oid}/files/content | Read a storefront file
@@ -1888,6 +1890,10 @@ Class | Method | HTTP request | Description
  - [UltracartClient::SfvbElementSchemaResponse](docs/SfvbElementSchemaResponse.md)
  - [UltracartClient::SfvbElementsResponse](docs/SfvbElementsResponse.md)
  - [UltracartClient::SfvbErrorDetail](docs/SfvbErrorDetail.md)
+ - [UltracartClient::SfvbEvent](docs/SfvbEvent.md)
+ - [UltracartClient::SfvbEventsAuthRequest](docs/SfvbEventsAuthRequest.md)
+ - [UltracartClient::SfvbEventsAuthResponse](docs/SfvbEventsAuthResponse.md)
+ - [UltracartClient::SfvbEventsResponse](docs/SfvbEventsResponse.md)
  - [UltracartClient::SfvbExperiment](docs/SfvbExperiment.md)
  - [UltracartClient::SfvbExperimentEndRequest](docs/SfvbExperimentEndRequest.md)
  - [UltracartClient::SfvbExperimentObjective](docs/SfvbExperimentObjective.md)
@@ -2244,6 +2250,7 @@ Not every change is committed to every SDK.
 
 | Version | Date | Comments |
 | --: | :-: | --- |
+| 4.1.201 | 10/12/2026 | sfvb internal testing |
 | 4.1.200 | 10/09/2026 | sfvb internal testing |
 | 4.1.199 | 10/08/2026 | sfvb internal testing |
 | 4.1.198 | 10/08/2026 | sfvb internal testing |

data/docs/SfvbApi.md

@@ -49,6 +49,8 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
 | [**get_sfvb_container**](SfvbApi.md#get_sfvb_container) | **GET** /sfvb/storefronts/{storefront_oid}/containers/{owner_type}/{owner_object_id} | Read a container stored outside the file system |
 | [**get_sfvb_container_version**](SfvbApi.md#get_sfvb_container_version) | **GET** /sfvb/storefronts/{storefront_oid}/container_versions/{container_history_oid} | Read the CJSON stored in one container history entry |
 | [**get_sfvb_element**](SfvbApi.md#get_sfvb_element) | **GET** /sfvb/elements/{element_type} | Configuration schema and field card for one element type |
+| [**get_sfvb_events**](SfvbApi.md#get_sfvb_events) | **GET** /sfvb/events | Replay events |
+| [**get_sfvb_events_authorization**](SfvbApi.md#get_sfvb_events_authorization) | **PUT** /sfvb/events/auth | Open the event stream |
 | [**get_sfvb_experiment**](SfvbApi.md#get_sfvb_experiment) | **GET** /sfvb/storefronts/{storefront_oid}/experiments/{experiment_oid} | Read one experiment and its statistics |
 | [**get_sfvb_experiment_objectives**](SfvbApi.md#get_sfvb_experiment_objectives) | **GET** /sfvb/storefronts/{storefront_oid}/experiments/objectives | List the objectives an experiment can optimize |
 | [**get_sfvb_file_content**](SfvbApi.md#get_sfvb_file_content) | **GET** /sfvb/storefronts/{storefront_oid}/files/content | Read a storefront file |
@@ -2141,7 +2143,7 @@ end
 
 End an experiment
 
-Ends a running experiment.  With winner_variation_number the winner gets every visitor, including visitors already assigned to another variation, and a page experiment's winning content is promoted into the page by the completion job on its next run, which also emails the merchant.  Without a winner a page experiment's id is cleared from its page body so the page shows variation 0, and a url experiment sends everyone to variation 0.  Always needs sfvb_publish, and the approval of the person who signed in the CLI - an approved experiment.end request for this experiment and winner, which always needs a fresh authenticator code (see POST /sfvb/approvals). 
+Ends a running experiment.  With winner_variation_number the winner gets every visitor, including visitors already assigned to another variation, and a page experiment's winning content is promoted into the page by the completion job on its next run, which also emails the merchant.  Without a winner a page experiment's id is cleared from its page body so the page shows variation 0, and a url experiment sends everyone to variation 0.  Always needs sfvb_publish, and the approval of the person who signed in the CLI - an approved experiment.end request for this experiment and winner.  An end with a winner always needs a fresh authenticator code; an end without a winner can be covered by the person's approval session (see POST /sfvb/approvals). 
 
 
 ### Examples
@@ -2620,6 +2622,114 @@ end
 - **Accept**: application/json
 
 
+## get_sfvb_events
+
+> <SfvbEventsResponse> get_sfvb_events(opts)
+
+Replay events
+
+The signed-in person's events after the cursor, oldest first.  Events are kept 72 hours; an older cursor returns resync_required, and then the caller re-lists what it was waiting on.  Events about one sign-in's requests, such as approvals, are only returned to that sign-in.  limit is 1 to 500, default 100. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the get_sfvb_events_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbEventsResponse>, Integer, Hash)> get_sfvb_events_with_http_info(opts)
+
+```ruby
+begin
+  # Replay events
+  data, status_code, headers = api_instance.get_sfvb_events_with_http_info(opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbEventsResponse>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->get_sfvb_events_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **after** | **String** | Return events after this event_id.  Leave it out for every event kept. | [optional] |
+| **storefront_oid** | **Integer** | Only events about this storefront, plus merchant-level ones. | [optional] |
+| **limit** | **Integer** | At most this many events, 1 to 500. | [optional] |
+
+### Return type
+
+[**SfvbEventsResponse**](SfvbEventsResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_sfvb_events_authorization
+
+> <SfvbEventsAuthResponse> get_sfvb_events_authorization(opts)
+
+Open the event stream
+
+Returns a websocket URL and a single-use token, valid for 5 minutes, for the signed-in person's event stream.  Events are thin hints, type and ids only, and the stream is at most once.  Re-read the object before acting, and after every reconnect replay from the last event_id with GET events.  Send ping messages to keep the connection open, and reconnect with a new token before two hours.  Requires a token that resolves to a user, so use the device authorization flow. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the get_sfvb_events_authorization_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbEventsAuthResponse>, Integer, Hash)> get_sfvb_events_authorization_with_http_info(opts)
+
+```ruby
+begin
+  # Open the event stream
+  data, status_code, headers = api_instance.get_sfvb_events_authorization_with_http_info(opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbEventsAuthResponse>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->get_sfvb_events_authorization_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **events_auth_request** | [**SfvbEventsAuthRequest**](SfvbEventsAuthRequest.md) | Optional storefront filter | [optional] |
+
+### Return type
+
+[**SfvbEventsAuthResponse**](SfvbEventsAuthResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json; charset=UTF-8
+- **Accept**: application/json
+
+
 ## get_sfvb_experiment
 
 > <SfvbExperiment> get_sfvb_experiment(storefront_oid, experiment_oid, opts)
@@ -3602,7 +3712,7 @@ end
 
 List the paths that answered 404
 
-The paths shoppers asked for that answered 404, most hits first or by last_seen.  Paths only, never query strings.  Bots are left out unless include_bots.  Token-like path segments show as {token} unless include_tokens.  limit is 1 to 100, default 50. 
+The paths shoppers asked for that answered 404, most hits first or by last_seen.  Paths only, never query strings.  Bots are left out unless include_bots.  Token-like path segments show as {token} unless include_tokens.  A path stays listed after a redirect rule catches it, with redirected_to set.  redirected=false lists only paths no rule catches yet, and redirected=true only those one does.  limit is 1 to 100, default 50. 
 
 
 ### Examples
@@ -3640,6 +3750,7 @@ end
 | **include_tokens** | **Boolean** |  | [optional] |
 | **q** | **String** |  | [optional] |
 | **limit** | **Integer** |  | [optional] |
+| **redirected** | **Boolean** |  | [optional] |
 
 ### Return type
 
@@ -6564,7 +6675,7 @@ end
 
 Change one built-in message
 
-Sets one message in any number of languages.  ENG replaces the English, which drops its machine translations so they regenerate.  Any other language becomes a hand translation.  Languages not named are left alone; empty text is refused.  Shoppers see it at once.  Always needs sfvb_publish. 
+Sets one message in any number of languages.  ENG replaces the English, which drops its machine translations so they regenerate.  Any other language becomes a hand translation.  Languages not named are left alone.  Empty text removes that language's translation so machine translation fills it again (not allowed for ENG); it is the undo for an imported message, which can't be reset.  Shoppers see it at once.  Always needs sfvb_publish. 
 
 
 ### Examples

data/docs/SfvbContainerVersion.md

@@ -8,7 +8,7 @@
 | **comment** | **String** | Comment recorded with the write that replaced this version. | [optional] |
 | **container_history_oid** | **Integer** | History record oid.  Pass to the revert operation on the owning container.  Absent on the entry marked current, which holds the value stored right now, has no history row of its own, and so cannot be fetched or reverted to. | [optional] |
 | **container_name** | **String** | Container name, where the owner has more than one container. | [optional] |
-| **created_dts** | **String** | When this snapshot was taken. | [optional] |
+| **created_dts** | **String** | When this snapshot was taken, ISO 8601 UTC. | [optional] |
 | **current** | **Boolean** | True for the value currently stored. | [optional] |
 | **edited_by** | **String** | Login of whoever caused this snapshot. | [optional] |
 | **hash_sha256** | **String** | SHA-256 of this version's CJSON. | [optional] |

data/docs/SfvbEvent.md

@@ -0,0 +1,28 @@
+# UltracartClient::SfvbEvent
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **event_dts** | **String** | When it happened, ISO 8601. | [optional] |
+| **event_id** | **String** | Time-ordered id.  Pass the last one seen as after to replay what came since. | [optional] |
+| **object_id** | **String** | The id of what changed, such as the approval_id. | [optional] |
+| **object_type** | **String** | What changed, such as approval. | [optional] |
+| **storefront_oid** | **Integer** | The storefront it concerns.  Empty for merchant-level objects. | [optional] |
+| **type** | **String** | approval.decided (approved, denied, cancelled or refused by the script review) or approval.ready (the review finished and the person can decide). | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbEvent.new(
+  event_dts: null,
+  event_id: null,
+  object_id: null,
+  object_type: null,
+  storefront_oid: null,
+  type: null
+)
+```
+

data/docs/SfvbEventsAuthRequest.md

@@ -0,0 +1,18 @@
+# UltracartClient::SfvbEventsAuthRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oids** | **Array<Integer>** | Only events about these storefronts, plus merchant-level ones.  Leave it out for every storefront. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbEventsAuthRequest.new(
+  storefront_oids: null
+)
+```
+

data/docs/SfvbEventsAuthResponse.md

@@ -0,0 +1,22 @@
+# UltracartClient::SfvbEventsAuthResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **expires_dts** | **String** | When the token stops working, ISO 8601.  Ask for a new one to reconnect. | [optional] |
+| **jwt** | **String** | The connect token on its own. | [optional] |
+| **websocket_url** | **String** | The websocket URL to open, with the token on it.  Open it before expires_dts; each token opens one connection. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbEventsAuthResponse.new(
+  expires_dts: null,
+  jwt: null,
+  websocket_url: null
+)
+```
+

data/docs/SfvbEventsResponse.md

@@ -0,0 +1,22 @@
+# UltracartClient::SfvbEventsResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **events** | [**Array<SfvbEvent>**](SfvbEvent.md) | Oldest first. | [optional] |
+| **more** | **Boolean** | True when more events follow.  Ask again with after set to the last event_id. | [optional] |
+| **resync_required** | **Boolean** | True when the cursor is older than the 72 hours of events kept.  Re-list what you were waiting on instead of replaying. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbEventsResponse.new(
+  events: null,
+  more: null,
+  resync_required: null
+)
+```
+

data/docs/SfvbI18nMessageValue.md

@@ -5,7 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **language** | **String** | The language code.  ENG changes the English source, which clears its machine translations. | [optional] |
-| **text** | **String** | The new text.  Empty text is refused; reset the message instead. | [optional] |
+| **text** | **String** | The new text.  Empty text removes this language's translation, so it goes back to machine translation.  Empty English text is refused. | [optional] |
 
 ## Example
 

data/docs/SfvbThemeJobResponse.md

@@ -7,13 +7,13 @@
 | **complete** | **Boolean** | True once the job has stopped, whether it succeeded or failed. | [optional] |
 | **description** | **String** | Human readable description of the job. | [optional] |
 | **error_message** | **String** | What to do next when the job did not produce a theme.  The internal cause is not returned; it is recorded against the job id in the server log. | [optional] |
-| **finished_dts** | **String** | When the job stopped.  Null until it does. | [optional] |
+| **finished_dts** | **String** | When the job stopped, ISO 8601 UTC.  Null until it does. | [optional] |
 | **job_id** | **Integer** | Job handle.  Poll getSfvbThemeJob with this. | [optional] |
 | **progress** | **Integer** | Percent complete, 0-100. | [optional] |
 | **progress_description** | **String** | What the job is doing right now, for example 'Duplicating locale text'. | [optional] |
-| **started_dts** | **String** | When the job started running.  Null until it does. | [optional] |
+| **started_dts** | **String** | When the job started running, ISO 8601 UTC.  Null until it does. | [optional] |
 | **status** | **String** | Raw job status. | [optional] |
-| **submitted_dts** | **String** | When the job was queued. | [optional] |
+| **submitted_dts** | **String** | When the job was queued, ISO 8601 UTC. | [optional] |
 | **success** | **Boolean** | True only when the job finished successfully.  Check complete first. | [optional] |
 | **target_path** | **String** | Path the new theme is being created at.  Returned when the job is started and on every poll, so you do not have to keep the response that started it.  The theme oid itself is NOT returned, so once the job completes you list themes and match on this path.  It is also what success is checked against - a finished job whose theme is not here reports success false rather than pretending. | [optional] |
 

data/lib/ultracart_api/api/sfvb_api.rb

@@ -2725,7 +2725,7 @@ module UltracartClient
     end
 
     # End an experiment
-    # Ends a running experiment.  With winner_variation_number the winner gets every visitor, including visitors already assigned to another variation, and a page experiment's winning content is promoted into the page by the completion job on its next run, which also emails the merchant.  Without a winner a page experiment's id is cleared from its page body so the page shows variation 0, and a url experiment sends everyone to variation 0.  Always needs sfvb_publish, and the approval of the person who signed in the CLI - an approved experiment.end request for this experiment and winner, which always needs a fresh authenticator code (see POST /sfvb/approvals). 
+    # Ends a running experiment.  With winner_variation_number the winner gets every visitor, including visitors already assigned to another variation, and a page experiment's winning content is promoted into the page by the completion job on its next run, which also emails the merchant.  Without a winner a page experiment's id is cleared from its page body so the page shows variation 0, and a url experiment sends everyone to variation 0.  Always needs sfvb_publish, and the approval of the person who signed in the CLI - an approved experiment.end request for this experiment and winner.  An end with a winner always needs a fresh authenticator code; an end without a winner can be covered by the person's approval session (see POST /sfvb/approvals). 
     # @param storefront_oid [Integer] 
     # @param experiment_oid [Integer] 
     # @param [Hash] opts the optional parameters
@@ -2738,7 +2738,7 @@ module UltracartClient
     end
 
     # End an experiment
-    # Ends a running experiment.  With winner_variation_number the winner gets every visitor, including visitors already assigned to another variation, and a page experiment's winning content is promoted into the page by the completion job on its next run, which also emails the merchant.  Without a winner a page experiment's id is cleared from its page body so the page shows variation 0, and a url experiment sends everyone to variation 0.  Always needs sfvb_publish, and the approval of the person who signed in the CLI - an approved experiment.end request for this experiment and winner, which always needs a fresh authenticator code (see POST /sfvb/approvals). 
+    # Ends a running experiment.  With winner_variation_number the winner gets every visitor, including visitors already assigned to another variation, and a page experiment's winning content is promoted into the page by the completion job on its next run, which also emails the merchant.  Without a winner a page experiment's id is cleared from its page body so the page shows variation 0, and a url experiment sends everyone to variation 0.  Always needs sfvb_publish, and the approval of the person who signed in the CLI - an approved experiment.end request for this experiment and winner.  An end with a winner always needs a fresh authenticator code; an end without a winner can be covered by the person's approval session (see POST /sfvb/approvals). 
     # @param storefront_oid [Integer] 
     # @param experiment_oid [Integer] 
     # @param [Hash] opts the optional parameters
@@ -3355,6 +3355,138 @@ module UltracartClient
       return data, status_code, headers
     end
 
+    # Replay events
+    # The signed-in person's events after the cursor, oldest first.  Events are kept 72 hours; an older cursor returns resync_required, and then the caller re-lists what it was waiting on.  Events about one sign-in's requests, such as approvals, are only returned to that sign-in.  limit is 1 to 500, default 100. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :after Return events after this event_id.  Leave it out for every event kept.
+    # @option opts [Integer] :storefront_oid Only events about this storefront, plus merchant-level ones.
+    # @option opts [Integer] :limit At most this many events, 1 to 500.
+    # @return [SfvbEventsResponse]
+    def get_sfvb_events(opts = {})
+      data, _status_code, _headers = get_sfvb_events_with_http_info(opts)
+      data
+    end
+
+    # Replay events
+    # The signed-in person's events after the cursor, oldest first.  Events are kept 72 hours; an older cursor returns resync_required, and then the caller re-lists what it was waiting on.  Events about one sign-in's requests, such as approvals, are only returned to that sign-in.  limit is 1 to 500, default 100. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :after Return events after this event_id.  Leave it out for every event kept.
+    # @option opts [Integer] :storefront_oid Only events about this storefront, plus merchant-level ones.
+    # @option opts [Integer] :limit At most this many events, 1 to 500.
+    # @return [Array<(SfvbEventsResponse, Integer, Hash)>] SfvbEventsResponse data, response status code and response headers
+    def get_sfvb_events_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SfvbApi.get_sfvb_events ...'
+      end
+      # resource path
+      local_var_path = '/sfvb/events'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'after'] = opts[:'after'] if !opts[:'after'].nil?
+      query_params[:'storefront_oid'] = opts[:'storefront_oid'] if !opts[:'storefront_oid'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      header_params['X-UltraCart-Api-Version'] = @api_client.select_header_api_version()
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SfvbEventsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ultraCartOauth', 'ultraCartSimpleApiKey']
+
+      new_options = opts.merge(
+        :operation => :"SfvbApi.get_sfvb_events",
+        :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: SfvbApi#get_sfvb_events\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Open the event stream
+    # Returns a websocket URL and a single-use token, valid for 5 minutes, for the signed-in person's event stream.  Events are thin hints, type and ids only, and the stream is at most once.  Re-read the object before acting, and after every reconnect replay from the last event_id with GET events.  Send ping messages to keep the connection open, and reconnect with a new token before two hours.  Requires a token that resolves to a user, so use the device authorization flow. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [SfvbEventsAuthRequest] :events_auth_request Optional storefront filter
+    # @return [SfvbEventsAuthResponse]
+    def get_sfvb_events_authorization(opts = {})
+      data, _status_code, _headers = get_sfvb_events_authorization_with_http_info(opts)
+      data
+    end
+
+    # Open the event stream
+    # Returns a websocket URL and a single-use token, valid for 5 minutes, for the signed-in person&#39;s event stream.  Events are thin hints, type and ids only, and the stream is at most once.  Re-read the object before acting, and after every reconnect replay from the last event_id with GET events.  Send ping messages to keep the connection open, and reconnect with a new token before two hours.  Requires a token that resolves to a user, so use the device authorization flow. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [SfvbEventsAuthRequest] :events_auth_request Optional storefront filter
+    # @return [Array<(SfvbEventsAuthResponse, Integer, Hash)>] SfvbEventsAuthResponse data, response status code and response headers
+    def get_sfvb_events_authorization_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SfvbApi.get_sfvb_events_authorization ...'
+      end
+      # resource path
+      local_var_path = '/sfvb/events/auth'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      header_params['X-UltraCart-Api-Version'] = @api_client.select_header_api_version()
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json; charset=UTF-8'])
+      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(opts[:'events_auth_request'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SfvbEventsAuthResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ultraCartOauth', 'ultraCartSimpleApiKey']
+
+      new_options = opts.merge(
+        :operation => :"SfvbApi.get_sfvb_events_authorization",
+        :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: SfvbApi#get_sfvb_events_authorization\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Read one experiment and its statistics
     # The experiment, its variations and their statistics, and with daily=true each variation's daily rows.  p95_sessions_needed is estimated only after 1000 sessions, and sessions_needed_computed_dts says when.  For a url experiment, router_url is the address visitors must enter through. 
     # @param storefront_oid [Integer] 
@@ -4595,7 +4727,7 @@ module UltracartClient
     end
 
     # List the paths that answered 404
-    # The paths shoppers asked for that answered 404, most hits first or by last_seen.  Paths only, never query strings.  Bots are left out unless include_bots.  Token-like path segments show as {token} unless include_tokens.  limit is 1 to 100, default 50. 
+    # The paths shoppers asked for that answered 404, most hits first or by last_seen.  Paths only, never query strings.  Bots are left out unless include_bots.  Token-like path segments show as {token} unless include_tokens.  A path stays listed after a redirect rule catches it, with redirected_to set.  redirected=false lists only paths no rule catches yet, and redirected=true only those one does.  limit is 1 to 100, default 50. 
     # @param storefront_oid [Integer] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :since 
@@ -4604,6 +4736,7 @@ module UltracartClient
     # @option opts [Boolean] :include_tokens 
     # @option opts [String] :q 
     # @option opts [Integer] :limit 
+    # @option opts [Boolean] :redirected 
     # @return [SfvbNotFoundResponse]
     def get_sfvb_not_found(storefront_oid, opts = {})
       data, _status_code, _headers = get_sfvb_not_found_with_http_info(storefront_oid, opts)
@@ -4611,7 +4744,7 @@ module UltracartClient
     end
 
     # List the paths that answered 404
-    # The paths shoppers asked for that answered 404, most hits first or by last_seen.  Paths only, never query strings.  Bots are left out unless include_bots.  Token-like path segments show as {token} unless include_tokens.  limit is 1 to 100, default 50. 
+    # The paths shoppers asked for that answered 404, most hits first or by last_seen.  Paths only, never query strings.  Bots are left out unless include_bots.  Token-like path segments show as {token} unless include_tokens.  A path stays listed after a redirect rule catches it, with redirected_to set.  redirected&#x3D;false lists only paths no rule catches yet, and redirected&#x3D;true only those one does.  limit is 1 to 100, default 50. 
     # @param storefront_oid [Integer] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :since 
@@ -4620,6 +4753,7 @@ module UltracartClient
     # @option opts [Boolean] :include_tokens 
     # @option opts [String] :q 
     # @option opts [Integer] :limit 
+    # @option opts [Boolean] :redirected 
     # @return [Array<(SfvbNotFoundResponse, Integer, Hash)>] SfvbNotFoundResponse data, response status code and response headers
     def get_sfvb_not_found_with_http_info(storefront_oid, opts = {})
       if @api_client.config.debugging
@@ -4640,6 +4774,7 @@ module UltracartClient
       query_params[:'include_tokens'] = opts[:'include_tokens'] if !opts[:'include_tokens'].nil?
       query_params[:'q'] = opts[:'q'] if !opts[:'q'].nil?
       query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'redirected'] = opts[:'redirected'] if !opts[:'redirected'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -8552,7 +8687,7 @@ module UltracartClient
     end
 
     # Change one built-in message
-    # Sets one message in any number of languages.  ENG replaces the English, which drops its machine translations so they regenerate.  Any other language becomes a hand translation.  Languages not named are left alone; empty text is refused.  Shoppers see it at once.  Always needs sfvb_publish. 
+    # Sets one message in any number of languages.  ENG replaces the English, which drops its machine translations so they regenerate.  Any other language becomes a hand translation.  Languages not named are left alone.  Empty text removes that language's translation so machine translation fills it again (not allowed for ENG); it is the undo for an imported message, which can't be reset.  Shoppers see it at once.  Always needs sfvb_publish. 
     # @param storefront_oid [Integer] 
     # @param key [String] 
     # @param if_match [String] hash_sha256 from the last read.  Required; 428 when absent, 412 when stale.
@@ -8566,7 +8701,7 @@ module UltracartClient
     end
 
     # Change one built-in message
-    # Sets one message in any number of languages.  ENG replaces the English, which drops its machine translations so they regenerate.  Any other language becomes a hand translation.  Languages not named are left alone; empty text is refused.  Shoppers see it at once.  Always needs sfvb_publish. 
+    # Sets one message in any number of languages.  ENG replaces the English, which drops its machine translations so they regenerate.  Any other language becomes a hand translation.  Languages not named are left alone.  Empty text removes that language&#39;s translation so machine translation fills it again (not allowed for ENG); it is the undo for an imported message, which can&#39;t be reset.  Shoppers see it at once.  Always needs sfvb_publish. 
     # @param storefront_oid [Integer] 
     # @param key [String] 
     # @param if_match [String] hash_sha256 from the last read.  Required; 428 when absent, 412 when stale.

data/lib/ultracart_api/models/sfvb_container_version.rb

@@ -27,7 +27,7 @@ module UltracartClient
     # Container name, where the owner has more than one container.
     attr_accessor :container_name
 
-    # When this snapshot was taken.
+    # When this snapshot was taken, ISO 8601 UTC.
     attr_accessor :created_dts
 
     # True for the value currently stored.