ultracart_api 4.1.200 → 4.1.202

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c31b64268acb1092ec9ac34c018320da17be12077a1811a22dcfb40f8b2951a
-  data.tar.gz: c0d2caf53984e3f593ea2ee5b09c9e2eec11dca7a501323fc16405720c4b8fb7
+  metadata.gz: c8e2a0df2a48694c297eccac324214153614a364647f403482a52863732a8d42
+  data.tar.gz: 6391ca2c7f7f14054a3c351fb22165e8e8f793c0685af64e4deefd5c33dd3928
 SHA512:
-  metadata.gz: 90e7180843483a64e17e273243889cb86e5450737eaa9a1e85cdca19fa0abaeb316bb018ab759619122a5b08fe16faf8b4284bcac3bd2ac3bb4293221fed5ccc
-  data.tar.gz: ee10c6be44c3e4d95fe1b834ce9d8de9eb729873f7a4ce5cf639ffc64ebf40271d2bdef860eb9b0c90ef0b31cd204c6ff9e789fcee684441610ba0cccdf1dae6
+  metadata.gz: d2f086140b99df10e1fc950f74e5bb323b83289356a330c6ea78499c271c73a5a1b1085ae108a30d1a089c622ed65cde9fbf170521c97a91cbd2ee853f5e6ac3
+  data.tar.gz: 53ec4581fefb66a0b5021744599a789c9e4e634b9b017b4dd1980e118ee46fabaf7f31272e815ca39e06fd7369eadd8f2df00acd0b861f59fb84c9898bb51d25

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.202
 - 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.202'
 ```
 
 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
@@ -597,6 +599,7 @@ Class | Method | HTTP request | Description
 *UltracartClient::SfvbApi* | [**put_sfvb_item_attributes**](docs/SfvbApi.md#put_sfvb_item_attributes) | **PUT** /sfvb/storefronts/{storefront_oid}/items/attributes | Change some of an item's attributes
 *UltracartClient::SfvbApi* | [**put_sfvb_item_content**](docs/SfvbApi.md#put_sfvb_item_content) | **PUT** /sfvb/storefronts/{storefront_oid}/items/content | Change an item's title or long description
 *UltracartClient::SfvbApi* | [**put_sfvb_item_multimedia**](docs/SfvbApi.md#put_sfvb_item_multimedia) | **PUT** /sfvb/storefronts/{storefront_oid}/items/multimedia | Attach an image to an item
+*UltracartClient::SfvbApi* | [**put_sfvb_item_multimedia_description**](docs/SfvbApi.md#put_sfvb_item_multimedia_description) | **PUT** /sfvb/storefronts/{storefront_oid}/items/multimedia/description | Change an item image's description
 *UltracartClient::SfvbApi* | [**put_sfvb_item_pricing**](docs/SfvbApi.md#put_sfvb_item_pricing) | **PUT** /sfvb/storefronts/{storefront_oid}/items/pricing | Change what an item charges
 *UltracartClient::SfvbApi* | [**put_sfvb_item_related**](docs/SfvbApi.md#put_sfvb_item_related) | **PUT** /sfvb/storefronts/{storefront_oid}/items/related | Replace an item's related items
 *UltracartClient::SfvbApi* | [**put_sfvb_item_seo**](docs/SfvbApi.md#put_sfvb_item_seo) | **PUT** /sfvb/storefronts/{storefront_oid}/items/seo | Change an item's search metadata
@@ -1888,6 +1891,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)
@@ -1931,6 +1938,7 @@ Class | Method | HTTP request | Description
  - [UltracartClient::SfvbItemContainersResponse](docs/SfvbItemContainersResponse.md)
  - [UltracartClient::SfvbItemContentRequest](docs/SfvbItemContentRequest.md)
  - [UltracartClient::SfvbItemMultimedia](docs/SfvbItemMultimedia.md)
+ - [UltracartClient::SfvbItemMultimediaDescriptionRequest](docs/SfvbItemMultimediaDescriptionRequest.md)
  - [UltracartClient::SfvbItemMultimediaRequest](docs/SfvbItemMultimediaRequest.md)
  - [UltracartClient::SfvbItemPricing](docs/SfvbItemPricing.md)
  - [UltracartClient::SfvbItemPricingRequest](docs/SfvbItemPricingRequest.md)
@@ -2244,6 +2252,8 @@ Not every change is committed to every SDK.
 
 | Version | Date | Comments |
 | --: | :-: | --- |
+| 4.1.202 | 10/13/2026 | sfvb internal testing |
+| 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/OauthApi.md

@@ -294,7 +294,7 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **client_id** | **String** | The OAuth application client_id. |  |
-| **token** | **String** | The OAuth access token that is to be revoked.. |  |
+| **token** | **String** | The OAuth access token or refresh token that is to be revoked. |  |
 
 ### Return type
 

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 |
@@ -125,6 +127,7 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
 | [**put_sfvb_item_attributes**](SfvbApi.md#put_sfvb_item_attributes) | **PUT** /sfvb/storefronts/{storefront_oid}/items/attributes | Change some of an item's attributes |
 | [**put_sfvb_item_content**](SfvbApi.md#put_sfvb_item_content) | **PUT** /sfvb/storefronts/{storefront_oid}/items/content | Change an item's title or long description |
 | [**put_sfvb_item_multimedia**](SfvbApi.md#put_sfvb_item_multimedia) | **PUT** /sfvb/storefronts/{storefront_oid}/items/multimedia | Attach an image to an item |
+| [**put_sfvb_item_multimedia_description**](SfvbApi.md#put_sfvb_item_multimedia_description) | **PUT** /sfvb/storefronts/{storefront_oid}/items/multimedia/description | Change an item image's description |
 | [**put_sfvb_item_pricing**](SfvbApi.md#put_sfvb_item_pricing) | **PUT** /sfvb/storefronts/{storefront_oid}/items/pricing | Change what an item charges |
 | [**put_sfvb_item_related**](SfvbApi.md#put_sfvb_item_related) | **PUT** /sfvb/storefronts/{storefront_oid}/items/related | Replace an item's related items |
 | [**put_sfvb_item_seo**](SfvbApi.md#put_sfvb_item_seo) | **PUT** /sfvb/storefronts/{storefront_oid}/items/seo | Change an item's search metadata |
@@ -2141,7 +2144,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 +2623,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 +3713,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 +3751,7 @@ end
 | **include_tokens** | **Boolean** |  | [optional] |
 | **q** | **String** |  | [optional] |
 | **limit** | **Integer** |  | [optional] |
+| **redirected** | **Boolean** |  | [optional] |
 
 ### Return type
 
@@ -6564,7 +6676,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
@@ -6783,6 +6895,62 @@ end
 - **Accept**: application/json
 
 
+## put_sfvb_item_multimedia_description
+
+> <SfvbItemResponse> put_sfvb_item_multimedia_description(storefront_oid, item_multimedia_description_request, opts)
+
+Change an item image's description
+
+Changes the description (alt text) of one image already attached to the item, in place.  The image is not touched.  Name it by merchant_item_multimedia_oid, or by exactly one of code or default; gallery images often have no code.  An empty description clears it, so the render falls back again.  Send the description_sha256 you read as current_sha256 so a change made since is not overwritten.  A description written here takes the place of the machine description, and image recognition never overwrites it. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the put_sfvb_item_multimedia_description_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbItemResponse>, Integer, Hash)> put_sfvb_item_multimedia_description_with_http_info(storefront_oid, item_multimedia_description_request, opts)
+
+```ruby
+begin
+  # Change an item image's description
+  data, status_code, headers = api_instance.put_sfvb_item_multimedia_description_with_http_info(storefront_oid, item_multimedia_description_request, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbItemResponse>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->put_sfvb_item_multimedia_description_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **item_multimedia_description_request** | [**SfvbItemMultimediaDescriptionRequest**](SfvbItemMultimediaDescriptionRequest.md) | The image and its new description |  |
+| **merchant_item_id** | **String** |  | [optional] |
+| **merchant_item_oid** | **Integer** |  | [optional] |
+
+### Return type
+
+[**SfvbItemResponse**](SfvbItemResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## put_sfvb_item_pricing
 
 > <SfvbItemPricing> put_sfvb_item_pricing(storefront_oid, if_match, item_pricing_request, opts)

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/SfvbItemMultimedia.md

@@ -7,10 +7,14 @@
 | **code** | **String** | The image code, which is what an itemimage element's itemImageCode refers to.  Empty for the default image. | [optional] |
 | **declared** | **Boolean** | True when a template declares this code.  A slot that is attached but not declared is an image nothing on the page is asking for. | [optional] |
 | **default** | **Boolean** | True for the image an itemimage element with no code renders.  Default is per media type, so an item may have one default image and one default PDF at the same time. | [optional] |
-| **description** | **String** | Stored with the image and rendered as its alt text.  When it is empty the render falls back to the item's own description, so an empty value here is not an empty alt attribute. | [optional] |
+| **description** | **String** | The merchant's description, stored with the image and rendered as its alt text.  When it is empty the render falls back to rekognition_description or to text built from the item's title, depending on the element, so an empty value here is not an empty alt attribute. | [optional] |
+| **description_sha256** | **String** | SHA-256 of description (empty when there is none).  Send it as current_sha256 when changing the description so a change made since you read it is not overwritten. | [optional] |
+| **description_source** | **String** | Where the alt text comes from now.  merchant when description is set, rekognition when only rekognition_description is, none otherwise. | [optional] |
 | **dimensions** | **String** | Width x height in pixels, when the storage measured the file. | [optional] |
 | **exclude_from_gallery** | **Boolean** | True when the storage marks this image as kept out of the item gallery. | [optional] |
 | **filename** | **String** | The stored file's name.  Empty when the slot is declared and nothing is attached. | [optional] |
+| **merchant_item_multimedia_oid** | **Integer** | The stored image's id.  Name it to change this image's description when it has no code. | [optional] |
+| **rekognition_description** | **String** | The machine description image recognition produced for the stored image, if any.  It is used only while description is empty, and a description written here or in the admin always takes its place. | [optional] |
 | **type** | **String** | The media type the storage recorded. | [optional] |
 | **view_url** | **String** | Where the stored image is served.  Absent when nothing is attached to the slot. | [optional] |
 
@@ -24,9 +28,13 @@ instance = UltracartClient::SfvbItemMultimedia.new(
   declared: null,
   default: null,
   description: null,
+  description_sha256: null,
+  description_source: null,
   dimensions: null,
   exclude_from_gallery: null,
   filename: null,
+  merchant_item_multimedia_oid: null,
+  rekognition_description: null,
   type: null,
   view_url: null
 )

data/docs/SfvbItemMultimediaDescriptionRequest.md

@@ -0,0 +1,26 @@
+# UltracartClient::SfvbItemMultimediaDescriptionRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **code** | **String** | The image code, the value an itemimage element's itemImageCode names. | [optional] |
+| **current_sha256** | **String** | The description_sha256 you read.  When it is sent and the description has changed since, nothing is written and the call fails with a version conflict. | [optional] |
+| **default** | **Boolean** | The item's default image, which an itemimage element with no code renders. | [optional] |
+| **description** | **String** | The new description, rendered as the image's alt text.  An empty string clears it, so the image falls back to the machine description or the element's own fallback.  Longer text is cut to 500 characters. | [optional] |
+| **merchant_item_multimedia_oid** | **Integer** | The stored image's id, as an item read reports it.  Name this, or one of code or default. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbItemMultimediaDescriptionRequest.new(
+  code: null,
+  current_sha256: null,
+  default: null,
+  description: null,
+  merchant_item_multimedia_oid: null
+)
+```
+

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/oauth_api.rb

@@ -259,7 +259,7 @@ module UltracartClient
     # Revoke this OAuth application.
     # Revokes the OAuth application associated with the specified client_id and token. 
     # @param client_id [String] The OAuth application client_id.
-    # @param token [String] The OAuth access token that is to be revoked..
+    # @param token [String] The OAuth access token or refresh token that is to be revoked.
     # @param [Hash] opts the optional parameters
     # @return [OauthRevokeSuccessResponse]
     def oauth_revoke(client_id, token, opts = {})
@@ -270,7 +270,7 @@ module UltracartClient
     # Revoke this OAuth application.
     # Revokes the OAuth application associated with the specified client_id and token. 
     # @param client_id [String] The OAuth application client_id.
-    # @param token [String] The OAuth access token that is to be revoked..
+    # @param token [String] The OAuth access token or refresh token that is to be revoked.
     # @param [Hash] opts the optional parameters
     # @return [Array<(OauthRevokeSuccessResponse, Integer, Hash)>] OauthRevokeSuccessResponse data, response status code and response headers
     def oauth_revoke_with_http_info(client_id, token, opts = {})