ultracart_api 4.1.169 → 4.1.171

data/docs/SfvbApi.md

@@ -6,15 +6,22 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
 | ------ | ------------ | ----------- |
 | [**add_sfvb_page_blog_posts**](SfvbApi.md#add_sfvb_page_blog_posts) | **POST** /sfvb/storefronts/{storefront_oid}/pages/blog_posts/add | Assign blog posts to a page |
 | [**add_sfvb_page_items**](SfvbApi.md#add_sfvb_page_items) | **POST** /sfvb/storefronts/{storefront_oid}/pages/items/add | Assign items to a page |
+| [**archive_sfvb_upsell_path**](SfvbApi.md#archive_sfvb_upsell_path) | **POST** /sfvb/storefronts/{storefront_oid}/upsell_paths/{upsell_path_oid}/archive | Archive an upsell path |
 | [**compile_sfvb_cjson**](SfvbApi.md#compile_sfvb_cjson) | **POST** /sfvb/cjson/compile | Compile CJSON to Velocity |
 | [**create_sfvb_preview_access**](SfvbApi.md#create_sfvb_preview_access) | **POST** /sfvb/storefronts/{storefront_oid}/preview_access | One time link that opens a preview in a browser with no UltraCart login |
 | [**create_sfvb_preview_session**](SfvbApi.md#create_sfvb_preview_session) | **POST** /sfvb/storefronts/{storefront_oid}/preview_sessions | Create a preview session |
 | [**delete_sfvb_file**](SfvbApi.md#delete_sfvb_file) | **DELETE** /sfvb/storefronts/{storefront_oid}/files | Delete a storefront file |
+| [**delete_sfvb_item_attribute**](SfvbApi.md#delete_sfvb_item_attribute) | **DELETE** /sfvb/storefronts/{storefront_oid}/items/attributes | Delete an attribute from an item |
+| [**delete_sfvb_item_multimedia**](SfvbApi.md#delete_sfvb_item_multimedia) | **DELETE** /sfvb/storefronts/{storefront_oid}/items/multimedia | Detach an image from an item |
 | [**delete_sfvb_page_multimedia**](SfvbApi.md#delete_sfvb_page_multimedia) | **DELETE** /sfvb/storefronts/{storefront_oid}/pages/multimedia | Detach an image from a page |
 | [**delete_sfvb_preview_session**](SfvbApi.md#delete_sfvb_preview_session) | **DELETE** /sfvb/storefronts/{storefront_oid}/preview_sessions/{preview_session_id} | Delete a preview session |
+| [**disable_sfvb_upsell_offer**](SfvbApi.md#disable_sfvb_upsell_offer) | **POST** /sfvb/storefronts/{storefront_oid}/upsell_offers/{upsell_offer_oid}/disable | Disable an upsell offer |
+| [**disable_sfvb_upsell_path**](SfvbApi.md#disable_sfvb_upsell_path) | **POST** /sfvb/storefronts/{storefront_oid}/upsell_paths/{upsell_path_oid}/disable | Disable an upsell path |
 | [**download_sfvb_file**](SfvbApi.md#download_sfvb_file) | **GET** /sfvb/storefronts/{storefront_oid}/files/download | Read a storefront file's raw bytes |
 | [**duplicate_sfvb_page**](SfvbApi.md#duplicate_sfvb_page) | **POST** /sfvb/storefronts/{storefront_oid}/pages/duplicate | Copy a page to a new path |
 | [**duplicate_sfvb_theme**](SfvbApi.md#duplicate_sfvb_theme) | **POST** /sfvb/storefronts/{storefront_oid}/themes/{theme_oid}/duplicate | Duplicate a theme |
+| [**duplicate_sfvb_upsell_offer**](SfvbApi.md#duplicate_sfvb_upsell_offer) | **POST** /sfvb/storefronts/{storefront_oid}/upsell_offers/{upsell_offer_oid}/duplicate | Duplicate an upsell offer |
+| [**duplicate_sfvb_upsell_path**](SfvbApi.md#duplicate_sfvb_upsell_path) | **POST** /sfvb/storefronts/{storefront_oid}/upsell_paths/{upsell_path_oid}/duplicate | Duplicate an upsell path or one of its variations |
 | [**end_sfvb_experiment**](SfvbApi.md#end_sfvb_experiment) | **POST** /sfvb/storefronts/{storefront_oid}/experiments/{experiment_oid}/end | End an experiment |
 | [**get_sfvb_cjson_used_elements**](SfvbApi.md#get_sfvb_cjson_used_elements) | **POST** /sfvb/cjson/elements | Element types used by a container |
 | [**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 |
@@ -24,6 +31,7 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
 | [**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 |
 | [**get_sfvb_file_upload_url**](SfvbApi.md#get_sfvb_file_upload_url) | **GET** /sfvb/storefronts/{storefront_oid}/files/upload_url/{extension} | Get a URL to upload a binary asset to |
+| [**get_sfvb_item**](SfvbApi.md#get_sfvb_item) | **GET** /sfvb/storefronts/{storefront_oid}/items | Read an item's storefront facing content |
 | [**get_sfvb_library_entry**](SfvbApi.md#get_sfvb_library_entry) | **GET** /sfvb/storefronts/{storefront_oid}/library/{library_oid} | Read one library entry including its CJSON |
 | [**get_sfvb_menu**](SfvbApi.md#get_sfvb_menu) | **GET** /sfvb/storefronts/{storefront_oid}/menus/{code} | Read one store menu and its entries |
 | [**get_sfvb_menus**](SfvbApi.md#get_sfvb_menus) | **GET** /sfvb/storefronts/{storefront_oid}/menus | List a storefront's store menus |
@@ -36,9 +44,13 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
 | [**get_sfvb_theme**](SfvbApi.md#get_sfvb_theme) | **GET** /sfvb/storefronts/{storefront_oid}/themes/{theme_oid} | Get a theme |
 | [**get_sfvb_theme_attributes**](SfvbApi.md#get_sfvb_theme_attributes) | **GET** /sfvb/storefronts/{storefront_oid}/themes/{theme_oid}/attributes | Read a theme's colors, fonts and settings |
 | [**get_sfvb_theme_job**](SfvbApi.md#get_sfvb_theme_job) | **GET** /sfvb/storefronts/{storefront_oid}/theme_jobs/{job_id} | Status of an asynchronous theme job |
+| [**get_sfvb_upsell_offer**](SfvbApi.md#get_sfvb_upsell_offer) | **GET** /sfvb/storefronts/{storefront_oid}/upsell_offers/{upsell_offer_oid} | Get an upsell offer |
+| [**get_sfvb_upsell_path**](SfvbApi.md#get_sfvb_upsell_path) | **GET** /sfvb/storefronts/{storefront_oid}/upsell_paths/{upsell_path_oid} | Get an upsell path |
 | [**get_sfvb_version**](SfvbApi.md#get_sfvb_version) | **GET** /sfvb/version | Compiler version for this merchant |
 | [**get_sfvb_whoami**](SfvbApi.md#get_sfvb_whoami) | **GET** /sfvb/whoami | Who this token is |
 | [**insert_sfvb_page**](SfvbApi.md#insert_sfvb_page) | **POST** /sfvb/storefronts/{storefront_oid}/pages | Create a page |
+| [**insert_sfvb_upsell_offer**](SfvbApi.md#insert_sfvb_upsell_offer) | **POST** /sfvb/storefronts/{storefront_oid}/upsell_offers | Create an upsell offer |
+| [**insert_sfvb_upsell_path**](SfvbApi.md#insert_sfvb_upsell_path) | **POST** /sfvb/storefronts/{storefront_oid}/upsell_paths | Create an upsell path |
 | [**install_sfvb_library_entry**](SfvbApi.md#install_sfvb_library_entry) | **POST** /sfvb/storefronts/{storefront_oid}/library/{library_oid}/install | Install a library entry into a storefront |
 | [**list_sfvb_blog_posts**](SfvbApi.md#list_sfvb_blog_posts) | **GET** /sfvb/storefronts/{storefront_oid}/blog_posts | List the storefront's blog posts |
 | [**list_sfvb_container_versions**](SfvbApi.md#list_sfvb_container_versions) | **GET** /sfvb/storefronts/{storefront_oid}/container_versions | Version history for a container stored outside the file system |
@@ -52,9 +64,15 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
 | [**list_sfvb_templates**](SfvbApi.md#list_sfvb_templates) | **GET** /sfvb/storefronts/{storefront_oid}/templates | List the active theme's templates |
 | [**list_sfvb_themes**](SfvbApi.md#list_sfvb_themes) | **GET** /sfvb/storefronts/{storefront_oid}/themes | List themes for a storefront |
 | [**list_sfvb_upsell_offers**](SfvbApi.md#list_sfvb_upsell_offers) | **GET** /sfvb/storefronts/{storefront_oid}/upsell_offers | List upsell offers |
+| [**list_sfvb_upsell_paths**](SfvbApi.md#list_sfvb_upsell_paths) | **GET** /sfvb/storefronts/{storefront_oid}/upsell_paths | List upsell paths |
+| [**move_sfvb_upsell_path**](SfvbApi.md#move_sfvb_upsell_path) | **POST** /sfvb/storefronts/{storefront_oid}/upsell_paths/{upsell_path_oid}/move | Move an upsell path |
 | [**put_sfvb_container**](SfvbApi.md#put_sfvb_container) | **PUT** /sfvb/storefronts/{storefront_oid}/containers/{owner_type}/{owner_object_id} | Write a container stored outside the file system |
 | [**put_sfvb_experiment_variation**](SfvbApi.md#put_sfvb_experiment_variation) | **PUT** /sfvb/storefronts/{storefront_oid}/experiments/{experiment_oid}/variations/{variation_number} | Pause or resume a variation |
 | [**put_sfvb_file_content**](SfvbApi.md#put_sfvb_file_content) | **PUT** /sfvb/storefronts/{storefront_oid}/files/content | Write a storefront file |
+| [**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_seo**](SfvbApi.md#put_sfvb_item_seo) | **PUT** /sfvb/storefronts/{storefront_oid}/items/seo | Change an item's search metadata |
 | [**put_sfvb_menu**](SfvbApi.md#put_sfvb_menu) | **PUT** /sfvb/storefronts/{storefront_oid}/menus/{code} | Replace a store menu's entries |
 | [**put_sfvb_page_attributes**](SfvbApi.md#put_sfvb_page_attributes) | **PUT** /sfvb/storefronts/{storefront_oid}/pages/attributes | Change a page's attributes |
 | [**put_sfvb_page_multimedia**](SfvbApi.md#put_sfvb_page_multimedia) | **PUT** /sfvb/storefronts/{storefront_oid}/pages/multimedia | Attach an image to a page |
@@ -72,6 +90,9 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
 | [**search_sfvb_files**](SfvbApi.md#search_sfvb_files) | **POST** /sfvb/storefronts/{storefront_oid}/files/search | Search storefront files |
 | [**search_sfvb_library**](SfvbApi.md#search_sfvb_library) | **GET** /sfvb/storefronts/{storefront_oid}/library | Search the element library |
 | [**start_sfvb_experiment**](SfvbApi.md#start_sfvb_experiment) | **POST** /sfvb/storefronts/{storefront_oid}/experiments | Start an experiment |
+| [**unarchive_sfvb_upsell_path**](SfvbApi.md#unarchive_sfvb_upsell_path) | **POST** /sfvb/storefronts/{storefront_oid}/upsell_paths/{upsell_path_oid}/unarchive | Unarchive an upsell path |
+| [**update_sfvb_upsell_offer**](SfvbApi.md#update_sfvb_upsell_offer) | **PUT** /sfvb/storefronts/{storefront_oid}/upsell_offers/{upsell_offer_oid} | Update an upsell offer |
+| [**update_sfvb_upsell_path**](SfvbApi.md#update_sfvb_upsell_path) | **PUT** /sfvb/storefronts/{storefront_oid}/upsell_paths/{upsell_path_oid} | Update an upsell path |
 | [**upload_sfvb_file**](SfvbApi.md#upload_sfvb_file) | **POST** /sfvb/storefronts/{storefront_oid}/files/upload | Store a binary asset that was already uploaded |
 | [**validate_sfvb_cjson**](SfvbApi.md#validate_sfvb_cjson) | **POST** /sfvb/cjson/validate | Validate CJSON |
 | [**validate_sfvb_velocity**](SfvbApi.md#validate_sfvb_velocity) | **POST** /sfvb/storefronts/{storefront_oid}/themes/{theme_oid}/velocity/validate | Validate a Velocity template against a theme |
@@ -187,6 +208,60 @@ end
 - **Accept**: application/json
 
 
+## archive_sfvb_upsell_path
+
+> <SfvbUpsellPath> archive_sfvb_upsell_path(storefront_oid, upsell_path_oid)
+
+Archive an upsell path
+
+Files the path out of the default list.  An archived path does not run.  Archiving one that is switched on is a live change and needs sfvb_publish. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the archive_sfvb_upsell_path_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbUpsellPath>, Integer, Hash)> archive_sfvb_upsell_path_with_http_info(storefront_oid, upsell_path_oid)
+
+```ruby
+begin
+  # Archive an upsell path
+  data, status_code, headers = api_instance.archive_sfvb_upsell_path_with_http_info(storefront_oid, upsell_path_oid)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbUpsellPath>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->archive_sfvb_upsell_path_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **upsell_path_oid** | **Integer** |  |  |
+
+### Return type
+
+[**SfvbUpsellPath**](SfvbUpsellPath.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## compile_sfvb_cjson
 
 > <SfvbCompileResponse> compile_sfvb_cjson(compile_request)
@@ -402,13 +477,13 @@ nil (empty response body)
 - **Accept**: application/json
 
 
-## delete_sfvb_page_multimedia
+## delete_sfvb_item_attribute
 
-> <SfvbPageResponse> delete_sfvb_page_multimedia(storefront_oid, path, opts)
+> <SfvbItemResponse> delete_sfvb_item_attribute(storefront_oid, name, opts)
 
-Detach an image from a page
+Delete an attribute from an item
 
-Name exactly one of code or default.  Removes the page's copy of the image; the source file in the page folder is left alone.  Always needs sfvb_publish. 
+Removes one attribute that no template on the item's pages declares - a test name, a misspelling, one a retired template used.  A declared attribute is refused, because the template would list it again, empty; send an empty value through the attributes update to clear one of those instead. 
 
 
 ### Examples
@@ -417,21 +492,21 @@ Name exactly one of code or default.  Removes the page's copy of the image; the
 (No example for this operation).
 
 
-#### Using the delete_sfvb_page_multimedia_with_http_info variant
+#### Using the delete_sfvb_item_attribute_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbPageResponse>, Integer, Hash)> delete_sfvb_page_multimedia_with_http_info(storefront_oid, path, opts)
+> <Array(<SfvbItemResponse>, Integer, Hash)> delete_sfvb_item_attribute_with_http_info(storefront_oid, name, opts)
 
 ```ruby
 begin
-  # Detach an image from a page
-  data, status_code, headers = api_instance.delete_sfvb_page_multimedia_with_http_info(storefront_oid, path, opts)
+  # Delete an attribute from an item
+  data, status_code, headers = api_instance.delete_sfvb_item_attribute_with_http_info(storefront_oid, name, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbPageResponse>
+  p data # => <SfvbItemResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->delete_sfvb_page_multimedia_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->delete_sfvb_item_attribute_with_http_info: #{e}"
 end
 ```
 
@@ -440,13 +515,13 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **path** | **String** | Page path, for example /catalog/dispensers/ |  |
-| **code** | **String** | Image code to detach | [optional] |
-| **default** | **Boolean** | True to detach the default image | [optional] |
+| **name** | **String** | The attribute name, matched without regard to case |  |
+| **merchant_item_id** | **String** |  | [optional] |
+| **merchant_item_oid** | **Integer** |  | [optional] |
 
 ### Return type
 
-[**SfvbPageResponse**](SfvbPageResponse.md)
+[**SfvbItemResponse**](SfvbItemResponse.md)
 
 ### Authorization
 
@@ -458,13 +533,13 @@ end
 - **Accept**: application/json
 
 
-## delete_sfvb_preview_session
+## delete_sfvb_item_multimedia
 
-> delete_sfvb_preview_session(storefront_oid, preview_session_id)
+> <SfvbItemResponse> delete_sfvb_item_multimedia(storefront_oid, opts)
 
-Delete a preview session
+Detach an image from an item
 
-Releases the session before its eight hour expiry.  Without this the only way to free one is to wait, which is a poor answer for a tool that may open a dozen in an afternoon. 
+Removes the item's copy of the image in one slot.  The file you uploaded is left where it is, so the same source can be attached again or used elsewhere. 
 
 
 ### Examples
@@ -473,21 +548,21 @@ Releases the session before its eight hour expiry.  Without this the only way to
 (No example for this operation).
 
 
-#### Using the delete_sfvb_preview_session_with_http_info variant
+#### Using the delete_sfvb_item_multimedia_with_http_info variant
 
-This returns an Array which contains the response data (`nil` in this case), status code and headers.
+This returns an Array which contains the response data, status code and headers.
 
-> <Array(nil, Integer, Hash)> delete_sfvb_preview_session_with_http_info(storefront_oid, preview_session_id)
+> <Array(<SfvbItemResponse>, Integer, Hash)> delete_sfvb_item_multimedia_with_http_info(storefront_oid, opts)
 
 ```ruby
 begin
-  # Delete a preview session
-  data, status_code, headers = api_instance.delete_sfvb_preview_session_with_http_info(storefront_oid, preview_session_id)
+  # Detach an image from an item
+  data, status_code, headers = api_instance.delete_sfvb_item_multimedia_with_http_info(storefront_oid, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => nil
+  p data # => <SfvbItemResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->delete_sfvb_preview_session_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->delete_sfvb_item_multimedia_with_http_info: #{e}"
 end
 ```
 
@@ -496,11 +571,14 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **preview_session_id** | **String** |  |  |
+| **merchant_item_id** | **String** |  | [optional] |
+| **merchant_item_oid** | **Integer** |  | [optional] |
+| **code** | **String** | The image code to detach | [optional] |
+| **default** | **Boolean** | Detach the default image instead of a coded one | [optional] |
 
 ### Return type
 
-nil (empty response body)
+[**SfvbItemResponse**](SfvbItemResponse.md)
 
 ### Authorization
 
@@ -512,13 +590,13 @@ nil (empty response body)
 - **Accept**: application/json
 
 
-## download_sfvb_file
+## delete_sfvb_page_multimedia
 
-> download_sfvb_file(storefront_oid, opts)
+> <SfvbPageResponse> delete_sfvb_page_multimedia(storefront_oid, path, opts)
 
-Read a storefront file's raw bytes
+Detach an image from a page
 
-Returns the file itself rather than a JSON envelope, for any type including binaries that files/content refuses.  Use this to verify what you uploaded, and note it is the only way to read a file inside a theme that is not active - such a file is served to nobody until the theme is promoted, so it has no public URL to fetch instead.  On success the body is the file; on failure it is the usual JSON error object, so do not assume the content type without checking the status. 
+Name exactly one of code or default.  Removes the page's copy of the image; the source file in the page folder is left alone.  Always needs sfvb_publish. 
 
 
 ### Examples
@@ -527,21 +605,21 @@ Returns the file itself rather than a JSON envelope, for any type including bina
 (No example for this operation).
 
 
-#### Using the download_sfvb_file_with_http_info variant
+#### Using the delete_sfvb_page_multimedia_with_http_info variant
 
-This returns an Array which contains the response data (`nil` in this case), status code and headers.
+This returns an Array which contains the response data, status code and headers.
 
-> <Array(nil, Integer, Hash)> download_sfvb_file_with_http_info(storefront_oid, opts)
+> <Array(<SfvbPageResponse>, Integer, Hash)> delete_sfvb_page_multimedia_with_http_info(storefront_oid, path, opts)
 
 ```ruby
 begin
-  # Read a storefront file's raw bytes
-  data, status_code, headers = api_instance.download_sfvb_file_with_http_info(storefront_oid, opts)
+  # Detach an image from a page
+  data, status_code, headers = api_instance.delete_sfvb_page_multimedia_with_http_info(storefront_oid, path, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => nil
+  p data # => <SfvbPageResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->download_sfvb_file_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->delete_sfvb_page_multimedia_with_http_info: #{e}"
 end
 ```
 
@@ -550,11 +628,13 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **path** | **String** |  | [optional] |
+| **path** | **String** | Page path, for example /catalog/dispensers/ |  |
+| **code** | **String** | Image code to detach | [optional] |
+| **default** | **Boolean** | True to detach the default image | [optional] |
 
 ### Return type
 
-nil (empty response body)
+[**SfvbPageResponse**](SfvbPageResponse.md)
 
 ### Authorization
 
@@ -563,16 +643,16 @@ nil (empty response body)
 ### HTTP request headers
 
 - **Content-Type**: Not defined
-- **Accept**: application/octet-stream
+- **Accept**: application/json
 
 
-## duplicate_sfvb_page
+## delete_sfvb_preview_session
 
-> <SfvbPageResponse> duplicate_sfvb_page(storefront_oid, page_duplicate_request)
+> delete_sfvb_preview_session(storefront_oid, preview_session_id)
 
-Copy a page to a new path
+Delete a preview session
 
-Copies what the store admin's duplicate copies - settings, items, blog posts, permissions, attributes, selectors, images and the page folder with its body.  The copy goes to the path you choose, under any existing page, with the same path rules as creating a page, and a 409 with the code sfvb.page_exists when that path is taken.  The root page and pages with pages under them cannot be copied.  A page whose folder holds a started experiment is refused, because the copy would share the experiment - end it first.  Translated title and description text is not copied.  Always needs sfvb_publish, because the copy is live as soon as it exists. 
+Releases the session before its eight hour expiry.  Without this the only way to free one is to wait, which is a poor answer for a tool that may open a dozen in an afternoon. 
 
 
 ### Examples
@@ -581,21 +661,21 @@ Copies what the store admin's duplicate copies - settings, items, blog posts, pe
 (No example for this operation).
 
 
-#### Using the duplicate_sfvb_page_with_http_info variant
+#### Using the delete_sfvb_preview_session_with_http_info variant
 
-This returns an Array which contains the response data, status code and headers.
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
 
-> <Array(<SfvbPageResponse>, Integer, Hash)> duplicate_sfvb_page_with_http_info(storefront_oid, page_duplicate_request)
+> <Array(nil, Integer, Hash)> delete_sfvb_preview_session_with_http_info(storefront_oid, preview_session_id)
 
 ```ruby
 begin
-  # Copy a page to a new path
-  data, status_code, headers = api_instance.duplicate_sfvb_page_with_http_info(storefront_oid, page_duplicate_request)
+  # Delete a preview session
+  data, status_code, headers = api_instance.delete_sfvb_preview_session_with_http_info(storefront_oid, preview_session_id)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbPageResponse>
+  p data # => nil
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->duplicate_sfvb_page_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->delete_sfvb_preview_session_with_http_info: #{e}"
 end
 ```
 
@@ -604,11 +684,11 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **page_duplicate_request** | [**SfvbPageDuplicateRequest**](SfvbPageDuplicateRequest.md) | The page to copy and where |  |
+| **preview_session_id** | **String** |  |  |
 
 ### Return type
 
-[**SfvbPageResponse**](SfvbPageResponse.md)
+nil (empty response body)
 
 ### Authorization
 
@@ -616,17 +696,17 @@ end
 
 ### HTTP request headers
 
-- **Content-Type**: application/json; charset=UTF-8
+- **Content-Type**: Not defined
 - **Accept**: application/json
 
 
-## duplicate_sfvb_theme
+## disable_sfvb_upsell_offer
 
-> <SfvbThemeJobResponse> duplicate_sfvb_theme(storefront_oid, theme_oid, duplicate_request)
+> <SfvbUpsellOffer> disable_sfvb_upsell_offer(storefront_oid, upsell_offer_oid)
 
-Duplicate a theme
+Disable an upsell offer
 
-Copies a theme into a new one and returns a job handle to poll.  Asynchronous, because copying a theme copies every file in it.  Needs sfvb_write rather than sfvb_publish, because the job explicitly does not activate what it creates, so the worst outcome of a mistaken call is a spare theme.  This is how you get somewhere safe to work - duplicate, edit the copy with an ordinary write scope, and let a human promote it. 
+Switches the offer off.  Disabling one that is switched on is a live change and needs sfvb_publish.  An offer that is already off is returned unchanged.  There is no delete. 
 
 
 ### Examples
@@ -635,21 +715,21 @@ Copies a theme into a new one and returns a job handle to poll.  Asynchronous, b
 (No example for this operation).
 
 
-#### Using the duplicate_sfvb_theme_with_http_info variant
+#### Using the disable_sfvb_upsell_offer_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbThemeJobResponse>, Integer, Hash)> duplicate_sfvb_theme_with_http_info(storefront_oid, theme_oid, duplicate_request)
+> <Array(<SfvbUpsellOffer>, Integer, Hash)> disable_sfvb_upsell_offer_with_http_info(storefront_oid, upsell_offer_oid)
 
 ```ruby
 begin
-  # Duplicate a theme
-  data, status_code, headers = api_instance.duplicate_sfvb_theme_with_http_info(storefront_oid, theme_oid, duplicate_request)
+  # Disable an upsell offer
+  data, status_code, headers = api_instance.disable_sfvb_upsell_offer_with_http_info(storefront_oid, upsell_offer_oid)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbThemeJobResponse>
+  p data # => <SfvbUpsellOffer>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->duplicate_sfvb_theme_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->disable_sfvb_upsell_offer_with_http_info: #{e}"
 end
 ```
 
@@ -658,12 +738,11 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **theme_oid** | **Integer** |  |  |
-| **duplicate_request** | [**SfvbThemeDuplicateRequest**](SfvbThemeDuplicateRequest.md) | Theme duplication details |  |
+| **upsell_offer_oid** | **Integer** |  |  |
 
 ### Return type
 
-[**SfvbThemeJobResponse**](SfvbThemeJobResponse.md)
+[**SfvbUpsellOffer**](SfvbUpsellOffer.md)
 
 ### Authorization
 
@@ -671,17 +750,17 @@ end
 
 ### HTTP request headers
 
-- **Content-Type**: application/json
+- **Content-Type**: Not defined
 - **Accept**: application/json
 
 
-## end_sfvb_experiment
+## disable_sfvb_upsell_path
 
-> <SfvbExperiment> end_sfvb_experiment(storefront_oid, experiment_oid, opts)
+> <SfvbUpsellPath> disable_sfvb_upsell_path(storefront_oid, upsell_path_oid)
 
-End an experiment
+Disable an upsell path
 
-Ends a running experiment.  With winner_variation_number the winner gets all new visitors, 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.  Visitors already assigned to a url experiment keep their page for up to 30 days.  Always needs sfvb_publish. 
+Switches the path off.  Disabling a running path is a live change and needs sfvb_publish.  A path that is already off is returned unchanged.  There is no delete. 
 
 
 ### Examples
@@ -690,21 +769,21 @@ Ends a running experiment.  With winner_variation_number the winner gets all new
 (No example for this operation).
 
 
-#### Using the end_sfvb_experiment_with_http_info variant
+#### Using the disable_sfvb_upsell_path_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbExperiment>, Integer, Hash)> end_sfvb_experiment_with_http_info(storefront_oid, experiment_oid, opts)
+> <Array(<SfvbUpsellPath>, Integer, Hash)> disable_sfvb_upsell_path_with_http_info(storefront_oid, upsell_path_oid)
 
 ```ruby
 begin
-  # End an experiment
-  data, status_code, headers = api_instance.end_sfvb_experiment_with_http_info(storefront_oid, experiment_oid, opts)
+  # Disable an upsell path
+  data, status_code, headers = api_instance.disable_sfvb_upsell_path_with_http_info(storefront_oid, upsell_path_oid)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbExperiment>
+  p data # => <SfvbUpsellPath>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->end_sfvb_experiment_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->disable_sfvb_upsell_path_with_http_info: #{e}"
 end
 ```
 
@@ -713,12 +792,11 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **experiment_oid** | **Integer** |  |  |
-| **experiment_end_request** | [**SfvbExperimentEndRequest**](SfvbExperimentEndRequest.md) | The winner, if any | [optional] |
+| **upsell_path_oid** | **Integer** |  |  |
 
 ### Return type
 
-[**SfvbExperiment**](SfvbExperiment.md)
+[**SfvbUpsellPath**](SfvbUpsellPath.md)
 
 ### Authorization
 
@@ -726,15 +804,17 @@ end
 
 ### HTTP request headers
 
-- **Content-Type**: application/json; charset=UTF-8
+- **Content-Type**: Not defined
 - **Accept**: application/json
 
 
-## get_sfvb_cjson_used_elements
+## download_sfvb_file
 
-> <SfvbElementsResponse> get_sfvb_cjson_used_elements(compile_request)
+> download_sfvb_file(storefront_oid, opts)
 
-Element types used by a container
+Read a storefront file's raw bytes
+
+Returns the file itself rather than a JSON envelope, for any type including binaries that files/content refuses.  Use this to verify what you uploaded, and note it is the only way to read a file inside a theme that is not active - such a file is served to nobody until the theme is promoted, so it has no public URL to fetch instead.  On success the body is the file; on failure it is the usual JSON error object, so do not assume the content type without checking the status. 
 
 
 ### Examples
@@ -743,21 +823,21 @@ Element types used by a container
 (No example for this operation).
 
 
-#### Using the get_sfvb_cjson_used_elements_with_http_info variant
+#### Using the download_sfvb_file_with_http_info variant
 
-This returns an Array which contains the response data, status code and headers.
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
 
-> <Array(<SfvbElementsResponse>, Integer, Hash)> get_sfvb_cjson_used_elements_with_http_info(compile_request)
+> <Array(nil, Integer, Hash)> download_sfvb_file_with_http_info(storefront_oid, opts)
 
 ```ruby
 begin
-  # Element types used by a container
-  data, status_code, headers = api_instance.get_sfvb_cjson_used_elements_with_http_info(compile_request)
+  # Read a storefront file's raw bytes
+  data, status_code, headers = api_instance.download_sfvb_file_with_http_info(storefront_oid, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbElementsResponse>
+  p data # => nil
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_cjson_used_elements_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->download_sfvb_file_with_http_info: #{e}"
 end
 ```
 
@@ -765,11 +845,12 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **compile_request** | [**SfvbCompileRequest**](SfvbCompileRequest.md) | CJSON to inspect |  |
+| **storefront_oid** | **Integer** |  |  |
+| **path** | **String** |  | [optional] |
 
 ### Return type
 
-[**SfvbElementsResponse**](SfvbElementsResponse.md)
+nil (empty response body)
 
 ### Authorization
 
@@ -777,17 +858,17 @@ end
 
 ### HTTP request headers
 
-- **Content-Type**: application/json
-- **Accept**: application/json
+- **Content-Type**: Not defined
+- **Accept**: application/octet-stream
 
 
-## get_sfvb_container
+## duplicate_sfvb_page
 
-> <SfvbContainerResponse> get_sfvb_container(storefront_oid, owner_type, owner_object_id, opts)
+> <SfvbPageResponse> duplicate_sfvb_page(storefront_oid, page_duplicate_request)
 
-Read a container stored outside the file system
+Copy a page to a new path
 
-owner_type is one of upsell, email, postcardfront, postcardback, item or itemid.  It also says how owner_object_id is read - item and upsell take an oid, itemid takes a merchant item id, and the rest take an esp uuid.  itemid reaches the same containers as item and is the way to address one from a storefront, where data-context-item-id carries the merchant item id and the oid appears nowhere.  Item containers also require container_name.  Theme and page containers are files; read those through files/content. 
+Copies what the store admin's duplicate copies - settings, items, blog posts, permissions, attributes, selectors, images and the page folder with its body.  The copy goes to the path you choose, under any existing page, with the same path rules as creating a page, and a 409 with the code sfvb.page_exists when that path is taken.  The root page and pages with pages under them cannot be copied.  A page whose folder holds a started experiment is refused, because the copy would share the experiment - end it first.  Translated title and description text is not copied.  Always needs sfvb_publish, because the copy is live as soon as it exists. 
 
 
 ### Examples
@@ -796,21 +877,21 @@ owner_type is one of upsell, email, postcardfront, postcardback, item or itemid.
 (No example for this operation).
 
 
-#### Using the get_sfvb_container_with_http_info variant
+#### Using the duplicate_sfvb_page_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbContainerResponse>, Integer, Hash)> get_sfvb_container_with_http_info(storefront_oid, owner_type, owner_object_id, opts)
+> <Array(<SfvbPageResponse>, Integer, Hash)> duplicate_sfvb_page_with_http_info(storefront_oid, page_duplicate_request)
 
 ```ruby
 begin
-  # Read a container stored outside the file system
-  data, status_code, headers = api_instance.get_sfvb_container_with_http_info(storefront_oid, owner_type, owner_object_id, opts)
+  # Copy a page to a new path
+  data, status_code, headers = api_instance.duplicate_sfvb_page_with_http_info(storefront_oid, page_duplicate_request)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbContainerResponse>
+  p data # => <SfvbPageResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_container_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->duplicate_sfvb_page_with_http_info: #{e}"
 end
 ```
 
@@ -819,13 +900,11 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **owner_type** | **String** |  |  |
-| **owner_object_id** | **String** |  |  |
-| **container_name** | **String** |  | [optional] |
+| **page_duplicate_request** | [**SfvbPageDuplicateRequest**](SfvbPageDuplicateRequest.md) | The page to copy and where |  |
 
 ### Return type
 
-[**SfvbContainerResponse**](SfvbContainerResponse.md)
+[**SfvbPageResponse**](SfvbPageResponse.md)
 
 ### Authorization
 
@@ -833,17 +912,17 @@ end
 
 ### HTTP request headers
 
-- **Content-Type**: Not defined
+- **Content-Type**: application/json; charset=UTF-8
 - **Accept**: application/json
 
 
-## get_sfvb_container_version
+## duplicate_sfvb_theme
 
-> <SfvbContainerVersion> get_sfvb_container_version(storefront_oid, container_history_oid, opts)
+> <SfvbThemeJobResponse> duplicate_sfvb_theme(storefront_oid, theme_oid, duplicate_request)
 
-Read the CJSON stored in one container history entry
+Duplicate a theme
 
-Inspect or diff an earlier version without reverting to it.  The version is addressed through the container that owns it, so a history oid belonging to some other resource cannot be read through this route.  owner_type also says how owner_object_id is read, and itemid addresses an item container by merchant item id. 
+Copies a theme into a new one and returns a job handle to poll.  Asynchronous, because copying a theme copies every file in it.  Needs sfvb_write rather than sfvb_publish, because the job explicitly does not activate what it creates, so the worst outcome of a mistaken call is a spare theme.  This is how you get somewhere safe to work - duplicate, edit the copy with an ordinary write scope, and let a human promote it. 
 
 
 ### Examples
@@ -852,21 +931,21 @@ Inspect or diff an earlier version without reverting to it.  The version is addr
 (No example for this operation).
 
 
-#### Using the get_sfvb_container_version_with_http_info variant
+#### Using the duplicate_sfvb_theme_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbContainerVersion>, Integer, Hash)> get_sfvb_container_version_with_http_info(storefront_oid, container_history_oid, opts)
+> <Array(<SfvbThemeJobResponse>, Integer, Hash)> duplicate_sfvb_theme_with_http_info(storefront_oid, theme_oid, duplicate_request)
 
 ```ruby
 begin
-  # Read the CJSON stored in one container history entry
-  data, status_code, headers = api_instance.get_sfvb_container_version_with_http_info(storefront_oid, container_history_oid, opts)
+  # Duplicate a theme
+  data, status_code, headers = api_instance.duplicate_sfvb_theme_with_http_info(storefront_oid, theme_oid, duplicate_request)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbContainerVersion>
+  p data # => <SfvbThemeJobResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_container_version_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->duplicate_sfvb_theme_with_http_info: #{e}"
 end
 ```
 
@@ -875,14 +954,12 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **container_history_oid** | **Integer** |  |  |
-| **owner_type** | **String** |  | [optional] |
-| **owner_object_id** | **String** |  | [optional] |
-| **container_name** | **String** |  | [optional] |
+| **theme_oid** | **Integer** |  |  |
+| **duplicate_request** | [**SfvbThemeDuplicateRequest**](SfvbThemeDuplicateRequest.md) | Theme duplication details |  |
 
 ### Return type
 
-[**SfvbContainerVersion**](SfvbContainerVersion.md)
+[**SfvbThemeJobResponse**](SfvbThemeJobResponse.md)
 
 ### Authorization
 
@@ -890,17 +967,17 @@ end
 
 ### HTTP request headers
 
-- **Content-Type**: Not defined
+- **Content-Type**: application/json
 - **Accept**: application/json
 
 
-## get_sfvb_element
+## duplicate_sfvb_upsell_offer
 
-> <SfvbElementSchemaResponse> get_sfvb_element(element_type)
+> <SfvbUpsellOffer> duplicate_sfvb_upsell_offer(storefront_oid, upsell_offer_oid)
 
-Configuration schema and field card for one element type
+Duplicate an upsell offer
 
-schema is the draft-07 JSON schema for the element config object and doc is the markdown field card, both as strings.  Either is omitted when none has been published for the element, which is still a 200.  The catalog is published by the visual builder release process, and a republish can take up to an hour to appear here. 
+A copy named Copy of, switched off, with its own copy of the container.  Put it on a path with a path update to have it shown. 
 
 
 ### Examples
@@ -909,21 +986,21 @@ schema is the draft-07 JSON schema for the element config object and doc is the
 (No example for this operation).
 
 
-#### Using the get_sfvb_element_with_http_info variant
+#### Using the duplicate_sfvb_upsell_offer_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbElementSchemaResponse>, Integer, Hash)> get_sfvb_element_with_http_info(element_type)
+> <Array(<SfvbUpsellOffer>, Integer, Hash)> duplicate_sfvb_upsell_offer_with_http_info(storefront_oid, upsell_offer_oid)
 
 ```ruby
 begin
-  # Configuration schema and field card for one element type
-  data, status_code, headers = api_instance.get_sfvb_element_with_http_info(element_type)
+  # Duplicate an upsell offer
+  data, status_code, headers = api_instance.duplicate_sfvb_upsell_offer_with_http_info(storefront_oid, upsell_offer_oid)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbElementSchemaResponse>
+  p data # => <SfvbUpsellOffer>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_element_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->duplicate_sfvb_upsell_offer_with_http_info: #{e}"
 end
 ```
 
@@ -931,11 +1008,12 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **element_type** | **String** |  |  |
+| **storefront_oid** | **Integer** |  |  |
+| **upsell_offer_oid** | **Integer** |  |  |
 
 ### Return type
 
-[**SfvbElementSchemaResponse**](SfvbElementSchemaResponse.md)
+[**SfvbUpsellOffer**](SfvbUpsellOffer.md)
 
 ### Authorization
 
@@ -947,13 +1025,13 @@ end
 - **Accept**: application/json
 
 
-## get_sfvb_experiment
+## duplicate_sfvb_upsell_path
 
-> <SfvbExperiment> get_sfvb_experiment(storefront_oid, experiment_oid, opts)
+> <SfvbUpsellPath> duplicate_sfvb_upsell_path(storefront_oid, upsell_path_oid, opts)
 
-Read one experiment and its statistics
+Duplicate an upsell path or one of its variations
 
-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. 
+Without a variation, copies the whole path right after it, switched off.  With a variation, appends a copy of that variation to the same path, which needs sfvb_publish when the path is running.  Every offer the copy uses is copied too and switched off.  Within this storefront only. 
 
 
 ### Examples
@@ -962,21 +1040,21 @@ The experiment, its variations and their statistics, and with daily=true each va
 (No example for this operation).
 
 
-#### Using the get_sfvb_experiment_with_http_info variant
+#### Using the duplicate_sfvb_upsell_path_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbExperiment>, Integer, Hash)> get_sfvb_experiment_with_http_info(storefront_oid, experiment_oid, opts)
+> <Array(<SfvbUpsellPath>, Integer, Hash)> duplicate_sfvb_upsell_path_with_http_info(storefront_oid, upsell_path_oid, opts)
 
 ```ruby
 begin
-  # Read one experiment and its statistics
-  data, status_code, headers = api_instance.get_sfvb_experiment_with_http_info(storefront_oid, experiment_oid, opts)
+  # Duplicate an upsell path or one of its variations
+  data, status_code, headers = api_instance.duplicate_sfvb_upsell_path_with_http_info(storefront_oid, upsell_path_oid, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbExperiment>
+  p data # => <SfvbUpsellPath>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_experiment_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->duplicate_sfvb_upsell_path_with_http_info: #{e}"
 end
 ```
 
@@ -985,12 +1063,12 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **experiment_oid** | **Integer** |  |  |
-| **daily** | **Boolean** | Include each variation&#39;s daily statistics | [optional] |
+| **upsell_path_oid** | **Integer** |  |  |
+| **duplicate_request** | [**SfvbUpsellPathDuplicateRequest**](SfvbUpsellPathDuplicateRequest.md) | What to duplicate | [optional] |
 
 ### Return type
 
-[**SfvbExperiment**](SfvbExperiment.md)
+[**SfvbUpsellPath**](SfvbUpsellPath.md)
 
 ### Authorization
 
@@ -998,17 +1076,17 @@ end
 
 ### HTTP request headers
 
-- **Content-Type**: Not defined
+- **Content-Type**: application/json; charset=UTF-8
 - **Accept**: application/json
 
 
-## get_sfvb_experiment_objectives
+## end_sfvb_experiment
 
-> <SfvbExperimentObjectivesResponse> get_sfvb_experiment_objectives(storefront_oid)
+> <SfvbExperiment> end_sfvb_experiment(storefront_oid, experiment_oid, opts)
 
-List the objectives an experiment can optimize
+End an experiment
 
-Each objective with what is measured per session and compared between variations, the usual optimization type, and whether it needs an event name. 
+Ends a running experiment.  With winner_variation_number the winner gets all new visitors, 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.  Visitors already assigned to a url experiment keep their page for up to 30 days.  Always needs sfvb_publish. 
 
 
 ### Examples
@@ -1017,21 +1095,21 @@ Each objective with what is measured per session and compared between variations
 (No example for this operation).
 
 
-#### Using the get_sfvb_experiment_objectives_with_http_info variant
+#### Using the end_sfvb_experiment_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbExperimentObjectivesResponse>, Integer, Hash)> get_sfvb_experiment_objectives_with_http_info(storefront_oid)
+> <Array(<SfvbExperiment>, Integer, Hash)> end_sfvb_experiment_with_http_info(storefront_oid, experiment_oid, opts)
 
 ```ruby
 begin
-  # List the objectives an experiment can optimize
-  data, status_code, headers = api_instance.get_sfvb_experiment_objectives_with_http_info(storefront_oid)
+  # End an experiment
+  data, status_code, headers = api_instance.end_sfvb_experiment_with_http_info(storefront_oid, experiment_oid, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbExperimentObjectivesResponse>
+  p data # => <SfvbExperiment>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_experiment_objectives_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->end_sfvb_experiment_with_http_info: #{e}"
 end
 ```
 
@@ -1040,10 +1118,12 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
+| **experiment_oid** | **Integer** |  |  |
+| **experiment_end_request** | [**SfvbExperimentEndRequest**](SfvbExperimentEndRequest.md) | The winner, if any | [optional] |
 
 ### Return type
 
-[**SfvbExperimentObjectivesResponse**](SfvbExperimentObjectivesResponse.md)
+[**SfvbExperiment**](SfvbExperiment.md)
 
 ### Authorization
 
@@ -1051,17 +1131,15 @@ end
 
 ### HTTP request headers
 
-- **Content-Type**: Not defined
+- **Content-Type**: application/json; charset=UTF-8
 - **Accept**: application/json
 
 
-## get_sfvb_file_content
-
-> <SfvbFileContentResponse> get_sfvb_file_content(storefront_oid, opts)
+## get_sfvb_cjson_used_elements
 
-Read a storefront file
+> <SfvbElementsResponse> get_sfvb_cjson_used_elements(compile_request)
 
-Returns the current content, or an earlier version when version is supplied.  Send the body's hash_sha256 back as If-Match when writing.  The ETag header carries the same hash, but a compressing proxy may append a suffix such as -gzip to it, so prefer the body value. 
+Element types used by a container
 
 
 ### Examples
@@ -1070,21 +1148,21 @@ Returns the current content, or an earlier version when version is supplied.  Se
 (No example for this operation).
 
 
-#### Using the get_sfvb_file_content_with_http_info variant
+#### Using the get_sfvb_cjson_used_elements_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbFileContentResponse>, Integer, Hash)> get_sfvb_file_content_with_http_info(storefront_oid, opts)
+> <Array(<SfvbElementsResponse>, Integer, Hash)> get_sfvb_cjson_used_elements_with_http_info(compile_request)
 
 ```ruby
 begin
-  # Read a storefront file
-  data, status_code, headers = api_instance.get_sfvb_file_content_with_http_info(storefront_oid, opts)
+  # Element types used by a container
+  data, status_code, headers = api_instance.get_sfvb_cjson_used_elements_with_http_info(compile_request)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbFileContentResponse>
+  p data # => <SfvbElementsResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_file_content_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->get_sfvb_cjson_used_elements_with_http_info: #{e}"
 end
 ```
 
@@ -1092,13 +1170,11 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **storefront_oid** | **Integer** |  |  |
-| **path** | **String** |  | [optional] |
-| **version** | **Integer** |  | [optional] |
+| **compile_request** | [**SfvbCompileRequest**](SfvbCompileRequest.md) | CJSON to inspect |  |
 
 ### Return type
 
-[**SfvbFileContentResponse**](SfvbFileContentResponse.md)
+[**SfvbElementsResponse**](SfvbElementsResponse.md)
 
 ### Authorization
 
@@ -1106,17 +1182,17 @@ end
 
 ### HTTP request headers
 
-- **Content-Type**: Not defined
+- **Content-Type**: application/json
 - **Accept**: application/json
 
 
-## get_sfvb_file_upload_url
+## get_sfvb_container
 
-> <SfvbFileUploadUrlResponse> get_sfvb_file_upload_url(storefront_oid, extension)
+> <SfvbContainerResponse> get_sfvb_container(storefront_oid, owner_type, owner_object_id, opts)
 
-Get a URL to upload a binary asset to
+Read a container stored outside the file system
 
-Binary content does not travel through this API as JSON, so uploading an image, font, video or PDF is two steps.  Ask here for a URL, PUT the raw bytes straight to it, then call uploadSfvbFile quoting the key you were given.  The bytes never pass through the API server.  The extension is checked against the accepted type list before a URL is issued, so an unsupported type fails here rather than after you have sent the file.  The URL is short lived and the key is bound to your account. 
+owner_type is one of upsell, email, postcardfront, postcardback, item or itemid.  It also says how owner_object_id is read - item and upsell take an oid, itemid takes a merchant item id, and the rest take an esp uuid.  itemid reaches the same containers as item and is the way to address one from a storefront, where data-context-item-id carries the merchant item id and the oid appears nowhere.  Item containers also require container_name.  Theme and page containers are files; read those through files/content. 
 
 
 ### Examples
@@ -1125,21 +1201,21 @@ Binary content does not travel through this API as JSON, so uploading an image,
 (No example for this operation).
 
 
-#### Using the get_sfvb_file_upload_url_with_http_info variant
+#### Using the get_sfvb_container_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbFileUploadUrlResponse>, Integer, Hash)> get_sfvb_file_upload_url_with_http_info(storefront_oid, extension)
+> <Array(<SfvbContainerResponse>, Integer, Hash)> get_sfvb_container_with_http_info(storefront_oid, owner_type, owner_object_id, opts)
 
 ```ruby
 begin
-  # Get a URL to upload a binary asset to
-  data, status_code, headers = api_instance.get_sfvb_file_upload_url_with_http_info(storefront_oid, extension)
+  # Read a container stored outside the file system
+  data, status_code, headers = api_instance.get_sfvb_container_with_http_info(storefront_oid, owner_type, owner_object_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbFileUploadUrlResponse>
+  p data # => <SfvbContainerResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_file_upload_url_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->get_sfvb_container_with_http_info: #{e}"
 end
 ```
 
@@ -1148,11 +1224,13 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **extension** | **String** |  |  |
+| **owner_type** | **String** |  |  |
+| **owner_object_id** | **String** |  |  |
+| **container_name** | **String** |  | [optional] |
 
 ### Return type
 
-[**SfvbFileUploadUrlResponse**](SfvbFileUploadUrlResponse.md)
+[**SfvbContainerResponse**](SfvbContainerResponse.md)
 
 ### Authorization
 
@@ -1164,13 +1242,13 @@ end
 - **Accept**: application/json
 
 
-## get_sfvb_library_entry
+## get_sfvb_container_version
 
-> <SfvbLibraryEntry> get_sfvb_library_entry(storefront_oid, library_oid)
+> <SfvbContainerVersion> get_sfvb_container_version(storefront_oid, container_history_oid, opts)
 
-Read one library entry including its CJSON
+Read the CJSON stored in one container history entry
 
-Returns the fragment as authored.  If it references images or other storefront files those paths will not resolve on this storefront until the entry is installed, so use install rather than this when the intent is to place the fragment. 
+Inspect or diff an earlier version without reverting to it.  The version is addressed through the container that owns it, so a history oid belonging to some other resource cannot be read through this route.  owner_type also says how owner_object_id is read, and itemid addresses an item container by merchant item id. 
 
 
 ### Examples
@@ -1179,21 +1257,21 @@ Returns the fragment as authored.  If it references images or other storefront f
 (No example for this operation).
 
 
-#### Using the get_sfvb_library_entry_with_http_info variant
+#### Using the get_sfvb_container_version_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbLibraryEntry>, Integer, Hash)> get_sfvb_library_entry_with_http_info(storefront_oid, library_oid)
+> <Array(<SfvbContainerVersion>, Integer, Hash)> get_sfvb_container_version_with_http_info(storefront_oid, container_history_oid, opts)
 
 ```ruby
 begin
-  # Read one library entry including its CJSON
-  data, status_code, headers = api_instance.get_sfvb_library_entry_with_http_info(storefront_oid, library_oid)
+  # Read the CJSON stored in one container history entry
+  data, status_code, headers = api_instance.get_sfvb_container_version_with_http_info(storefront_oid, container_history_oid, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbLibraryEntry>
+  p data # => <SfvbContainerVersion>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_library_entry_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->get_sfvb_container_version_with_http_info: #{e}"
 end
 ```
 
@@ -1202,11 +1280,14 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **library_oid** | **Integer** |  |  |
+| **container_history_oid** | **Integer** |  |  |
+| **owner_type** | **String** |  | [optional] |
+| **owner_object_id** | **String** |  | [optional] |
+| **container_name** | **String** |  | [optional] |
 
 ### Return type
 
-[**SfvbLibraryEntry**](SfvbLibraryEntry.md)
+[**SfvbContainerVersion**](SfvbContainerVersion.md)
 
 ### Authorization
 
@@ -1218,13 +1299,13 @@ end
 - **Accept**: application/json
 
 
-## get_sfvb_menu
+## get_sfvb_element
 
-> <SfvbMenu> get_sfvb_menu(storefront_oid, code)
+> <SfvbElementSchemaResponse> get_sfvb_element(element_type)
 
-Read one store menu and its entries
+Configuration schema and field card for one element type
 
-The whole tree, in render order.  Page entries carry the page_path they resolve to and item entries the merchant_item_id, rather than the oids the storage keeps.  Menu item oids are not returned at all because a write regenerates every one of them.  Keep hash_sha256 - it is the If-Match a write needs. 
+schema is the draft-07 JSON schema for the element config object and doc is the markdown field card, both as strings.  Either is omitted when none has been published for the element, which is still a 200.  The catalog is published by the visual builder release process, and a republish can take up to an hour to appear here. 
 
 
 ### Examples
@@ -1233,21 +1314,21 @@ The whole tree, in render order.  Page entries carry the page_path they resolve
 (No example for this operation).
 
 
-#### Using the get_sfvb_menu_with_http_info variant
+#### Using the get_sfvb_element_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbMenu>, Integer, Hash)> get_sfvb_menu_with_http_info(storefront_oid, code)
+> <Array(<SfvbElementSchemaResponse>, Integer, Hash)> get_sfvb_element_with_http_info(element_type)
 
 ```ruby
 begin
-  # Read one store menu and its entries
-  data, status_code, headers = api_instance.get_sfvb_menu_with_http_info(storefront_oid, code)
+  # Configuration schema and field card for one element type
+  data, status_code, headers = api_instance.get_sfvb_element_with_http_info(element_type)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbMenu>
+  p data # => <SfvbElementSchemaResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_menu_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->get_sfvb_element_with_http_info: #{e}"
 end
 ```
 
@@ -1255,12 +1336,11 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **storefront_oid** | **Integer** |  |  |
-| **code** | **String** | Menu code, matched without regard to case |  |
+| **element_type** | **String** |  |  |
 
 ### Return type
 
-[**SfvbMenu**](SfvbMenu.md)
+[**SfvbElementSchemaResponse**](SfvbElementSchemaResponse.md)
 
 ### Authorization
 
@@ -1272,13 +1352,13 @@ end
 - **Accept**: application/json
 
 
-## get_sfvb_menus
+## get_sfvb_experiment
 
-> <SfvbMenusResponse> get_sfvb_menus(storefront_oid)
+> <SfvbExperiment> get_sfvb_experiment(storefront_oid, experiment_oid, opts)
 
-List a storefront's store menus
+Read one experiment and its statistics
 
-The menus a menu element's menuName can name, sorted by code and without their entries.  A code the active theme's templates ask for but nothing has created is included with unconfigured true - that code renders an empty list today, and writing it creates it.  A menu no template names is marked undeclared, which usually means a menuName is misspelled. 
+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. 
 
 
 ### Examples
@@ -1287,21 +1367,21 @@ The menus a menu element's menuName can name, sorted by code and without their e
 (No example for this operation).
 
 
-#### Using the get_sfvb_menus_with_http_info variant
+#### Using the get_sfvb_experiment_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbMenusResponse>, Integer, Hash)> get_sfvb_menus_with_http_info(storefront_oid)
+> <Array(<SfvbExperiment>, Integer, Hash)> get_sfvb_experiment_with_http_info(storefront_oid, experiment_oid, opts)
 
 ```ruby
 begin
-  # List a storefront's store menus
-  data, status_code, headers = api_instance.get_sfvb_menus_with_http_info(storefront_oid)
+  # Read one experiment and its statistics
+  data, status_code, headers = api_instance.get_sfvb_experiment_with_http_info(storefront_oid, experiment_oid, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbMenusResponse>
+  p data # => <SfvbExperiment>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_menus_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->get_sfvb_experiment_with_http_info: #{e}"
 end
 ```
 
@@ -1310,10 +1390,12 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
+| **experiment_oid** | **Integer** |  |  |
+| **daily** | **Boolean** | Include each variation&#39;s daily statistics | [optional] |
 
 ### Return type
 
-[**SfvbMenusResponse**](SfvbMenusResponse.md)
+[**SfvbExperiment**](SfvbExperiment.md)
 
 ### Authorization
 
@@ -1325,13 +1407,13 @@ end
 - **Accept**: application/json
 
 
-## get_sfvb_page
+## get_sfvb_experiment_objectives
 
-> <SfvbPageResponse> get_sfvb_page(storefront_oid, path)
+> <SfvbExperimentObjectivesResponse> get_sfvb_experiment_objectives(storefront_oid)
 
-Read a page's attributes and images
+List the objectives an experiment can optimize
 
-What the pageattribute and pageimage elements render for this page.  These are not in any file, which is why a page folder can be empty and its elements still render something.  Attributes and image codes a template declares but nothing has set are included, so the response describes what the page can show rather than only what has been saved. 
+Each objective with what is measured per session and compared between variations, the usual optimization type, and whether it needs an event name. 
 
 
 ### Examples
@@ -1340,21 +1422,21 @@ What the pageattribute and pageimage elements render for this page.  These are n
 (No example for this operation).
 
 
-#### Using the get_sfvb_page_with_http_info variant
+#### Using the get_sfvb_experiment_objectives_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbPageResponse>, Integer, Hash)> get_sfvb_page_with_http_info(storefront_oid, path)
+> <Array(<SfvbExperimentObjectivesResponse>, Integer, Hash)> get_sfvb_experiment_objectives_with_http_info(storefront_oid)
 
 ```ruby
 begin
-  # Read a page's attributes and images
-  data, status_code, headers = api_instance.get_sfvb_page_with_http_info(storefront_oid, path)
+  # List the objectives an experiment can optimize
+  data, status_code, headers = api_instance.get_sfvb_experiment_objectives_with_http_info(storefront_oid)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbPageResponse>
+  p data # => <SfvbExperimentObjectivesResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_page_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->get_sfvb_experiment_objectives_with_http_info: #{e}"
 end
 ```
 
@@ -1363,11 +1445,10 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **path** | **String** | Page path, for example /catalog/dispensers/ |  |
 
 ### Return type
 
-[**SfvbPageResponse**](SfvbPageResponse.md)
+[**SfvbExperimentObjectivesResponse**](SfvbExperimentObjectivesResponse.md)
 
 ### Authorization
 
@@ -1379,13 +1460,13 @@ end
 - **Accept**: application/json
 
 
-## get_sfvb_page_blog_posts
+## get_sfvb_file_content
 
-> <SfvbPageBlogPostsResponse> get_sfvb_page_blog_posts(storefront_oid, path)
+> <SfvbFileContentResponse> get_sfvb_file_content(storefront_oid, opts)
 
-Read the blog posts assigned to a page
+Read a storefront file
 
-The posts the page shows.  uses_selectors is true when the page's blog post selectors choose them instead. 
+Returns the current content, or an earlier version when version is supplied.  Send the body's hash_sha256 back as If-Match when writing.  The ETag header carries the same hash, but a compressing proxy may append a suffix such as -gzip to it, so prefer the body value. 
 
 
 ### Examples
@@ -1394,21 +1475,21 @@ The posts the page shows.  uses_selectors is true when the page's blog post sele
 (No example for this operation).
 
 
-#### Using the get_sfvb_page_blog_posts_with_http_info variant
+#### Using the get_sfvb_file_content_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbPageBlogPostsResponse>, Integer, Hash)> get_sfvb_page_blog_posts_with_http_info(storefront_oid, path)
+> <Array(<SfvbFileContentResponse>, Integer, Hash)> get_sfvb_file_content_with_http_info(storefront_oid, opts)
 
 ```ruby
 begin
-  # Read the blog posts assigned to a page
-  data, status_code, headers = api_instance.get_sfvb_page_blog_posts_with_http_info(storefront_oid, path)
+  # Read a storefront file
+  data, status_code, headers = api_instance.get_sfvb_file_content_with_http_info(storefront_oid, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbPageBlogPostsResponse>
+  p data # => <SfvbFileContentResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_page_blog_posts_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->get_sfvb_file_content_with_http_info: #{e}"
 end
 ```
 
@@ -1417,11 +1498,12 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **path** | **String** | Page path, for example /blog/ |  |
+| **path** | **String** |  | [optional] |
+| **version** | **Integer** |  | [optional] |
 
 ### Return type
 
-[**SfvbPageBlogPostsResponse**](SfvbPageBlogPostsResponse.md)
+[**SfvbFileContentResponse**](SfvbFileContentResponse.md)
 
 ### Authorization
 
@@ -1433,13 +1515,13 @@ end
 - **Accept**: application/json
 
 
-## get_sfvb_page_items
+## get_sfvb_file_upload_url
 
-> <SfvbPageItemsResponse> get_sfvb_page_items(storefront_oid, path)
+> <SfvbFileUploadUrlResponse> get_sfvb_file_upload_url(storefront_oid, extension)
 
-Read the items assigned to a page
+Get a URL to upload a binary asset to
 
-The items on the page with their sort order and url part.  uses_selectors is true when the page's selectors choose its items instead. 
+Binary content does not travel through this API as JSON, so uploading an image, font, video or PDF is two steps.  Ask here for a URL, PUT the raw bytes straight to it, then call uploadSfvbFile quoting the key you were given.  The bytes never pass through the API server.  The extension is checked against the accepted type list before a URL is issued, so an unsupported type fails here rather than after you have sent the file.  The URL is short lived and the key is bound to your account. 
 
 
 ### Examples
@@ -1448,21 +1530,21 @@ The items on the page with their sort order and url part.  uses_selectors is tru
 (No example for this operation).
 
 
-#### Using the get_sfvb_page_items_with_http_info variant
+#### Using the get_sfvb_file_upload_url_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbPageItemsResponse>, Integer, Hash)> get_sfvb_page_items_with_http_info(storefront_oid, path)
+> <Array(<SfvbFileUploadUrlResponse>, Integer, Hash)> get_sfvb_file_upload_url_with_http_info(storefront_oid, extension)
 
 ```ruby
 begin
-  # Read the items assigned to a page
-  data, status_code, headers = api_instance.get_sfvb_page_items_with_http_info(storefront_oid, path)
+  # Get a URL to upload a binary asset to
+  data, status_code, headers = api_instance.get_sfvb_file_upload_url_with_http_info(storefront_oid, extension)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbPageItemsResponse>
+  p data # => <SfvbFileUploadUrlResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_page_items_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->get_sfvb_file_upload_url_with_http_info: #{e}"
 end
 ```
 
@@ -1471,11 +1553,11 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **path** | **String** | Page path, for example /lp/spring-sale/ |  |
+| **extension** | **String** |  |  |
 
 ### Return type
 
-[**SfvbPageItemsResponse**](SfvbPageItemsResponse.md)
+[**SfvbFileUploadUrlResponse**](SfvbFileUploadUrlResponse.md)
 
 ### Authorization
 
@@ -1487,13 +1569,13 @@ end
 - **Accept**: application/json
 
 
-## get_sfvb_page_selectors
+## get_sfvb_item
 
-> <SfvbPageSelectors> get_sfvb_page_selectors(storefront_oid, path)
+> <SfvbItemResponse> get_sfvb_item(storefront_oid, opts)
 
-Read a page's selectors
+Read an item's storefront facing content
 
-The conditions that choose the page's items and blog posts, and whether each set must all match. 
+The attributes, images, title, description and search metadata a StoreFront element can render, reconciled against the templates behind the pages this item sits on.  An attribute a template declares but nothing has set comes back present with an empty value, which is how you discover what the page is asking for.  Pricing, shipping, inventory, tax, variants and kit structure are not here because no element reads them; use the item API for those.  Address by merchant_item_id, the value data-context-item-id carries, or by merchant_item_oid. 
 
 
 ### Examples
@@ -1502,21 +1584,21 @@ The conditions that choose the page's items and blog posts, and whether each set
 (No example for this operation).
 
 
-#### Using the get_sfvb_page_selectors_with_http_info variant
+#### Using the get_sfvb_item_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbPageSelectors>, Integer, Hash)> get_sfvb_page_selectors_with_http_info(storefront_oid, path)
+> <Array(<SfvbItemResponse>, Integer, Hash)> get_sfvb_item_with_http_info(storefront_oid, opts)
 
 ```ruby
 begin
-  # Read a page's selectors
-  data, status_code, headers = api_instance.get_sfvb_page_selectors_with_http_info(storefront_oid, path)
+  # Read an item's storefront facing content
+  data, status_code, headers = api_instance.get_sfvb_item_with_http_info(storefront_oid, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbPageSelectors>
+  p data # => <SfvbItemResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_page_selectors_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->get_sfvb_item_with_http_info: #{e}"
 end
 ```
 
@@ -1525,11 +1607,12 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **path** | **String** | Page path, for example /lp/spring-sale/ |  |
+| **merchant_item_id** | **String** | The merchant item id, as a storefront carries it | [optional] |
+| **merchant_item_oid** | **Integer** | The item oid.  Send this or merchant_item_id, not both | [optional] |
 
 ### Return type
 
-[**SfvbPageSelectors**](SfvbPageSelectors.md)
+[**SfvbItemResponse**](SfvbItemResponse.md)
 
 ### Authorization
 
@@ -1541,13 +1624,13 @@ end
 - **Accept**: application/json
 
 
-## get_sfvb_preview_url
+## get_sfvb_library_entry
 
-> <SfvbPreviewUrlResponse> get_sfvb_preview_url(storefront_oid, preview_session_id, opts)
+> <SfvbLibraryEntry> get_sfvb_library_entry(storefront_oid, library_oid)
 
-URL that renders a preview session
+Read one library entry including its CJSON
 
-Refuses a session that does not exist, so a URL you receive is for a session that was really there.  expires_in_seconds is the time actually remaining, not the configured lifetime.  Needs a token that resolves to a user, because a preview session belongs to the person who created it. 
+Returns the fragment as authored.  If it references images or other storefront files those paths will not resolve on this storefront until the entry is installed, so use install rather than this when the intent is to place the fragment. 
 
 
 ### Examples
@@ -1556,21 +1639,21 @@ Refuses a session that does not exist, so a URL you receive is for a session tha
 (No example for this operation).
 
 
-#### Using the get_sfvb_preview_url_with_http_info variant
+#### Using the get_sfvb_library_entry_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbPreviewUrlResponse>, Integer, Hash)> get_sfvb_preview_url_with_http_info(storefront_oid, preview_session_id, opts)
+> <Array(<SfvbLibraryEntry>, Integer, Hash)> get_sfvb_library_entry_with_http_info(storefront_oid, library_oid)
 
 ```ruby
 begin
-  # URL that renders a preview session
-  data, status_code, headers = api_instance.get_sfvb_preview_url_with_http_info(storefront_oid, preview_session_id, opts)
+  # Read one library entry including its CJSON
+  data, status_code, headers = api_instance.get_sfvb_library_entry_with_http_info(storefront_oid, library_oid)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbPreviewUrlResponse>
+  p data # => <SfvbLibraryEntry>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_preview_url_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->get_sfvb_library_entry_with_http_info: #{e}"
 end
 ```
 
@@ -1579,12 +1662,11 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **preview_session_id** | **String** |  |  |
-| **path** | **String** |  | [optional] |
+| **library_oid** | **Integer** |  |  |
 
 ### Return type
 
-[**SfvbPreviewUrlResponse**](SfvbPreviewUrlResponse.md)
+[**SfvbLibraryEntry**](SfvbLibraryEntry.md)
 
 ### Authorization
 
@@ -1596,13 +1678,13 @@ end
 - **Accept**: application/json
 
 
-## get_sfvb_site_attributes
+## get_sfvb_menu
 
-> <SfvbSiteAttributesResponse> get_sfvb_site_attributes(storefront_oid)
+> <SfvbMenu> get_sfvb_menu(storefront_oid, code)
 
-Read a storefront's site attributes
+Read one store menu and its entries
 
-The values the siteattribute element and $site.attr render.  These are not in any file or theme.  Attributes a template declares but nothing has set are included with the template's default, so the response describes what the templates can render rather than only what has been saved.  Credentials stored as site attributes are never included. 
+The whole tree, in render order.  Page entries carry the page_path they resolve to and item entries the merchant_item_id, rather than the oids the storage keeps.  Menu item oids are not returned at all because a write regenerates every one of them.  Keep hash_sha256 - it is the If-Match a write needs. 
 
 
 ### Examples
@@ -1611,21 +1693,21 @@ The values the siteattribute element and $site.attr render.  These are not in an
 (No example for this operation).
 
 
-#### Using the get_sfvb_site_attributes_with_http_info variant
+#### Using the get_sfvb_menu_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbSiteAttributesResponse>, Integer, Hash)> get_sfvb_site_attributes_with_http_info(storefront_oid)
+> <Array(<SfvbMenu>, Integer, Hash)> get_sfvb_menu_with_http_info(storefront_oid, code)
 
 ```ruby
 begin
-  # Read a storefront's site attributes
-  data, status_code, headers = api_instance.get_sfvb_site_attributes_with_http_info(storefront_oid)
+  # Read one store menu and its entries
+  data, status_code, headers = api_instance.get_sfvb_menu_with_http_info(storefront_oid, code)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbSiteAttributesResponse>
+  p data # => <SfvbMenu>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_site_attributes_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->get_sfvb_menu_with_http_info: #{e}"
 end
 ```
 
@@ -1634,10 +1716,11 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
+| **code** | **String** | Menu code, matched without regard to case |  |
 
 ### Return type
 
-[**SfvbSiteAttributesResponse**](SfvbSiteAttributesResponse.md)
+[**SfvbMenu**](SfvbMenu.md)
 
 ### Authorization
 
@@ -1649,11 +1732,13 @@ end
 - **Accept**: application/json
 
 
-## get_sfvb_theme
+## get_sfvb_menus
 
-> <SfvbTheme> get_sfvb_theme(storefront_oid, theme_oid)
+> <SfvbMenusResponse> get_sfvb_menus(storefront_oid)
 
-Get a theme
+List a storefront's store menus
+
+The menus a menu element's menuName can name, sorted by code and without their entries.  A code the active theme's templates ask for but nothing has created is included with unconfigured true - that code renders an empty list today, and writing it creates it.  A menu no template names is marked undeclared, which usually means a menuName is misspelled. 
 
 
 ### Examples
@@ -1662,21 +1747,21 @@ Get a theme
 (No example for this operation).
 
 
-#### Using the get_sfvb_theme_with_http_info variant
+#### Using the get_sfvb_menus_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbTheme>, Integer, Hash)> get_sfvb_theme_with_http_info(storefront_oid, theme_oid)
+> <Array(<SfvbMenusResponse>, Integer, Hash)> get_sfvb_menus_with_http_info(storefront_oid)
 
 ```ruby
 begin
-  # Get a theme
-  data, status_code, headers = api_instance.get_sfvb_theme_with_http_info(storefront_oid, theme_oid)
+  # List a storefront's store menus
+  data, status_code, headers = api_instance.get_sfvb_menus_with_http_info(storefront_oid)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbTheme>
+  p data # => <SfvbMenusResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_theme_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->get_sfvb_menus_with_http_info: #{e}"
 end
 ```
 
@@ -1685,11 +1770,10 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **theme_oid** | **Integer** |  |  |
 
 ### Return type
 
-[**SfvbTheme**](SfvbTheme.md)
+[**SfvbMenusResponse**](SfvbMenusResponse.md)
 
 ### Authorization
 
@@ -1701,13 +1785,13 @@ end
 - **Accept**: application/json
 
 
-## get_sfvb_theme_attributes
+## get_sfvb_page
 
-> <SfvbThemeAttributesResponse> get_sfvb_theme_attributes(storefront_oid, theme_oid)
+> <SfvbPageResponse> get_sfvb_page(storefront_oid, path)
 
-Read a theme's colors, fonts and settings
+Read a page's attributes and images
 
-The values theme.css and the compiled containers resolve at render time.  These do NOT live in any file.  settings.json contains a palette and looks like the answer, but it is the theme's factory template - it supplies defaults for slots that have never been set and is ignored for slots that have, so editing it will not change a color and reading it will not tell you the current one.  Slots a template declares but nothing has ever set are included here, carrying the default they will render with, so the response describes the whole theme rather than the rows that happen to exist. 
+What the pageattribute and pageimage elements render for this page.  These are not in any file, which is why a page folder can be empty and its elements still render something.  Attributes and image codes a template declares but nothing has set are included, so the response describes what the page can show rather than only what has been saved. 
 
 
 ### Examples
@@ -1716,21 +1800,21 @@ The values theme.css and the compiled containers resolve at render time.  These
 (No example for this operation).
 
 
-#### Using the get_sfvb_theme_attributes_with_http_info variant
+#### Using the get_sfvb_page_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbThemeAttributesResponse>, Integer, Hash)> get_sfvb_theme_attributes_with_http_info(storefront_oid, theme_oid)
+> <Array(<SfvbPageResponse>, Integer, Hash)> get_sfvb_page_with_http_info(storefront_oid, path)
 
 ```ruby
 begin
-  # Read a theme's colors, fonts and settings
-  data, status_code, headers = api_instance.get_sfvb_theme_attributes_with_http_info(storefront_oid, theme_oid)
+  # Read a page's attributes and images
+  data, status_code, headers = api_instance.get_sfvb_page_with_http_info(storefront_oid, path)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbThemeAttributesResponse>
+  p data # => <SfvbPageResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_theme_attributes_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->get_sfvb_page_with_http_info: #{e}"
 end
 ```
 
@@ -1739,11 +1823,11 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **theme_oid** | **Integer** |  |  |
+| **path** | **String** | Page path, for example /catalog/dispensers/ |  |
 
 ### Return type
 
-[**SfvbThemeAttributesResponse**](SfvbThemeAttributesResponse.md)
+[**SfvbPageResponse**](SfvbPageResponse.md)
 
 ### Authorization
 
@@ -1755,13 +1839,13 @@ end
 - **Accept**: application/json
 
 
-## get_sfvb_theme_job
+## get_sfvb_page_blog_posts
 
-> <SfvbThemeJobResponse> get_sfvb_theme_job(storefront_oid, job_id)
+> <SfvbPageBlogPostsResponse> get_sfvb_page_blog_posts(storefront_oid, path)
 
-Status of an asynchronous theme job
+Read the blog posts assigned to a page
 
-Poll until complete is true, then check success.  Note that the new theme's oid is not returned.  The job's product is a plain text report rather than a structured result, so once it completes, list themes and match on the target_path the start call gave you. 
+The posts the page shows.  uses_selectors is true when the page's blog post selectors choose them instead. 
 
 
 ### Examples
@@ -1770,21 +1854,21 @@ Poll until complete is true, then check success.  Note that the new theme's oid
 (No example for this operation).
 
 
-#### Using the get_sfvb_theme_job_with_http_info variant
+#### Using the get_sfvb_page_blog_posts_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbThemeJobResponse>, Integer, Hash)> get_sfvb_theme_job_with_http_info(storefront_oid, job_id)
+> <Array(<SfvbPageBlogPostsResponse>, Integer, Hash)> get_sfvb_page_blog_posts_with_http_info(storefront_oid, path)
 
 ```ruby
 begin
-  # Status of an asynchronous theme job
-  data, status_code, headers = api_instance.get_sfvb_theme_job_with_http_info(storefront_oid, job_id)
+  # Read the blog posts assigned to a page
+  data, status_code, headers = api_instance.get_sfvb_page_blog_posts_with_http_info(storefront_oid, path)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbThemeJobResponse>
+  p data # => <SfvbPageBlogPostsResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_theme_job_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->get_sfvb_page_blog_posts_with_http_info: #{e}"
 end
 ```
 
@@ -1793,11 +1877,11 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **job_id** | **Integer** |  |  |
+| **path** | **String** | Page path, for example /blog/ |  |
 
 ### Return type
 
-[**SfvbThemeJobResponse**](SfvbThemeJobResponse.md)
+[**SfvbPageBlogPostsResponse**](SfvbPageBlogPostsResponse.md)
 
 ### Authorization
 
@@ -1809,13 +1893,13 @@ end
 - **Accept**: application/json
 
 
-## get_sfvb_version
+## get_sfvb_page_items
 
-> <SfvbVersionResponse> get_sfvb_version
+> <SfvbPageItemsResponse> get_sfvb_page_items(storefront_oid, path)
 
-Compiler version for this merchant
+Read the items assigned to a page
 
-The visual builder release channel is per merchant, so a CLI holding cached schema or element data should compare against this to know when it has gone stale. 
+The items on the page with their sort order and url part.  uses_selectors is true when the page's selectors choose its items instead. 
 
 
 ### Examples
@@ -1824,31 +1908,34 @@ The visual builder release channel is per merchant, so a CLI holding cached sche
 (No example for this operation).
 
 
-#### Using the get_sfvb_version_with_http_info variant
+#### Using the get_sfvb_page_items_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbVersionResponse>, Integer, Hash)> get_sfvb_version_with_http_info
+> <Array(<SfvbPageItemsResponse>, Integer, Hash)> get_sfvb_page_items_with_http_info(storefront_oid, path)
 
 ```ruby
 begin
-  # Compiler version for this merchant
-  data, status_code, headers = api_instance.get_sfvb_version_with_http_info
+  # Read the items assigned to a page
+  data, status_code, headers = api_instance.get_sfvb_page_items_with_http_info(storefront_oid, path)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbVersionResponse>
+  p data # => <SfvbPageItemsResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_version_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->get_sfvb_page_items_with_http_info: #{e}"
 end
 ```
 
 ### Parameters
 
-This endpoint does not need any parameter.
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **path** | **String** | Page path, for example /lp/spring-sale/ |  |
 
 ### Return type
 
-[**SfvbVersionResponse**](SfvbVersionResponse.md)
+[**SfvbPageItemsResponse**](SfvbPageItemsResponse.md)
 
 ### Authorization
 
@@ -1860,13 +1947,13 @@ This endpoint does not need any parameter.
 - **Accept**: application/json
 
 
-## get_sfvb_whoami
+## get_sfvb_page_selectors
 
-> <SfvbWhoamiResponse> get_sfvb_whoami
+> <SfvbPageSelectors> get_sfvb_page_selectors(storefront_oid, path)
 
-Who this token is
+Read a page's selectors
 
-Returns the merchant, user, granted scopes and reachable storefronts for the calling token.  Declared for any scope so an application can always discover which account it is connected to. 
+The conditions that choose the page's items and blog posts, and whether each set must all match. 
 
 
 ### Examples
@@ -1875,31 +1962,955 @@ Returns the merchant, user, granted scopes and reachable storefronts for the cal
 (No example for this operation).
 
 
-#### Using the get_sfvb_whoami_with_http_info variant
+#### Using the get_sfvb_page_selectors_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbWhoamiResponse>, Integer, Hash)> get_sfvb_whoami_with_http_info
+> <Array(<SfvbPageSelectors>, Integer, Hash)> get_sfvb_page_selectors_with_http_info(storefront_oid, path)
 
 ```ruby
 begin
-  # Who this token is
-  data, status_code, headers = api_instance.get_sfvb_whoami_with_http_info
+  # Read a page's selectors
+  data, status_code, headers = api_instance.get_sfvb_page_selectors_with_http_info(storefront_oid, path)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbWhoamiResponse>
+  p data # => <SfvbPageSelectors>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->get_sfvb_whoami_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->get_sfvb_page_selectors_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **path** | **String** | Page path, for example /lp/spring-sale/ |  |
+
+### Return type
+
+[**SfvbPageSelectors**](SfvbPageSelectors.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_sfvb_preview_url
+
+> <SfvbPreviewUrlResponse> get_sfvb_preview_url(storefront_oid, preview_session_id, opts)
+
+URL that renders a preview session
+
+Refuses a session that does not exist, so a URL you receive is for a session that was really there.  expires_in_seconds is the time actually remaining, not the configured lifetime.  Needs a token that resolves to a user, because a preview session belongs to the person who created it. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the get_sfvb_preview_url_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbPreviewUrlResponse>, Integer, Hash)> get_sfvb_preview_url_with_http_info(storefront_oid, preview_session_id, opts)
+
+```ruby
+begin
+  # URL that renders a preview session
+  data, status_code, headers = api_instance.get_sfvb_preview_url_with_http_info(storefront_oid, preview_session_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbPreviewUrlResponse>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->get_sfvb_preview_url_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **preview_session_id** | **String** |  |  |
+| **path** | **String** |  | [optional] |
+
+### Return type
+
+[**SfvbPreviewUrlResponse**](SfvbPreviewUrlResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_sfvb_site_attributes
+
+> <SfvbSiteAttributesResponse> get_sfvb_site_attributes(storefront_oid)
+
+Read a storefront's site attributes
+
+The values the siteattribute element and $site.attr render.  These are not in any file or theme.  Attributes a template declares but nothing has set are included with the template's default, so the response describes what the templates can render rather than only what has been saved.  Credentials stored as site attributes are never included. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the get_sfvb_site_attributes_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbSiteAttributesResponse>, Integer, Hash)> get_sfvb_site_attributes_with_http_info(storefront_oid)
+
+```ruby
+begin
+  # Read a storefront's site attributes
+  data, status_code, headers = api_instance.get_sfvb_site_attributes_with_http_info(storefront_oid)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbSiteAttributesResponse>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->get_sfvb_site_attributes_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+
+### Return type
+
+[**SfvbSiteAttributesResponse**](SfvbSiteAttributesResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_sfvb_theme
+
+> <SfvbTheme> get_sfvb_theme(storefront_oid, theme_oid)
+
+Get a theme
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the get_sfvb_theme_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbTheme>, Integer, Hash)> get_sfvb_theme_with_http_info(storefront_oid, theme_oid)
+
+```ruby
+begin
+  # Get a theme
+  data, status_code, headers = api_instance.get_sfvb_theme_with_http_info(storefront_oid, theme_oid)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbTheme>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->get_sfvb_theme_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **theme_oid** | **Integer** |  |  |
+
+### Return type
+
+[**SfvbTheme**](SfvbTheme.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_sfvb_theme_attributes
+
+> <SfvbThemeAttributesResponse> get_sfvb_theme_attributes(storefront_oid, theme_oid)
+
+Read a theme's colors, fonts and settings
+
+The values theme.css and the compiled containers resolve at render time.  These do NOT live in any file.  settings.json contains a palette and looks like the answer, but it is the theme's factory template - it supplies defaults for slots that have never been set and is ignored for slots that have, so editing it will not change a color and reading it will not tell you the current one.  Slots a template declares but nothing has ever set are included here, carrying the default they will render with, so the response describes the whole theme rather than the rows that happen to exist. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the get_sfvb_theme_attributes_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbThemeAttributesResponse>, Integer, Hash)> get_sfvb_theme_attributes_with_http_info(storefront_oid, theme_oid)
+
+```ruby
+begin
+  # Read a theme's colors, fonts and settings
+  data, status_code, headers = api_instance.get_sfvb_theme_attributes_with_http_info(storefront_oid, theme_oid)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbThemeAttributesResponse>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->get_sfvb_theme_attributes_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **theme_oid** | **Integer** |  |  |
+
+### Return type
+
+[**SfvbThemeAttributesResponse**](SfvbThemeAttributesResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_sfvb_theme_job
+
+> <SfvbThemeJobResponse> get_sfvb_theme_job(storefront_oid, job_id)
+
+Status of an asynchronous theme job
+
+Poll until complete is true, then check success.  Note that the new theme's oid is not returned.  The job's product is a plain text report rather than a structured result, so once it completes, list themes and match on the target_path the start call gave you. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the get_sfvb_theme_job_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbThemeJobResponse>, Integer, Hash)> get_sfvb_theme_job_with_http_info(storefront_oid, job_id)
+
+```ruby
+begin
+  # Status of an asynchronous theme job
+  data, status_code, headers = api_instance.get_sfvb_theme_job_with_http_info(storefront_oid, job_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbThemeJobResponse>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->get_sfvb_theme_job_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **job_id** | **Integer** |  |  |
+
+### Return type
+
+[**SfvbThemeJobResponse**](SfvbThemeJobResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_sfvb_upsell_offer
+
+> <SfvbUpsellOffer> get_sfvb_upsell_offer(storefront_oid, upsell_offer_oid, opts)
+
+Get an upsell offer
+
+The whole offer, with the hash an update sends back in If-Match, which upsell items are out of stock now, and whether loyalty, TowerData and Everflow are set up.  Stats as on the path list. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the get_sfvb_upsell_offer_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbUpsellOffer>, Integer, Hash)> get_sfvb_upsell_offer_with_http_info(storefront_oid, upsell_offer_oid, opts)
+
+```ruby
+begin
+  # Get an upsell offer
+  data, status_code, headers = api_instance.get_sfvb_upsell_offer_with_http_info(storefront_oid, upsell_offer_oid, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbUpsellOffer>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->get_sfvb_upsell_offer_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **upsell_offer_oid** | **Integer** |  |  |
+| **stats** | **Boolean** | Include stats | [optional] |
+| **stats_start** | **String** | Stats window start, YYYY-MM-DD | [optional] |
+| **stats_end** | **String** | Stats window end, YYYY-MM-DD | [optional] |
+| **stats_weekdays** | **String** | Only these weekdays, comma separated mon to sun | [optional] |
+
+### Return type
+
+[**SfvbUpsellOffer**](SfvbUpsellOffer.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_sfvb_upsell_path
+
+> <SfvbUpsellPath> get_sfvb_upsell_path(storefront_oid, upsell_path_oid, opts)
+
+Get an upsell path
+
+The whole path, with the hash an update sends back in If-Match.  Stats as on the list. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the get_sfvb_upsell_path_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbUpsellPath>, Integer, Hash)> get_sfvb_upsell_path_with_http_info(storefront_oid, upsell_path_oid, opts)
+
+```ruby
+begin
+  # Get an upsell path
+  data, status_code, headers = api_instance.get_sfvb_upsell_path_with_http_info(storefront_oid, upsell_path_oid, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbUpsellPath>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->get_sfvb_upsell_path_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **upsell_path_oid** | **Integer** |  |  |
+| **stats** | **Boolean** | Include stats | [optional] |
+| **stats_start** | **String** | Stats window start, YYYY-MM-DD | [optional] |
+| **stats_end** | **String** | Stats window end, YYYY-MM-DD | [optional] |
+| **stats_weekdays** | **String** | Only these weekdays, comma separated mon to sun | [optional] |
+
+### Return type
+
+[**SfvbUpsellPath**](SfvbUpsellPath.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_sfvb_version
+
+> <SfvbVersionResponse> get_sfvb_version
+
+Compiler version for this merchant
+
+The visual builder release channel is per merchant, so a CLI holding cached schema or element data should compare against this to know when it has gone stale. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the get_sfvb_version_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbVersionResponse>, Integer, Hash)> get_sfvb_version_with_http_info
+
+```ruby
+begin
+  # Compiler version for this merchant
+  data, status_code, headers = api_instance.get_sfvb_version_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbVersionResponse>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->get_sfvb_version_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**SfvbVersionResponse**](SfvbVersionResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_sfvb_whoami
+
+> <SfvbWhoamiResponse> get_sfvb_whoami
+
+Who this token is
+
+Returns the merchant, user, granted scopes and reachable storefronts for the calling token.  Declared for any scope so an application can always discover which account it is connected to. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the get_sfvb_whoami_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbWhoamiResponse>, Integer, Hash)> get_sfvb_whoami_with_http_info
+
+```ruby
+begin
+  # Who this token is
+  data, status_code, headers = api_instance.get_sfvb_whoami_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbWhoamiResponse>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->get_sfvb_whoami_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**SfvbWhoamiResponse**](SfvbWhoamiResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## insert_sfvb_page
+
+> <SfvbPageResponse> insert_sfvb_page(storefront_oid, page_create_request)
+
+Create a page
+
+Creates the page and its folder, the way the store admin's add page does.  The parent page must already exist, and the last part of the path may only contain letters, digits, hyphens and underscores - it is refused, not cleaned.  A path that already has a page is refused with a 409 and the code sfvb.page_exists.  Without a group_template the page inherits its parent's templates, or catalog_group.vm directly under the root.  Set attributes and images afterwards with the page attribute and image endpoints, and push the body to the page folder.  Always needs sfvb_publish, because the page is live as soon as it exists.  Deleting, moving and renaming pages stay in the store admin. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the insert_sfvb_page_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbPageResponse>, Integer, Hash)> insert_sfvb_page_with_http_info(storefront_oid, page_create_request)
+
+```ruby
+begin
+  # Create a page
+  data, status_code, headers = api_instance.insert_sfvb_page_with_http_info(storefront_oid, page_create_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbPageResponse>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->insert_sfvb_page_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **page_create_request** | [**SfvbPageCreateRequest**](SfvbPageCreateRequest.md) | The page to create |  |
+
+### Return type
+
+[**SfvbPageResponse**](SfvbPageResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json; charset=UTF-8
+- **Accept**: application/json
+
+
+## insert_sfvb_upsell_offer
+
+> <SfvbUpsellOffer> insert_sfvb_upsell_offer(storefront_oid, upsell_offer)
+
+Create an upsell offer
+
+Every item it names must exist, and every shipping method, payment method and loyalty tier must be one the merchant has.  Put it on a path with a path update to have it shown.  Creating it switched on, or with upsell_item_id_javascript or offsite_content_url, needs sfvb_publish.  Its page content is its container, written with the container endpoints and owner type upsell. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the insert_sfvb_upsell_offer_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbUpsellOffer>, Integer, Hash)> insert_sfvb_upsell_offer_with_http_info(storefront_oid, upsell_offer)
+
+```ruby
+begin
+  # Create an upsell offer
+  data, status_code, headers = api_instance.insert_sfvb_upsell_offer_with_http_info(storefront_oid, upsell_offer)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbUpsellOffer>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->insert_sfvb_upsell_offer_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **upsell_offer** | [**SfvbUpsellOffer**](SfvbUpsellOffer.md) | The offer to create |  |
+
+### Return type
+
+[**SfvbUpsellOffer**](SfvbUpsellOffer.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json; charset=UTF-8
+- **Accept**: application/json
+
+
+## insert_sfvb_upsell_path
+
+> <SfvbUpsellPath> insert_sfvb_upsell_path(storefront_oid, upsell_path)
+
+Create an upsell path
+
+Placed last in path order.  Every offer a step names must be an offer of this storefront, and every item in the item logic must exist.  Creating it switched on needs sfvb_publish; create it with active false to build it without that scope. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the insert_sfvb_upsell_path_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbUpsellPath>, Integer, Hash)> insert_sfvb_upsell_path_with_http_info(storefront_oid, upsell_path)
+
+```ruby
+begin
+  # Create an upsell path
+  data, status_code, headers = api_instance.insert_sfvb_upsell_path_with_http_info(storefront_oid, upsell_path)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbUpsellPath>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->insert_sfvb_upsell_path_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **upsell_path** | [**SfvbUpsellPath**](SfvbUpsellPath.md) | The path to create |  |
+
+### Return type
+
+[**SfvbUpsellPath**](SfvbUpsellPath.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json; charset=UTF-8
+- **Accept**: application/json
+
+
+## install_sfvb_library_entry
+
+> <SfvbLibraryEntry> install_sfvb_library_entry(storefront_oid, library_oid)
+
+Install a library entry into a storefront
+
+Copies the fragment's referenced assets into the storefront file system and returns the CJSON with its paths resolved, ready to place.  This writes, which is why it is a POST rather than the GET the internal admin endpoint uses.  It also requires sfvb_publish, because the assets land in the shared storefront file system, which is served to shoppers regardless of which theme is active, so no amount of working inside a duplicate theme isolates them. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the install_sfvb_library_entry_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbLibraryEntry>, Integer, Hash)> install_sfvb_library_entry_with_http_info(storefront_oid, library_oid)
+
+```ruby
+begin
+  # Install a library entry into a storefront
+  data, status_code, headers = api_instance.install_sfvb_library_entry_with_http_info(storefront_oid, library_oid)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbLibraryEntry>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->install_sfvb_library_entry_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **library_oid** | **Integer** |  |  |
+
+### Return type
+
+[**SfvbLibraryEntry**](SfvbLibraryEntry.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_sfvb_blog_posts
+
+> <SfvbBlogPostsResponse> list_sfvb_blog_posts(storefront_oid, opts)
+
+List the storefront's blog posts
+
+One page of blog posts, newest first, without their bodies.  search matches the title, body, excerpt, url part or author, or a tag exactly.  unassigned marks posts no page shows yet.  Use a post's blog_post_oid to assign it to a page. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the list_sfvb_blog_posts_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbBlogPostsResponse>, Integer, Hash)> list_sfvb_blog_posts_with_http_info(storefront_oid, opts)
+
+```ruby
+begin
+  # List the storefront's blog posts
+  data, status_code, headers = api_instance.list_sfvb_blog_posts_with_http_info(storefront_oid, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbBlogPostsResponse>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->list_sfvb_blog_posts_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **search** | **String** | Text to search for | [optional] |
+| **page** | **Integer** | Page number, starting at 1 | [optional] |
+| **page_size** | **Integer** | Posts per page, 1 to 100, default 50 | [optional] |
+
+### Return type
+
+[**SfvbBlogPostsResponse**](SfvbBlogPostsResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_sfvb_container_versions
+
+> <SfvbContainerVersionsResponse> list_sfvb_container_versions(storefront_oid, opts)
+
+Version history for a container stored outside the file system
+
+Addressed the same way as the container itself, so owner_type also says how owner_object_id is read and itemid lists the history of the item container that merchant item id names. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the list_sfvb_container_versions_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbContainerVersionsResponse>, Integer, Hash)> list_sfvb_container_versions_with_http_info(storefront_oid, opts)
+
+```ruby
+begin
+  # Version history for a container stored outside the file system
+  data, status_code, headers = api_instance.list_sfvb_container_versions_with_http_info(storefront_oid, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbContainerVersionsResponse>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->list_sfvb_container_versions_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **owner_type** | **String** |  | [optional] |
+| **owner_object_id** | **String** |  | [optional] |
+| **container_name** | **String** |  | [optional] |
+
+### Return type
+
+[**SfvbContainerVersionsResponse**](SfvbContainerVersionsResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_sfvb_elements
+
+> <SfvbElementsResponse> list_sfvb_elements
+
+List every SFVB element type
+
+The authoritative vocabulary, taken from the same lookup the compiler uses.  A type absent from this list compiles to a literal placeholder line in the page rather than failing, which is why validation treats an unknown type as an error. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the list_sfvb_elements_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbElementsResponse>, Integer, Hash)> list_sfvb_elements_with_http_info
+
+```ruby
+begin
+  # List every SFVB element type
+  data, status_code, headers = api_instance.list_sfvb_elements_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbElementsResponse>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->list_sfvb_elements_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**SfvbElementsResponse**](SfvbElementsResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_sfvb_experiments
+
+> <SfvbExperimentsResponse> list_sfvb_experiments(storefront_oid, opts)
+
+List the storefront's experiments
+
+Every experiment that is not deleted, with its variations and their statistics - the same numbers the store admin shows.  Filter by status, by type (page, url, theme, openai), or by the page an experiment runs on.  auto_ends_at says when the engine will end an experiment by itself, and p_value is a one-way ANOVA across all variations.  Read one experiment for its daily statistics. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the list_sfvb_experiments_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbExperimentsResponse>, Integer, Hash)> list_sfvb_experiments_with_http_info(storefront_oid, opts)
+
+```ruby
+begin
+  # List the storefront's experiments
+  data, status_code, headers = api_instance.list_sfvb_experiments_with_http_info(storefront_oid, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbExperimentsResponse>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->list_sfvb_experiments_with_http_info: #{e}"
 end
 ```
 
 ### Parameters
 
-This endpoint does not need any parameter.
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **status** | **String** | Running or Ended | [optional] |
+| **type** | **String** | page, url, theme or openai | [optional] |
+| **path** | **String** | Only experiments on this page, for example /lp/spring-sale/ | [optional] |
 
 ### Return type
 
-[**SfvbWhoamiResponse**](SfvbWhoamiResponse.md)
+[**SfvbExperimentsResponse**](SfvbExperimentsResponse.md)
 
 ### Authorization
 
@@ -1911,13 +2922,13 @@ This endpoint does not need any parameter.
 - **Accept**: application/json
 
 
-## insert_sfvb_page
+## list_sfvb_file_versions
 
-> <SfvbPageResponse> insert_sfvb_page(storefront_oid, page_create_request)
+> <SfvbFileVersionsResponse> list_sfvb_file_versions(storefront_oid, opts)
 
-Create a page
+Version history for a storefront file
 
-Creates the page and its folder, the way the store admin's add page does.  The parent page must already exist, and the last part of the path may only contain letters, digits, hyphens and underscores - it is refused, not cleaned.  A path that already has a page is refused with a 409 and the code sfvb.page_exists.  Without a group_template the page inherits its parent's templates, or catalog_group.vm directly under the root.  Set attributes and images afterwards with the page attribute and image endpoints, and push the body to the page folder.  Always needs sfvb_publish, because the page is live as soon as it exists.  Deleting, moving and renaming pages stay in the store admin. 
+Version history is the undo for anything in the storefront file system, which is what makes an agent's writes recoverable. 
 
 
 ### Examples
@@ -1926,21 +2937,21 @@ Creates the page and its folder, the way the store admin's add page does.  The p
 (No example for this operation).
 
 
-#### Using the insert_sfvb_page_with_http_info variant
+#### Using the list_sfvb_file_versions_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbPageResponse>, Integer, Hash)> insert_sfvb_page_with_http_info(storefront_oid, page_create_request)
+> <Array(<SfvbFileVersionsResponse>, Integer, Hash)> list_sfvb_file_versions_with_http_info(storefront_oid, opts)
 
 ```ruby
 begin
-  # Create a page
-  data, status_code, headers = api_instance.insert_sfvb_page_with_http_info(storefront_oid, page_create_request)
+  # Version history for a storefront file
+  data, status_code, headers = api_instance.list_sfvb_file_versions_with_http_info(storefront_oid, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbPageResponse>
+  p data # => <SfvbFileVersionsResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->insert_sfvb_page_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->list_sfvb_file_versions_with_http_info: #{e}"
 end
 ```
 
@@ -1949,11 +2960,11 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **page_create_request** | [**SfvbPageCreateRequest**](SfvbPageCreateRequest.md) | The page to create |  |
+| **path** | **String** |  | [optional] |
 
 ### Return type
 
-[**SfvbPageResponse**](SfvbPageResponse.md)
+[**SfvbFileVersionsResponse**](SfvbFileVersionsResponse.md)
 
 ### Authorization
 
@@ -1961,17 +2972,17 @@ end
 
 ### HTTP request headers
 
-- **Content-Type**: application/json; charset=UTF-8
+- **Content-Type**: Not defined
 - **Accept**: application/json
 
 
-## install_sfvb_library_entry
+## list_sfvb_files
 
-> <SfvbLibraryEntry> install_sfvb_library_entry(storefront_oid, library_oid)
+> <SfvbFilesResponse> list_sfvb_files(storefront_oid, opts)
 
-Install a library entry into a storefront
+List a storefront directory
 
-Copies the fragment's referenced assets into the storefront file system and returns the CJSON with its paths resolved, ready to place.  This writes, which is why it is a POST rather than the GET the internal admin endpoint uses.  It also requires sfvb_publish, because the assets land in the shared storefront file system, which is served to shoppers regardless of which theme is active, so no amount of working inside a duplicate theme isolates them. 
+Directories first, then files, each sorted by name.  Address by path or by directory oid; supplying theme_oid also retries a path that does not resolve at the storefront root relative to that theme, so /theme/css/ works without knowing the theme's directory name.  Each file carries its content hash, so a listing is enough to start an If-Match write without a separate read. 
 
 
 ### Examples
@@ -1980,21 +2991,21 @@ Copies the fragment's referenced assets into the storefront file system and retu
 (No example for this operation).
 
 
-#### Using the install_sfvb_library_entry_with_http_info variant
+#### Using the list_sfvb_files_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbLibraryEntry>, Integer, Hash)> install_sfvb_library_entry_with_http_info(storefront_oid, library_oid)
+> <Array(<SfvbFilesResponse>, Integer, Hash)> list_sfvb_files_with_http_info(storefront_oid, opts)
 
 ```ruby
 begin
-  # Install a library entry into a storefront
-  data, status_code, headers = api_instance.install_sfvb_library_entry_with_http_info(storefront_oid, library_oid)
+  # List a storefront directory
+  data, status_code, headers = api_instance.list_sfvb_files_with_http_info(storefront_oid, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbLibraryEntry>
+  p data # => <SfvbFilesResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->install_sfvb_library_entry_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->list_sfvb_files_with_http_info: #{e}"
 end
 ```
 
@@ -2003,11 +3014,14 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **library_oid** | **Integer** |  |  |
+| **path** | **String** |  | [optional] |
+| **storefront_fs_directory_oid** | **Integer** |  | [optional] |
+| **theme_oid** | **Integer** |  | [optional] |
+| **max_entries** | **Integer** |  | [optional] |
 
 ### Return type
 
-[**SfvbLibraryEntry**](SfvbLibraryEntry.md)
+[**SfvbFilesResponse**](SfvbFilesResponse.md)
 
 ### Authorization
 
@@ -2019,13 +3033,13 @@ end
 - **Accept**: application/json
 
 
-## list_sfvb_blog_posts
+## list_sfvb_item_containers
 
-> <SfvbBlogPostsResponse> list_sfvb_blog_posts(storefront_oid, opts)
+> <SfvbItemContainersResponse> list_sfvb_item_containers(storefront_oid, opts)
 
-List the storefront's blog posts
+List the item containers on the account
 
-One page of blog posts, newest first, without their bodies.  search matches the title, body, excerpt, url part or author, or a tag exactly.  unassigned marks posts no page shows yet.  Use a post's blog_post_oid to assign it to a page. 
+An itemcontainer element renders nothing of its own.  It names a slot, and a separate container is resolved per item for that slot, so a catalog of five hundred products with three slots is fifteen hundred containers.  This says which of them exist.  Filter by container_name to find every item carrying one slot, or by merchant_item_id to see what one item has.  Which items are missing a slot is a set difference against pages/items, because a listing can only report containers that exist.  Each row carries hash_sha256, so a listing is enough to start an If-Match write without reading the container first.  Item containers are stored per account rather than per storefront, so storefront_oid identifies the caller's storefront but does not narrow the result. 
 
 
 ### Examples
@@ -2034,21 +3048,21 @@ One page of blog posts, newest first, without their bodies.  search matches the
 (No example for this operation).
 
 
-#### Using the list_sfvb_blog_posts_with_http_info variant
+#### Using the list_sfvb_item_containers_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbBlogPostsResponse>, Integer, Hash)> list_sfvb_blog_posts_with_http_info(storefront_oid, opts)
+> <Array(<SfvbItemContainersResponse>, Integer, Hash)> list_sfvb_item_containers_with_http_info(storefront_oid, opts)
 
 ```ruby
 begin
-  # List the storefront's blog posts
-  data, status_code, headers = api_instance.list_sfvb_blog_posts_with_http_info(storefront_oid, opts)
+  # List the item containers on the account
+  data, status_code, headers = api_instance.list_sfvb_item_containers_with_http_info(storefront_oid, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbBlogPostsResponse>
+  p data # => <SfvbItemContainersResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->list_sfvb_blog_posts_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->list_sfvb_item_containers_with_http_info: #{e}"
 end
 ```
 
@@ -2057,13 +3071,15 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **search** | **String** | Text to search for | [optional] |
-| **page** | **Integer** | Page number, starting at 1 | [optional] |
-| **page_size** | **Integer** | Posts per page, 1 to 100, default 50 | [optional] |
+| **merchant_item_id** | **String** | Restrict to one item, by the merchant item id a storefront carries | [optional] |
+| **merchant_item_oid** | **Integer** | Restrict to one item, by oid.  Send this or merchant_item_id, not both | [optional] |
+| **container_name** | **String** | Restrict to one slot name, matched without regard to case | [optional] |
+| **max_results** | **Integer** |  | [optional] |
+| **offset** | **Integer** |  | [optional] |
 
 ### Return type
 
-[**SfvbBlogPostsResponse**](SfvbBlogPostsResponse.md)
+[**SfvbItemContainersResponse**](SfvbItemContainersResponse.md)
 
 ### Authorization
 
@@ -2075,13 +3091,13 @@ end
 - **Accept**: application/json
 
 
-## list_sfvb_container_versions
+## list_sfvb_pages
 
-> <SfvbContainerVersionsResponse> list_sfvb_container_versions(storefront_oid, opts)
+> <SfvbPageListResponse> list_sfvb_pages(storefront_oid, opts)
 
-Version history for a container stored outside the file system
+List the storefront's pages
 
-Addressed the same way as the container itself, so owner_type also says how owner_object_id is read and itemid lists the history of the item container that merchant item id names. 
+Every page with its settings, sorted by path with the root first.  Hidden pages are included.  Pass under to list one page and everything below it.  Read from the same cached catalog the admin page tree uses, so a page created a moment ago can take a moment to appear here - read it directly with the single-page read to confirm a write. 
 
 
 ### Examples
@@ -2090,21 +3106,21 @@ Addressed the same way as the container itself, so owner_type also says how owne
 (No example for this operation).
 
 
-#### Using the list_sfvb_container_versions_with_http_info variant
+#### Using the list_sfvb_pages_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbContainerVersionsResponse>, Integer, Hash)> list_sfvb_container_versions_with_http_info(storefront_oid, opts)
+> <Array(<SfvbPageListResponse>, Integer, Hash)> list_sfvb_pages_with_http_info(storefront_oid, opts)
 
 ```ruby
 begin
-  # Version history for a container stored outside the file system
-  data, status_code, headers = api_instance.list_sfvb_container_versions_with_http_info(storefront_oid, opts)
+  # List the storefront's pages
+  data, status_code, headers = api_instance.list_sfvb_pages_with_http_info(storefront_oid, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbContainerVersionsResponse>
+  p data # => <SfvbPageListResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->list_sfvb_container_versions_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->list_sfvb_pages_with_http_info: #{e}"
 end
 ```
 
@@ -2113,13 +3129,11 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **owner_type** | **String** |  | [optional] |
-| **owner_object_id** | **String** |  | [optional] |
-| **container_name** | **String** |  | [optional] |
+| **under** | **String** | Only this page and the pages below it, for example /lp/ | [optional] |
 
 ### Return type
 
-[**SfvbContainerVersionsResponse**](SfvbContainerVersionsResponse.md)
+[**SfvbPageListResponse**](SfvbPageListResponse.md)
 
 ### Authorization
 
@@ -2131,13 +3145,11 @@ end
 - **Accept**: application/json
 
 
-## list_sfvb_elements
-
-> <SfvbElementsResponse> list_sfvb_elements
+## list_sfvb_storefronts
 
-List every SFVB element type
+> <SfvbStorefrontsResponse> list_sfvb_storefronts
 
-The authoritative vocabulary, taken from the same lookup the compiler uses.  A type absent from this list compiles to a literal placeholder line in the page rather than failing, which is why validation treats an unknown type as an error. 
+List storefronts
 
 
 ### Examples
@@ -2146,21 +3158,21 @@ The authoritative vocabulary, taken from the same lookup the compiler uses.  A t
 (No example for this operation).
 
 
-#### Using the list_sfvb_elements_with_http_info variant
+#### Using the list_sfvb_storefronts_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbElementsResponse>, Integer, Hash)> list_sfvb_elements_with_http_info
+> <Array(<SfvbStorefrontsResponse>, Integer, Hash)> list_sfvb_storefronts_with_http_info
 
 ```ruby
 begin
-  # List every SFVB element type
-  data, status_code, headers = api_instance.list_sfvb_elements_with_http_info
+  # List storefronts
+  data, status_code, headers = api_instance.list_sfvb_storefronts_with_http_info
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbElementsResponse>
+  p data # => <SfvbStorefrontsResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->list_sfvb_elements_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->list_sfvb_storefronts_with_http_info: #{e}"
 end
 ```
 
@@ -2170,7 +3182,7 @@ This endpoint does not need any parameter.
 
 ### Return type
 
-[**SfvbElementsResponse**](SfvbElementsResponse.md)
+[**SfvbStorefrontsResponse**](SfvbStorefrontsResponse.md)
 
 ### Authorization
 
@@ -2182,13 +3194,13 @@ This endpoint does not need any parameter.
 - **Accept**: application/json
 
 
-## list_sfvb_experiments
+## list_sfvb_templates
 
-> <SfvbExperimentsResponse> list_sfvb_experiments(storefront_oid, opts)
+> <SfvbTemplatesResponse> list_sfvb_templates(storefront_oid, opts)
 
-List the storefront's experiments
+List the active theme's templates
 
-Every experiment that is not deleted, with its variations and their statistics - the same numbers the store admin shows.  Filter by status, by type (page, url, theme, openai), or by the page an experiment runs on.  auto_ends_at says when the engine will end an experiment by itself, and p_value is a one-way ANOVA across all variations.  Read one experiment for its daily statistics. 
+Each template with the page type it declares and what it can render - items, sub-pages, blog posts, pagination, visual builder containers.  A page's group_template names one of these.  The storefront's fixed templates, such as checkout and my account, are flagged system and must never be assigned to a page. 
 
 
 ### Examples
@@ -2197,21 +3209,21 @@ Every experiment that is not deleted, with its variations and their statistics -
 (No example for this operation).
 
 
-#### Using the list_sfvb_experiments_with_http_info variant
+#### Using the list_sfvb_templates_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbExperimentsResponse>, Integer, Hash)> list_sfvb_experiments_with_http_info(storefront_oid, opts)
+> <Array(<SfvbTemplatesResponse>, Integer, Hash)> list_sfvb_templates_with_http_info(storefront_oid, opts)
 
 ```ruby
 begin
-  # List the storefront's experiments
-  data, status_code, headers = api_instance.list_sfvb_experiments_with_http_info(storefront_oid, opts)
+  # List the active theme's templates
+  data, status_code, headers = api_instance.list_sfvb_templates_with_http_info(storefront_oid, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbExperimentsResponse>
+  p data # => <SfvbTemplatesResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->list_sfvb_experiments_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->list_sfvb_templates_with_http_info: #{e}"
 end
 ```
 
@@ -2220,13 +3232,11 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **status** | **String** | Running or Ended | [optional] |
-| **type** | **String** | page, url, theme or openai | [optional] |
-| **path** | **String** | Only experiments on this page, for example /lp/spring-sale/ | [optional] |
+| **page_type** | **String** | Only templates declaring this page type, for example group | [optional] |
 
 ### Return type
 
-[**SfvbExperimentsResponse**](SfvbExperimentsResponse.md)
+[**SfvbTemplatesResponse**](SfvbTemplatesResponse.md)
 
 ### Authorization
 
@@ -2238,13 +3248,13 @@ end
 - **Accept**: application/json
 
 
-## list_sfvb_file_versions
+## list_sfvb_themes
 
-> <SfvbFileVersionsResponse> list_sfvb_file_versions(storefront_oid, opts)
+> <SfvbThemesResponse> list_sfvb_themes(storefront_oid)
 
-Version history for a storefront file
+List themes for a storefront
 
-Version history is the undo for anything in the storefront file system, which is what makes an agent's writes recoverable. 
+Exactly one theme is flagged active.  Writing to the active theme is writing live and requires the sfvb_publish scope. 
 
 
 ### Examples
@@ -2253,21 +3263,21 @@ Version history is the undo for anything in the storefront file system, which is
 (No example for this operation).
 
 
-#### Using the list_sfvb_file_versions_with_http_info variant
+#### Using the list_sfvb_themes_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbFileVersionsResponse>, Integer, Hash)> list_sfvb_file_versions_with_http_info(storefront_oid, opts)
+> <Array(<SfvbThemesResponse>, Integer, Hash)> list_sfvb_themes_with_http_info(storefront_oid)
 
 ```ruby
 begin
-  # Version history for a storefront file
-  data, status_code, headers = api_instance.list_sfvb_file_versions_with_http_info(storefront_oid, opts)
+  # List themes for a storefront
+  data, status_code, headers = api_instance.list_sfvb_themes_with_http_info(storefront_oid)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbFileVersionsResponse>
+  p data # => <SfvbThemesResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->list_sfvb_file_versions_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->list_sfvb_themes_with_http_info: #{e}"
 end
 ```
 
@@ -2276,11 +3286,10 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **path** | **String** |  | [optional] |
 
 ### Return type
 
-[**SfvbFileVersionsResponse**](SfvbFileVersionsResponse.md)
+[**SfvbThemesResponse**](SfvbThemesResponse.md)
 
 ### Authorization
 
@@ -2292,13 +3301,13 @@ end
 - **Accept**: application/json
 
 
-## list_sfvb_files
+## list_sfvb_upsell_offers
 
-> <SfvbFilesResponse> list_sfvb_files(storefront_oid, opts)
+> <SfvbUpsellOffersResponse> list_sfvb_upsell_offers(storefront_oid, opts)
 
-List a storefront directory
+List upsell offers
 
-Directories first, then files, each sorted by name.  Address by path or by directory oid; supplying theme_oid also retries a path that does not resolve at the storefront root relative to that theme, so /theme/css/ works without knowing the theme's directory name.  Each file carries its content hash, so a listing is enough to start an If-Match write without a separate read. 
+Every offer on one of this storefront's paths that are not archived, the same list the admin shows, with each offer's full settings but not its container JSON.  An offer on no path yet is still read by oid.  A large container size alongside a small element count is the signature of markup pasted into a single html element.  Stats as on the path list. 
 
 
 ### Examples
@@ -2307,21 +3316,21 @@ Directories first, then files, each sorted by name.  Address by path or by direc
 (No example for this operation).
 
 
-#### Using the list_sfvb_files_with_http_info variant
+#### Using the list_sfvb_upsell_offers_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbFilesResponse>, Integer, Hash)> list_sfvb_files_with_http_info(storefront_oid, opts)
+> <Array(<SfvbUpsellOffersResponse>, Integer, Hash)> list_sfvb_upsell_offers_with_http_info(storefront_oid, opts)
 
 ```ruby
 begin
-  # List a storefront directory
-  data, status_code, headers = api_instance.list_sfvb_files_with_http_info(storefront_oid, opts)
+  # List upsell offers
+  data, status_code, headers = api_instance.list_sfvb_upsell_offers_with_http_info(storefront_oid, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbFilesResponse>
+  p data # => <SfvbUpsellOffersResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->list_sfvb_files_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->list_sfvb_upsell_offers_with_http_info: #{e}"
 end
 ```
 
@@ -2330,14 +3339,14 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **path** | **String** |  | [optional] |
-| **storefront_fs_directory_oid** | **Integer** |  | [optional] |
-| **theme_oid** | **Integer** |  | [optional] |
-| **max_entries** | **Integer** |  | [optional] |
+| **stats** | **Boolean** | Include stats | [optional] |
+| **stats_start** | **String** | Stats window start, YYYY-MM-DD | [optional] |
+| **stats_end** | **String** | Stats window end, YYYY-MM-DD | [optional] |
+| **stats_weekdays** | **String** | Only these weekdays, comma separated mon to sun | [optional] |
 
 ### Return type
 
-[**SfvbFilesResponse**](SfvbFilesResponse.md)
+[**SfvbUpsellOffersResponse**](SfvbUpsellOffersResponse.md)
 
 ### Authorization
 
@@ -2349,13 +3358,13 @@ end
 - **Accept**: application/json
 
 
-## list_sfvb_item_containers
+## list_sfvb_upsell_paths
 
-> <SfvbItemContainersResponse> list_sfvb_item_containers(storefront_oid, opts)
+> <SfvbUpsellPathsResponse> list_sfvb_upsell_paths(storefront_oid, opts)
 
-List the item containers on the account
+List upsell paths
 
-An itemcontainer element renders nothing of its own.  It names a slot, and a separate container is resolved per item for that slot, so a catalog of five hundred products with three slots is fifteen hundred containers.  This says which of them exist.  Filter by container_name to find every item carrying one slot, or by merchant_item_id to see what one item has.  Which items are missing a slot is a set difference against pages/items, because a listing can only report containers that exist.  Each row carries hash_sha256, so a listing is enough to start an If-Match write without reading the container first.  Item containers are stored per account rather than per storefront, so storefront_oid identifies the caller's storefront but does not narrow the result. 
+In path order, first to last.  status current (the default) leaves out archived paths.  Stats are computed only with stats=true, over stats_start to stats_end (YYYY-MM-DD, the last 30 days when both are omitted, at most 366 days), because they are the expensive part of the read. 
 
 
 ### Examples
@@ -2364,21 +3373,21 @@ An itemcontainer element renders nothing of its own.  It names a slot, and a sep
 (No example for this operation).
 
 
-#### Using the list_sfvb_item_containers_with_http_info variant
+#### Using the list_sfvb_upsell_paths_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbItemContainersResponse>, Integer, Hash)> list_sfvb_item_containers_with_http_info(storefront_oid, opts)
+> <Array(<SfvbUpsellPathsResponse>, Integer, Hash)> list_sfvb_upsell_paths_with_http_info(storefront_oid, opts)
 
 ```ruby
 begin
-  # List the item containers on the account
-  data, status_code, headers = api_instance.list_sfvb_item_containers_with_http_info(storefront_oid, opts)
+  # List upsell paths
+  data, status_code, headers = api_instance.list_sfvb_upsell_paths_with_http_info(storefront_oid, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbItemContainersResponse>
+  p data # => <SfvbUpsellPathsResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->list_sfvb_item_containers_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->list_sfvb_upsell_paths_with_http_info: #{e}"
 end
 ```
 
@@ -2387,15 +3396,19 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **merchant_item_id** | **String** | Restrict to one item, by the merchant item id a storefront carries | [optional] |
-| **merchant_item_oid** | **Integer** | Restrict to one item, by oid.  Send this or merchant_item_id, not both | [optional] |
-| **container_name** | **String** | Restrict to one slot name, matched without regard to case | [optional] |
-| **max_results** | **Integer** |  | [optional] |
-| **offset** | **Integer** |  | [optional] |
+| **status** | **String** | current, archived or all | [optional] |
+| **location** | **String** | pre checkout or post checkout | [optional] |
+| **search** | **String** | Only paths whose name contains this | [optional] |
+| **stats** | **Boolean** | Include stats | [optional] |
+| **stats_start** | **String** | Stats window start, YYYY-MM-DD | [optional] |
+| **stats_end** | **String** | Stats window end, YYYY-MM-DD | [optional] |
+| **stats_weekdays** | **String** | Only these weekdays, comma separated mon to sun | [optional] |
+| **max_results** | **Integer** | Page size, 1 to 500, default 100 | [optional] |
+| **offset** | **Integer** | Offset of the first path returned | [optional] |
 
 ### Return type
 
-[**SfvbItemContainersResponse**](SfvbItemContainersResponse.md)
+[**SfvbUpsellPathsResponse**](SfvbUpsellPathsResponse.md)
 
 ### Authorization
 
@@ -2407,13 +3420,13 @@ end
 - **Accept**: application/json
 
 
-## list_sfvb_pages
+## move_sfvb_upsell_path
 
-> <SfvbPageListResponse> list_sfvb_pages(storefront_oid, opts)
+> <SfvbUpsellPath> move_sfvb_upsell_path(storefront_oid, upsell_path_oid, move_request)
 
-List the storefront's pages
+Move an upsell path
 
-Every page with its settings, sorted by path with the root first.  Hidden pages are included.  Pass under to list one page and everything below it.  Read from the same cached catalog the admin page tree uses, so a page created a moment ago can take a moment to appear here - read it directly with the single-page read to confirm a write. 
+Up, down, to the top or to the bottom of the storefront's paths.  Order decides which running path a shopper meets first, so moving a running path needs sfvb_publish. 
 
 
 ### Examples
@@ -2422,21 +3435,21 @@ Every page with its settings, sorted by path with the root first.  Hidden pages
 (No example for this operation).
 
 
-#### Using the list_sfvb_pages_with_http_info variant
+#### Using the move_sfvb_upsell_path_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbPageListResponse>, Integer, Hash)> list_sfvb_pages_with_http_info(storefront_oid, opts)
+> <Array(<SfvbUpsellPath>, Integer, Hash)> move_sfvb_upsell_path_with_http_info(storefront_oid, upsell_path_oid, move_request)
 
 ```ruby
 begin
-  # List the storefront's pages
-  data, status_code, headers = api_instance.list_sfvb_pages_with_http_info(storefront_oid, opts)
+  # Move an upsell path
+  data, status_code, headers = api_instance.move_sfvb_upsell_path_with_http_info(storefront_oid, upsell_path_oid, move_request)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbPageListResponse>
+  p data # => <SfvbUpsellPath>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->list_sfvb_pages_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->move_sfvb_upsell_path_with_http_info: #{e}"
 end
 ```
 
@@ -2445,11 +3458,12 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **under** | **String** | Only this page and the pages below it, for example /lp/ | [optional] |
+| **upsell_path_oid** | **Integer** |  |  |
+| **move_request** | [**SfvbUpsellPathMoveRequest**](SfvbUpsellPathMoveRequest.md) | Where to move it |  |
 
 ### Return type
 
-[**SfvbPageListResponse**](SfvbPageListResponse.md)
+[**SfvbUpsellPath**](SfvbUpsellPath.md)
 
 ### Authorization
 
@@ -2457,15 +3471,17 @@ end
 
 ### HTTP request headers
 
-- **Content-Type**: Not defined
+- **Content-Type**: application/json; charset=UTF-8
 - **Accept**: application/json
 
 
-## list_sfvb_storefronts
+## put_sfvb_container
 
-> <SfvbStorefrontsResponse> list_sfvb_storefronts
+> <SfvbContainerResponse> put_sfvb_container(storefront_oid, owner_type, owner_object_id, if_match, container_write_request, opts)
 
-List storefronts
+Write a container stored outside the file system
+
+Validation is mandatory and runs here regardless of whether the caller validated first.  The previous value is snapshotted before the write, so the change can be reverted.  Side effects the visual builder performs on save, such as upsell screenshot regeneration and email content review flagging, are applied too.  owner_type also says how owner_object_id is read; send itemid to address an item container by merchant item id rather than by oid.  Either way the history records the one canonical address, so a container written under one spelling is listed and reverted under the other. 
 
 
 ### Examples
@@ -2474,31 +3490,38 @@ List storefronts
 (No example for this operation).
 
 
-#### Using the list_sfvb_storefronts_with_http_info variant
+#### Using the put_sfvb_container_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbStorefrontsResponse>, Integer, Hash)> list_sfvb_storefronts_with_http_info
+> <Array(<SfvbContainerResponse>, Integer, Hash)> put_sfvb_container_with_http_info(storefront_oid, owner_type, owner_object_id, if_match, container_write_request, opts)
 
 ```ruby
-begin
-  # List storefronts
-  data, status_code, headers = api_instance.list_sfvb_storefronts_with_http_info
+begin
+  # Write a container stored outside the file system
+  data, status_code, headers = api_instance.put_sfvb_container_with_http_info(storefront_oid, owner_type, owner_object_id, if_match, container_write_request, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbStorefrontsResponse>
+  p data # => <SfvbContainerResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->list_sfvb_storefronts_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->put_sfvb_container_with_http_info: #{e}"
 end
 ```
 
 ### Parameters
 
-This endpoint does not need any parameter.
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **owner_type** | **String** |  |  |
+| **owner_object_id** | **String** |  |  |
+| **if_match** | **String** | CJSON hash from the last read.  Required; 428 when absent, 412 when stale. |  |
+| **container_write_request** | [**SfvbContainerWriteRequest**](SfvbContainerWriteRequest.md) | Container CJSON to write |  |
+| **container_name** | **String** |  | [optional] |
 
 ### Return type
 
-[**SfvbStorefrontsResponse**](SfvbStorefrontsResponse.md)
+[**SfvbContainerResponse**](SfvbContainerResponse.md)
 
 ### Authorization
 
@@ -2506,17 +3529,17 @@ This endpoint does not need any parameter.
 
 ### HTTP request headers
 
-- **Content-Type**: Not defined
+- **Content-Type**: application/json
 - **Accept**: application/json
 
 
-## list_sfvb_templates
+## put_sfvb_experiment_variation
 
-> <SfvbTemplatesResponse> list_sfvb_templates(storefront_oid, opts)
+> <SfvbExperiment> put_sfvb_experiment_variation(storefront_oid, experiment_oid, variation_number, experiment_variation_update_request)
 
-List the active theme's templates
+Pause or resume a variation
 
-Each template with the page type it declares and what it can render - items, sub-pages, blog posts, pagination, visual builder containers.  A page's group_template names one of these.  The storefront's fixed templates, such as checkout and my account, are flagged system and must never be assigned to a page. 
+Stops or resumes sending new visitors to one variation of a running experiment.  Visitors already assigned keep seeing it.  Variation 0 cannot be paused, because the split falls back to it, and the last variation still receiving visitors cannot be paused.  Always needs sfvb_publish. 
 
 
 ### Examples
@@ -2525,21 +3548,21 @@ Each template with the page type it declares and what it can render - items, sub
 (No example for this operation).
 
 
-#### Using the list_sfvb_templates_with_http_info variant
+#### Using the put_sfvb_experiment_variation_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbTemplatesResponse>, Integer, Hash)> list_sfvb_templates_with_http_info(storefront_oid, opts)
+> <Array(<SfvbExperiment>, Integer, Hash)> put_sfvb_experiment_variation_with_http_info(storefront_oid, experiment_oid, variation_number, experiment_variation_update_request)
 
 ```ruby
 begin
-  # List the active theme's templates
-  data, status_code, headers = api_instance.list_sfvb_templates_with_http_info(storefront_oid, opts)
+  # Pause or resume a variation
+  data, status_code, headers = api_instance.put_sfvb_experiment_variation_with_http_info(storefront_oid, experiment_oid, variation_number, experiment_variation_update_request)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbTemplatesResponse>
+  p data # => <SfvbExperiment>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->list_sfvb_templates_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->put_sfvb_experiment_variation_with_http_info: #{e}"
 end
 ```
 
@@ -2548,11 +3571,13 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **page_type** | **String** | Only templates declaring this page type, for example group | [optional] |
+| **experiment_oid** | **Integer** |  |  |
+| **variation_number** | **Integer** |  |  |
+| **experiment_variation_update_request** | [**SfvbExperimentVariationUpdateRequest**](SfvbExperimentVariationUpdateRequest.md) | Pause or resume |  |
 
 ### Return type
 
-[**SfvbTemplatesResponse**](SfvbTemplatesResponse.md)
+[**SfvbExperiment**](SfvbExperiment.md)
 
 ### Authorization
 
@@ -2560,17 +3585,17 @@ end
 
 ### HTTP request headers
 
-- **Content-Type**: Not defined
+- **Content-Type**: application/json; charset=UTF-8
 - **Accept**: application/json
 
 
-## list_sfvb_themes
+## put_sfvb_file_content
 
-> <SfvbThemesResponse> list_sfvb_themes(storefront_oid)
+> <SfvbFileWriteResponse> put_sfvb_file_content(storefront_oid, if_match, file_write_request, opts)
 
-List themes for a storefront
+Write a storefront file
 
-Exactly one theme is flagged active.  Writing to the active theme is writing live and requires the sfvb_publish scope. 
+Runs the template sandbox, Velocity validation and the internationalization check, records a version, and compiles the sibling .vm when the file is a .cjson under a theme.  Send If-Match with the hash from the last read to avoid clobbering a concurrent change.  Writing into the active theme requires sfvb_publish. 
 
 
 ### Examples
@@ -2579,21 +3604,21 @@ Exactly one theme is flagged active.  Writing to the active theme is writing liv
 (No example for this operation).
 
 
-#### Using the list_sfvb_themes_with_http_info variant
+#### Using the put_sfvb_file_content_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbThemesResponse>, Integer, Hash)> list_sfvb_themes_with_http_info(storefront_oid)
+> <Array(<SfvbFileWriteResponse>, Integer, Hash)> put_sfvb_file_content_with_http_info(storefront_oid, if_match, file_write_request, opts)
 
 ```ruby
 begin
-  # List themes for a storefront
-  data, status_code, headers = api_instance.list_sfvb_themes_with_http_info(storefront_oid)
+  # Write a storefront file
+  data, status_code, headers = api_instance.put_sfvb_file_content_with_http_info(storefront_oid, if_match, file_write_request, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbThemesResponse>
+  p data # => <SfvbFileWriteResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->list_sfvb_themes_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->put_sfvb_file_content_with_http_info: #{e}"
 end
 ```
 
@@ -2602,10 +3627,13 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
+| **if_match** | **String** | Content hash from the last read.  Required; 428 when absent, 412 when stale. |  |
+| **file_write_request** | [**SfvbFileWriteRequest**](SfvbFileWriteRequest.md) | File content to write |  |
+| **path** | **String** |  | [optional] |
 
 ### Return type
 
-[**SfvbThemesResponse**](SfvbThemesResponse.md)
+[**SfvbFileWriteResponse**](SfvbFileWriteResponse.md)
 
 ### Authorization
 
@@ -2613,17 +3641,17 @@ end
 
 ### HTTP request headers
 
-- **Content-Type**: Not defined
+- **Content-Type**: application/json
 - **Accept**: application/json
 
 
-## list_sfvb_upsell_offers
+## put_sfvb_item_attributes
 
-> <SfvbUpsellOffersResponse> list_sfvb_upsell_offers(storefront_oid)
+> <SfvbItemResponse> put_sfvb_item_attributes(storefront_oid, item_attribute_update_request, opts)
 
-List upsell offers
+Change some of an item's attributes
 
-Without container JSON, so the funnel can be surveyed cheaply.  A large container size alongside a small element count is the signature of markup pasted into a single html element. 
+Partial - only the attributes named change, and an empty value empties one but keeps it on the item.  To remove an attribute no template declares, use the attribute DELETE.  Every entry is validated before any is written, so a refusal leaves the item untouched.  The list types are checked against the shape their renderer actually parses, which matters more than it sounds: a definition list is a bare array with one letter keys, a video list is a wrapper object with keys spelled out, and an item set is comma separated text rather than JSON.  A shape the renderer cannot read is not reported at render time - it renders exactly like an attribute nobody ever set. 
 
 
 ### Examples
@@ -2632,21 +3660,21 @@ Without container JSON, so the funnel can be surveyed cheaply.  A large containe
 (No example for this operation).
 
 
-#### Using the list_sfvb_upsell_offers_with_http_info variant
+#### Using the put_sfvb_item_attributes_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbUpsellOffersResponse>, Integer, Hash)> list_sfvb_upsell_offers_with_http_info(storefront_oid)
+> <Array(<SfvbItemResponse>, Integer, Hash)> put_sfvb_item_attributes_with_http_info(storefront_oid, item_attribute_update_request, opts)
 
 ```ruby
 begin
-  # List upsell offers
-  data, status_code, headers = api_instance.list_sfvb_upsell_offers_with_http_info(storefront_oid)
+  # Change some of an item's attributes
+  data, status_code, headers = api_instance.put_sfvb_item_attributes_with_http_info(storefront_oid, item_attribute_update_request, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbUpsellOffersResponse>
+  p data # => <SfvbItemResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->list_sfvb_upsell_offers_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->put_sfvb_item_attributes_with_http_info: #{e}"
 end
 ```
 
@@ -2655,10 +3683,13 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
+| **item_attribute_update_request** | [**SfvbItemAttributeUpdateRequest**](SfvbItemAttributeUpdateRequest.md) | Attributes to change |  |
+| **merchant_item_id** | **String** |  | [optional] |
+| **merchant_item_oid** | **Integer** |  | [optional] |
 
 ### Return type
 
-[**SfvbUpsellOffersResponse**](SfvbUpsellOffersResponse.md)
+[**SfvbItemResponse**](SfvbItemResponse.md)
 
 ### Authorization
 
@@ -2666,17 +3697,17 @@ end
 
 ### HTTP request headers
 
-- **Content-Type**: Not defined
+- **Content-Type**: application/json
 - **Accept**: application/json
 
 
-## put_sfvb_container
+## put_sfvb_item_content
 
-> <SfvbContainerResponse> put_sfvb_container(storefront_oid, owner_type, owner_object_id, if_match, container_write_request, opts)
+> <SfvbItemResponse> put_sfvb_item_content(storefront_oid, item_content_request, opts)
 
-Write a container stored outside the file system
+Change an item's title or long description
 
-Validation is mandatory and runs here regardless of whether the caller validated first.  The previous value is snapshotted before the write, so the change can be reverted.  Side effects the visual builder performs on save, such as upsell screenshot regeneration and email content review flagging, are applied too.  owner_type also says how owner_object_id is read; send itemid to address an item container by merchant item id rather than by oid.  Either way the history records the one canonical address, so a container written under one spelling is listed and reverted under the other. 
+Partial - a field left out is untouched, a field sent empty is cleared, and those are different things.  These are what itemtitle and itemdescription render.  Writing the matching config keys into a container does nothing, because they are dialog buffers bound to the item and the render never reads them.  Both are the catalog's own fields, so a change here reaches the item everywhere, not only on this storefront. 
 
 
 ### Examples
@@ -2685,21 +3716,21 @@ Validation is mandatory and runs here regardless of whether the caller validated
 (No example for this operation).
 
 
-#### Using the put_sfvb_container_with_http_info variant
+#### Using the put_sfvb_item_content_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbContainerResponse>, Integer, Hash)> put_sfvb_container_with_http_info(storefront_oid, owner_type, owner_object_id, if_match, container_write_request, opts)
+> <Array(<SfvbItemResponse>, Integer, Hash)> put_sfvb_item_content_with_http_info(storefront_oid, item_content_request, opts)
 
 ```ruby
 begin
-  # Write a container stored outside the file system
-  data, status_code, headers = api_instance.put_sfvb_container_with_http_info(storefront_oid, owner_type, owner_object_id, if_match, container_write_request, opts)
+  # Change an item's title or long description
+  data, status_code, headers = api_instance.put_sfvb_item_content_with_http_info(storefront_oid, item_content_request, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbContainerResponse>
+  p data # => <SfvbItemResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->put_sfvb_container_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->put_sfvb_item_content_with_http_info: #{e}"
 end
 ```
 
@@ -2708,15 +3739,13 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **owner_type** | **String** |  |  |
-| **owner_object_id** | **String** |  |  |
-| **if_match** | **String** | CJSON hash from the last read.  Required; 428 when absent, 412 when stale. |  |
-| **container_write_request** | [**SfvbContainerWriteRequest**](SfvbContainerWriteRequest.md) | Container CJSON to write |  |
-| **container_name** | **String** |  | [optional] |
+| **item_content_request** | [**SfvbItemContentRequest**](SfvbItemContentRequest.md) | Title and description to change |  |
+| **merchant_item_id** | **String** |  | [optional] |
+| **merchant_item_oid** | **Integer** |  | [optional] |
 
 ### Return type
 
-[**SfvbContainerResponse**](SfvbContainerResponse.md)
+[**SfvbItemResponse**](SfvbItemResponse.md)
 
 ### Authorization
 
@@ -2728,13 +3757,13 @@ end
 - **Accept**: application/json
 
 
-## put_sfvb_experiment_variation
+## put_sfvb_item_multimedia
 
-> <SfvbExperiment> put_sfvb_experiment_variation(storefront_oid, experiment_oid, variation_number, experiment_variation_update_request)
+> <SfvbItemResponse> put_sfvb_item_multimedia(storefront_oid, item_multimedia_request, opts)
 
-Pause or resume a variation
+Attach an image to an item
 
-Stops or resumes sending new visitors to one variation of a running experiment.  Visitors already assigned keep seeing it.  Variation 0 cannot be paused, because the split falls back to it, and the last variation still receiving visitors cannot be paused.  Always needs sfvb_publish. 
+One slot at a time - the default image or one code - and every other image on the item is left alone.  That is the difference from the item API, where images are reachable only through a full item update whose multimedia array is reconciled destructively, so adding one means resending the rest or losing them.  Upload the file with files/upload first and name its storefront path here; unlike a page image it does not have to live in any particular folder, because the bytes are copied into the item's own storage on attach. 
 
 
 ### Examples
@@ -2743,21 +3772,21 @@ Stops or resumes sending new visitors to one variation of a running experiment.
 (No example for this operation).
 
 
-#### Using the put_sfvb_experiment_variation_with_http_info variant
+#### Using the put_sfvb_item_multimedia_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbExperiment>, Integer, Hash)> put_sfvb_experiment_variation_with_http_info(storefront_oid, experiment_oid, variation_number, experiment_variation_update_request)
+> <Array(<SfvbItemResponse>, Integer, Hash)> put_sfvb_item_multimedia_with_http_info(storefront_oid, item_multimedia_request, opts)
 
 ```ruby
 begin
-  # Pause or resume a variation
-  data, status_code, headers = api_instance.put_sfvb_experiment_variation_with_http_info(storefront_oid, experiment_oid, variation_number, experiment_variation_update_request)
+  # Attach an image to an item
+  data, status_code, headers = api_instance.put_sfvb_item_multimedia_with_http_info(storefront_oid, item_multimedia_request, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbExperiment>
+  p data # => <SfvbItemResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->put_sfvb_experiment_variation_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->put_sfvb_item_multimedia_with_http_info: #{e}"
 end
 ```
 
@@ -2766,13 +3795,13 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **experiment_oid** | **Integer** |  |  |
-| **variation_number** | **Integer** |  |  |
-| **experiment_variation_update_request** | [**SfvbExperimentVariationUpdateRequest**](SfvbExperimentVariationUpdateRequest.md) | Pause or resume |  |
+| **item_multimedia_request** | [**SfvbItemMultimediaRequest**](SfvbItemMultimediaRequest.md) | Image to attach |  |
+| **merchant_item_id** | **String** |  | [optional] |
+| **merchant_item_oid** | **Integer** |  | [optional] |
 
 ### Return type
 
-[**SfvbExperiment**](SfvbExperiment.md)
+[**SfvbItemResponse**](SfvbItemResponse.md)
 
 ### Authorization
 
@@ -2780,17 +3809,17 @@ end
 
 ### HTTP request headers
 
-- **Content-Type**: application/json; charset=UTF-8
+- **Content-Type**: application/json
 - **Accept**: application/json
 
 
-## put_sfvb_file_content
+## put_sfvb_item_seo
 
-> <SfvbFileWriteResponse> put_sfvb_file_content(storefront_oid, if_match, file_write_request, opts)
+> <SfvbItemResponse> put_sfvb_item_seo(storefront_oid, item_seo_request, opts)
 
-Write a storefront file
+Change an item's search metadata
 
-Runs the template sandbox, Velocity validation and the internationalization check, records a version, and compiles the sibling .vm when the file is a .cjson under a theme.  Send If-Match with the hash from the last read to avoid clobbering a concurrent change.  Writing into the active theme requires sfvb_publish. 
+Partial - a field left out is untouched, a field sent empty is cleared and the page falls back to what it fell back to before.  Underneath these are three item attributes with reserved names, so this and the attributes endpoint reach the same storage; it exists separately because the names are not discoverable from the templates.  Two things worth knowing.  A title set here changes the document title only - og:title and twitter:title render the item's description either way.  And there is no canonical or noindex field, because both are site wide switches rather than per item values. 
 
 
 ### Examples
@@ -2799,21 +3828,21 @@ Runs the template sandbox, Velocity validation and the internationalization chec
 (No example for this operation).
 
 
-#### Using the put_sfvb_file_content_with_http_info variant
+#### Using the put_sfvb_item_seo_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SfvbFileWriteResponse>, Integer, Hash)> put_sfvb_file_content_with_http_info(storefront_oid, if_match, file_write_request, opts)
+> <Array(<SfvbItemResponse>, Integer, Hash)> put_sfvb_item_seo_with_http_info(storefront_oid, item_seo_request, opts)
 
 ```ruby
 begin
-  # Write a storefront file
-  data, status_code, headers = api_instance.put_sfvb_file_content_with_http_info(storefront_oid, if_match, file_write_request, opts)
+  # Change an item's search metadata
+  data, status_code, headers = api_instance.put_sfvb_item_seo_with_http_info(storefront_oid, item_seo_request, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SfvbFileWriteResponse>
+  p data # => <SfvbItemResponse>
 rescue UltracartClient::ApiError => e
-  puts "Error when calling SfvbApi->put_sfvb_file_content_with_http_info: #{e}"
+  puts "Error when calling SfvbApi->put_sfvb_item_seo_with_http_info: #{e}"
 end
 ```
 
@@ -2822,13 +3851,13 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
-| **if_match** | **String** | Content hash from the last read.  Required; 428 when absent, 412 when stale. |  |
-| **file_write_request** | [**SfvbFileWriteRequest**](SfvbFileWriteRequest.md) | File content to write |  |
-| **path** | **String** |  | [optional] |
+| **item_seo_request** | [**SfvbItemSeoRequest**](SfvbItemSeoRequest.md) | Search metadata to change |  |
+| **merchant_item_id** | **String** |  | [optional] |
+| **merchant_item_oid** | **Integer** |  | [optional] |
 
 ### Return type
 
-[**SfvbFileWriteResponse**](SfvbFileWriteResponse.md)
+[**SfvbItemResponse**](SfvbItemResponse.md)
 
 ### Authorization
 
@@ -3778,6 +4807,172 @@ end
 - **Accept**: application/json
 
 
+## unarchive_sfvb_upsell_path
+
+> <SfvbUpsellPath> unarchive_sfvb_upsell_path(storefront_oid, upsell_path_oid)
+
+Unarchive an upsell path
+
+Brings the path back into the default list.  Unarchiving one that is switched on starts it, so that needs sfvb_publish. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the unarchive_sfvb_upsell_path_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbUpsellPath>, Integer, Hash)> unarchive_sfvb_upsell_path_with_http_info(storefront_oid, upsell_path_oid)
+
+```ruby
+begin
+  # Unarchive an upsell path
+  data, status_code, headers = api_instance.unarchive_sfvb_upsell_path_with_http_info(storefront_oid, upsell_path_oid)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbUpsellPath>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->unarchive_sfvb_upsell_path_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **upsell_path_oid** | **Integer** |  |  |
+
+### Return type
+
+[**SfvbUpsellPath**](SfvbUpsellPath.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## update_sfvb_upsell_offer
+
+> <SfvbUpsellOffer> update_sfvb_upsell_offer(storefront_oid, upsell_offer_oid, if_match, upsell_offer)
+
+Update an upsell offer
+
+A full replace.  Send back the whole offer you read, changed, with its hash_sha256 in If-Match.  Read only fields are ignored and a writable field left out is cleared.  Changing an offer that is switched on, switching one on, or changing upsell_item_id_javascript or offsite_content_url needs sfvb_publish.  Settings the API does not show, such as the offer's screenshots, are kept. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the update_sfvb_upsell_offer_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbUpsellOffer>, Integer, Hash)> update_sfvb_upsell_offer_with_http_info(storefront_oid, upsell_offer_oid, if_match, upsell_offer)
+
+```ruby
+begin
+  # Update an upsell offer
+  data, status_code, headers = api_instance.update_sfvb_upsell_offer_with_http_info(storefront_oid, upsell_offer_oid, if_match, upsell_offer)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbUpsellOffer>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->update_sfvb_upsell_offer_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **upsell_offer_oid** | **Integer** |  |  |
+| **if_match** | **String** | hash_sha256 from the last read.  Required; 428 when absent, 412 when stale. |  |
+| **upsell_offer** | [**SfvbUpsellOffer**](SfvbUpsellOffer.md) | The whole offer |  |
+
+### Return type
+
+[**SfvbUpsellOffer**](SfvbUpsellOffer.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json; charset=UTF-8
+- **Accept**: application/json
+
+
+## update_sfvb_upsell_path
+
+> <SfvbUpsellPath> update_sfvb_upsell_path(storefront_oid, upsell_path_oid, if_match, upsell_path)
+
+Update an upsell path
+
+A full replace.  Send back the whole path you read, changed, with its hash_sha256 in If-Match.  Read only fields are ignored and a writable field left out is cleared.  Order and archived keep their stored values; change them with the move, archive and unarchive calls.  Changing a running path, or switching one on, needs sfvb_publish. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the update_sfvb_upsell_path_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbUpsellPath>, Integer, Hash)> update_sfvb_upsell_path_with_http_info(storefront_oid, upsell_path_oid, if_match, upsell_path)
+
+```ruby
+begin
+  # Update an upsell path
+  data, status_code, headers = api_instance.update_sfvb_upsell_path_with_http_info(storefront_oid, upsell_path_oid, if_match, upsell_path)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbUpsellPath>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->update_sfvb_upsell_path_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **upsell_path_oid** | **Integer** |  |  |
+| **if_match** | **String** | hash_sha256 from the last read.  Required; 428 when absent, 412 when stale. |  |
+| **upsell_path** | [**SfvbUpsellPath**](SfvbUpsellPath.md) | The whole path |  |
+
+### Return type
+
+[**SfvbUpsellPath**](SfvbUpsellPath.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json; charset=UTF-8
+- **Accept**: application/json
+
+
 ## upload_sfvb_file
 
 > <SfvbFileWriteResponse> upload_sfvb_file(storefront_oid, file_upload_request, opts)