ultracart_api 4.1.143 → 4.1.144

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 54ade983866a0b9b2b6cee229755b5822f1af894ce784427515055fa35af03ba
-  data.tar.gz: 45d7d529bfccac5c15c2c0e81861fd831d38b433b24803c570d81e8288eb7d95
+  metadata.gz: 13b9d39d06ac6b0264998815c54095b46e5f2937017216b655170327a16c8fec
+  data.tar.gz: e6dc9b0d31c8b1406bb234d666668b21ab36ec5ea897ff32df8a845784e62af6
 SHA512:
-  metadata.gz: 6b79c1bf97aafa3e69a280935ef778fb955a4688cb59cb23f70ba5b2bad743a19c9c700371e14fed6257a6e3a16367e2ba0c1e1267723bcaffa8e4de5b0058a6
-  data.tar.gz: 748a3308394172826f99191041a51e5cff02a8d49d945d6fe8a72680f3541c257ffe1436026541c801cf82a85158ae7d376830511ce1f374b09763e28bbc23b8
+  metadata.gz: 7898973f5918fa512d645190944553db8e00efddab71b7ad128647e234decdb4f1cb40604f7844ca92e02d28bfd2ade4b3cae38e12c9696a6fb915142f5042b1
+  data.tar.gz: 2dcfdb984be83191ad63ba1e1d0f7e79155cb7ddaa7bc16e918a9ec77395b93636153c8e82b98e6682c186d36717ba5de9ad22f8bcdb290045c55e3195353c7c

data/README.md

@@ -7,7 +7,7 @@ Note: Every method has a sample for every language.  See https://github.com/Ultr
 This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: 2.0.0
-- Package version: 4.1.143
+- Package version: 4.1.144
 - Build package: org.openapitools.codegen.languages.RubyClientCodegen
 - For more information, please visit [http://www.ultracart.com/api/](http://www.ultracart.com/api/)
 
@@ -16,7 +16,7 @@ This SDK is automatically generated by the [OpenAPI Generator](https://openapi-g
 gemfile:
 
 ```shell
-gem 'ultracart_api', '4.1.143'
+gem 'ultracart_api', '4.1.144'
 ```
 
 install:
@@ -474,12 +474,14 @@ Class | Method | HTTP request | Description
 *UltracartClient::SfvbApi* | [**create_sfvb_preview_session**](docs/SfvbApi.md#create_sfvb_preview_session) | **POST** /sfvb/storefronts/{storefront_oid}/preview_sessions | Create a preview session
 *UltracartClient::SfvbApi* | [**delete_sfvb_file**](docs/SfvbApi.md#delete_sfvb_file) | **DELETE** /sfvb/storefronts/{storefront_oid}/files | Delete a storefront file
 *UltracartClient::SfvbApi* | [**delete_sfvb_preview_session**](docs/SfvbApi.md#delete_sfvb_preview_session) | **DELETE** /sfvb/storefronts/{storefront_oid}/preview_sessions/{preview_session_id} | Delete a preview session
+*UltracartClient::SfvbApi* | [**download_sfvb_file**](docs/SfvbApi.md#download_sfvb_file) | **GET** /sfvb/storefronts/{storefront_oid}/files/download | Read a storefront file's raw bytes
 *UltracartClient::SfvbApi* | [**duplicate_sfvb_theme**](docs/SfvbApi.md#duplicate_sfvb_theme) | **POST** /sfvb/storefronts/{storefront_oid}/themes/{theme_oid}/duplicate | Duplicate a theme
 *UltracartClient::SfvbApi* | [**get_sfvb_cjson_used_elements**](docs/SfvbApi.md#get_sfvb_cjson_used_elements) | **POST** /sfvb/cjson/elements | Element types used by a container
 *UltracartClient::SfvbApi* | [**get_sfvb_container**](docs/SfvbApi.md#get_sfvb_container) | **GET** /sfvb/storefronts/{storefront_oid}/containers/{owner_type}/{owner_object_id} | Read a container stored outside the file system
 *UltracartClient::SfvbApi* | [**get_sfvb_container_version**](docs/SfvbApi.md#get_sfvb_container_version) | **GET** /sfvb/storefronts/{storefront_oid}/container_versions/{container_history_oid} | Read the CJSON stored in one container history entry
 *UltracartClient::SfvbApi* | [**get_sfvb_element**](docs/SfvbApi.md#get_sfvb_element) | **GET** /sfvb/elements/{element_type} | Configuration schema for one element type
 *UltracartClient::SfvbApi* | [**get_sfvb_file_content**](docs/SfvbApi.md#get_sfvb_file_content) | **GET** /sfvb/storefronts/{storefront_oid}/files/content | Read a storefront file
+*UltracartClient::SfvbApi* | [**get_sfvb_file_upload_url**](docs/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
 *UltracartClient::SfvbApi* | [**get_sfvb_library_entry**](docs/SfvbApi.md#get_sfvb_library_entry) | **GET** /sfvb/storefronts/{storefront_oid}/library/{library_oid} | Read one library entry including its CJSON
 *UltracartClient::SfvbApi* | [**get_sfvb_preview_url**](docs/SfvbApi.md#get_sfvb_preview_url) | **GET** /sfvb/storefronts/{storefront_oid}/preview_sessions/{preview_session_id}/url | URL that renders a preview session
 *UltracartClient::SfvbApi* | [**get_sfvb_theme**](docs/SfvbApi.md#get_sfvb_theme) | **GET** /sfvb/storefronts/{storefront_oid}/themes/{theme_oid} | Get a theme
@@ -503,6 +505,7 @@ Class | Method | HTTP request | Description
 *UltracartClient::SfvbApi* | [**revert_sfvb_file**](docs/SfvbApi.md#revert_sfvb_file) | **POST** /sfvb/storefronts/{storefront_oid}/files/revert | Revert a storefront file to an earlier version
 *UltracartClient::SfvbApi* | [**search_sfvb_files**](docs/SfvbApi.md#search_sfvb_files) | **POST** /sfvb/storefronts/{storefront_oid}/files/search | Search storefront files
 *UltracartClient::SfvbApi* | [**search_sfvb_library**](docs/SfvbApi.md#search_sfvb_library) | **GET** /sfvb/storefronts/{storefront_oid}/library | Search the element library
+*UltracartClient::SfvbApi* | [**upload_sfvb_file**](docs/SfvbApi.md#upload_sfvb_file) | **POST** /sfvb/storefronts/{storefront_oid}/files/upload | Store a binary asset that was already uploaded
 *UltracartClient::SfvbApi* | [**validate_sfvb_cjson**](docs/SfvbApi.md#validate_sfvb_cjson) | **POST** /sfvb/cjson/validate | Validate CJSON
 *UltracartClient::SfvbApi* | [**validate_sfvb_velocity**](docs/SfvbApi.md#validate_sfvb_velocity) | **POST** /sfvb/storefronts/{storefront_oid}/themes/{theme_oid}/velocity/validate | Validate a Velocity template against a theme
 *UltracartClient::SsoApi* | [**get_sso_session_user**](docs/SsoApi.md#get_sso_session_user) | **GET** /sso/session/user | Get single sign on session user
@@ -1732,6 +1735,8 @@ Class | Method | HTTP request | Description
  - [UltracartClient::SfvbFileRevertRequest](docs/SfvbFileRevertRequest.md)
  - [UltracartClient::SfvbFileSearchRequest](docs/SfvbFileSearchRequest.md)
  - [UltracartClient::SfvbFileSearchResponse](docs/SfvbFileSearchResponse.md)
+ - [UltracartClient::SfvbFileUploadRequest](docs/SfvbFileUploadRequest.md)
+ - [UltracartClient::SfvbFileUploadUrlResponse](docs/SfvbFileUploadUrlResponse.md)
  - [UltracartClient::SfvbFileVersion](docs/SfvbFileVersion.md)
  - [UltracartClient::SfvbFileVersionsResponse](docs/SfvbFileVersionsResponse.md)
  - [UltracartClient::SfvbFileWriteRequest](docs/SfvbFileWriteRequest.md)
@@ -1922,6 +1927,7 @@ Not every change is committed to every SDK.
 
 | Version | Date | Comments |
 | --: | :-: | --- |
+| 4.1.144 | 09/02/2026 | sfvb - internal testing |
 | 4.1.143 | 09/02/2026 | sfvb - internal development |
 | 4.1.142 | 08/26/2026 | sfvb - internal test |
 | 4.1.141 | 08/26/2026 | sfvb - internal testing |

data/docs/SfvbApi.md

@@ -8,12 +8,14 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
 | [**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_preview_session**](SfvbApi.md#delete_sfvb_preview_session) | **DELETE** /sfvb/storefronts/{storefront_oid}/preview_sessions/{preview_session_id} | Delete a preview session |
+| [**download_sfvb_file**](SfvbApi.md#download_sfvb_file) | **GET** /sfvb/storefronts/{storefront_oid}/files/download | Read a storefront file's raw bytes |
 | [**duplicate_sfvb_theme**](SfvbApi.md#duplicate_sfvb_theme) | **POST** /sfvb/storefronts/{storefront_oid}/themes/{theme_oid}/duplicate | Duplicate a theme |
 | [**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 |
 | [**get_sfvb_container_version**](SfvbApi.md#get_sfvb_container_version) | **GET** /sfvb/storefronts/{storefront_oid}/container_versions/{container_history_oid} | Read the CJSON stored in one container history entry |
 | [**get_sfvb_element**](SfvbApi.md#get_sfvb_element) | **GET** /sfvb/elements/{element_type} | Configuration schema for one element type |
 | [**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_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_preview_url**](SfvbApi.md#get_sfvb_preview_url) | **GET** /sfvb/storefronts/{storefront_oid}/preview_sessions/{preview_session_id}/url | URL that renders a preview session |
 | [**get_sfvb_theme**](SfvbApi.md#get_sfvb_theme) | **GET** /sfvb/storefronts/{storefront_oid}/themes/{theme_oid} | Get a theme |
@@ -37,6 +39,7 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
 | [**revert_sfvb_file**](SfvbApi.md#revert_sfvb_file) | **POST** /sfvb/storefronts/{storefront_oid}/files/revert | Revert a storefront file to an earlier version |
 | [**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 |
+| [**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 |
 
@@ -256,6 +259,60 @@ nil (empty response body)
 - **Accept**: application/json
 
 
+## download_sfvb_file
+
+> download_sfvb_file(storefront_oid, opts)
+
+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
+
+
+(No example for this operation).
+
+
+#### Using the download_sfvb_file_with_http_info variant
+
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
+
+> <Array(nil, Integer, Hash)> download_sfvb_file_with_http_info(storefront_oid, 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)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->download_sfvb_file_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **path** | **String** |  | [optional] |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/octet-stream
+
+
 ## duplicate_sfvb_theme
 
 > <SfvbThemeJobResponse> duplicate_sfvb_theme(storefront_oid, theme_oid, duplicate_request)
@@ -532,7 +589,7 @@ end
 
 Read a storefront file
 
-Returns the current content, or an earlier version when version is supplied.  The content hash is returned as an ETag; send it back as If-Match when writing. 
+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
@@ -581,6 +638,60 @@ end
 - **Accept**: application/json
 
 
+## get_sfvb_file_upload_url
+
+> <SfvbFileUploadUrlResponse> get_sfvb_file_upload_url(storefront_oid, extension)
+
+Get a URL to upload a binary asset to
+
+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
+
+
+(No example for this operation).
+
+
+#### 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(<SfvbFileUploadUrlResponse>, Integer, Hash)> get_sfvb_file_upload_url_with_http_info(storefront_oid, extension)
+
+```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)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbFileUploadUrlResponse>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->get_sfvb_file_upload_url_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **extension** | **String** |  |  |
+
+### Return type
+
+[**SfvbFileUploadUrlResponse**](SfvbFileUploadUrlResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## get_sfvb_library_entry
 
 > <SfvbLibraryEntry> get_sfvb_library_entry(storefront_oid, library_oid)
@@ -1824,6 +1935,61 @@ end
 - **Accept**: application/json
 
 
+## upload_sfvb_file
+
+> <SfvbFileWriteResponse> upload_sfvb_file(storefront_oid, file_upload_request, opts)
+
+Store a binary asset that was already uploaded
+
+The second half of the two step upload.  The bytes are fetched from the key, checked against the extension they claim to be, and written exactly as a text write is - so the same If-Match precondition, the same read only refusal and the same publish gate apply.  An SVG is sanitized before it is stored.  Writing outside /themes/ requires sfvb_publish, because anything served off the storefront root is live by definition. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the upload_sfvb_file_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbFileWriteResponse>, Integer, Hash)> upload_sfvb_file_with_http_info(storefront_oid, file_upload_request, opts)
+
+```ruby
+begin
+  # Store a binary asset that was already uploaded
+  data, status_code, headers = api_instance.upload_sfvb_file_with_http_info(storefront_oid, file_upload_request, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbFileWriteResponse>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->upload_sfvb_file_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **file_upload_request** | [**SfvbFileUploadRequest**](SfvbFileUploadRequest.md) | Where to store the uploaded bytes |  |
+| **if_match** | **String** | Content hash from the last read.  Required when the file already exists; 428 when absent, 412 when stale. | [optional] |
+
+### Return type
+
+[**SfvbFileWriteResponse**](SfvbFileWriteResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## validate_sfvb_cjson
 
 > <SfvbValidationResponse> validate_sfvb_cjson(validate_request)

data/docs/SfvbFileContentResponse.md

@@ -7,7 +7,7 @@
 | **auto_compiled** | **Boolean** | True when this file is compiler output and must not be edited directly. | [optional] |
 | **content** | **String** | UTF-8 content.  Only text/* files can be read this way. | [optional] |
 | **fs_file_oid** | **Integer** | StoreFront file system file oid. | [optional] |
-| **hash_sha256** | **String** | SHA-256 of the content.  Also returned as the ETag header; send it back as If-Match when writing. | [optional] |
+| **hash_sha256** | **String** | SHA-256 of the content.  Send this 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 this body value is the authoritative one.  Both forms are accepted on write. | [optional] |
 | **mime_type** | **String** | Mime type. | [optional] |
 | **path** | **String** | Full path of the file. | [optional] |
 | **size** | **Integer** | Size in bytes. | [optional] |

data/docs/SfvbFileUploadRequest.md

@@ -0,0 +1,24 @@
+# UltracartClient::SfvbFileUploadRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **comment** | **String** | Optional comment recorded against the version this write creates. | [optional] |
+| **create_if_missing** | **Boolean** | Create the file if it does not exist.  Defaults to true. | [optional] |
+| **key** | **String** | The key returned when the upload URL was issued. | [optional] |
+| **path** | **String** | Storefront path to write, for example /assets/imgs/hero.jpg.  The extension must match the one the upload URL was issued for, and must match the bytes. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbFileUploadRequest.new(
+  comment: null,
+  create_if_missing: null,
+  key: null,
+  path: null
+)
+```
+

data/docs/SfvbFileUploadUrlResponse.md

@@ -0,0 +1,24 @@
+# UltracartClient::SfvbFileUploadUrlResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **expires_in_seconds** | **Integer** | Seconds until the upload URL stops working.  Ask for a new one rather than holding this across a long job. | [optional] |
+| **http_method** | **String** | HTTP method the upload URL expects. | [optional] |
+| **key** | **String** | Quote this back to the upload endpoint once the bytes are in place.  It identifies the uploaded object and is bound to your account. | [optional] |
+| **upload_url** | **String** | Send the raw bytes to this URL.  It is short lived and single use, and it is not part of this API - do not send an Authorization header with it. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbFileUploadUrlResponse.new(
+  expires_in_seconds: null,
+  http_method: null,
+  key: null,
+  upload_url: null
+)
+```
+

data/docs/SfvbFileWriteResponse.md

@@ -7,6 +7,7 @@
 | **compiled_path** | **String** | Path of the compiled output, when writing a .cjson under a theme triggered a compile. | [optional] |
 | **file** | [**SfvbFileEntry**](SfvbFileEntry.md) |  | [optional] |
 | **hash_sha256** | **String** | New SHA-256.  Use as the next If-Match value. | [optional] |
+| **public_url** | **String** | Where a shopper's browser will fetch this file, for use in an img src or a background image.  Present only for a path outside /themes/, which is served straight off the storefront root.  A file inside a theme is absent here because its public URL depends on which theme is active, and guessing it would be worse than omitting it. | [optional] |
 | **validation** | [**SfvbValidationResponse**](SfvbValidationResponse.md) |  | [optional] |
 | **velocity_errors** | **String** | Velocity errors recorded by the store.  Present means the file was written but is not valid. | [optional] |
 | **version** | **Integer** | New version number. | [optional] |
@@ -20,6 +21,7 @@ instance = UltracartClient::SfvbFileWriteResponse.new(
   compiled_path: null,
   file: null,
   hash_sha256: null,
+  public_url: null,
   validation: null,
   velocity_errors: null,
   version: null

data/lib/ultracart_api/api/sfvb_api.rb

@@ -309,6 +309,73 @@ module UltracartClient
       return data, status_code, headers
     end
 
+    # 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. 
+    # @param storefront_oid [Integer] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :path 
+    # @return [nil]
+    def download_sfvb_file(storefront_oid, opts = {})
+      download_sfvb_file_with_http_info(storefront_oid, opts)
+      nil
+    end
+
+    # 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. 
+    # @param storefront_oid [Integer] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :path 
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def download_sfvb_file_with_http_info(storefront_oid, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SfvbApi.download_sfvb_file ...'
+      end
+      # verify the required parameter 'storefront_oid' is set
+      if @api_client.config.client_side_validation && storefront_oid.nil?
+        fail ArgumentError, "Missing the required parameter 'storefront_oid' when calling SfvbApi.download_sfvb_file"
+      end
+      # resource path
+      local_var_path = '/sfvb/storefronts/{storefront_oid}/files/download'.sub('{' + 'storefront_oid' + '}', CGI.escape(storefront_oid.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'path'] = opts[:'path'] if !opts[:'path'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      header_params['X-UltraCart-Api-Version'] = @api_client.select_header_api_version()
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/octet-stream'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ultraCartOauth', 'ultraCartSimpleApiKey']
+
+      new_options = opts.merge(
+        :operation => :"SfvbApi.download_sfvb_file",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SfvbApi#download_sfvb_file\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Duplicate a theme
     # 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. 
     # @param storefront_oid [Integer] 
@@ -678,7 +745,7 @@ module UltracartClient
     end
 
     # Read a storefront file
-    # Returns the current content, or an earlier version when version is supplied.  The content hash is returned as an ETag; send it back as If-Match when writing. 
+    # 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. 
     # @param storefront_oid [Integer] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :path 
@@ -690,7 +757,7 @@ module UltracartClient
     end
 
     # Read a storefront file
-    # Returns the current content, or an earlier version when version is supplied.  The content hash is returned as an ETag; send it back as If-Match when writing. 
+    # Returns the current content, or an earlier version when version is supplied.  Send the body&#39;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. 
     # @param storefront_oid [Integer] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :path 
@@ -747,6 +814,76 @@ module UltracartClient
       return data, status_code, headers
     end
 
+    # Get a URL to upload a binary asset to
+    # 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. 
+    # @param storefront_oid [Integer] 
+    # @param extension [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [SfvbFileUploadUrlResponse]
+    def get_sfvb_file_upload_url(storefront_oid, extension, opts = {})
+      data, _status_code, _headers = get_sfvb_file_upload_url_with_http_info(storefront_oid, extension, opts)
+      data
+    end
+
+    # Get a URL to upload a binary asset to
+    # 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. 
+    # @param storefront_oid [Integer] 
+    # @param extension [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SfvbFileUploadUrlResponse, Integer, Hash)>] SfvbFileUploadUrlResponse data, response status code and response headers
+    def get_sfvb_file_upload_url_with_http_info(storefront_oid, extension, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SfvbApi.get_sfvb_file_upload_url ...'
+      end
+      # verify the required parameter 'storefront_oid' is set
+      if @api_client.config.client_side_validation && storefront_oid.nil?
+        fail ArgumentError, "Missing the required parameter 'storefront_oid' when calling SfvbApi.get_sfvb_file_upload_url"
+      end
+      # verify the required parameter 'extension' is set
+      if @api_client.config.client_side_validation && extension.nil?
+        fail ArgumentError, "Missing the required parameter 'extension' when calling SfvbApi.get_sfvb_file_upload_url"
+      end
+      # resource path
+      local_var_path = '/sfvb/storefronts/{storefront_oid}/files/upload_url/{extension}'.sub('{' + 'storefront_oid' + '}', CGI.escape(storefront_oid.to_s)).sub('{' + 'extension' + '}', CGI.escape(extension.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      header_params['X-UltraCart-Api-Version'] = @api_client.select_header_api_version()
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SfvbFileUploadUrlResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ultraCartOauth', 'ultraCartSimpleApiKey']
+
+      new_options = opts.merge(
+        :operation => :"SfvbApi.get_sfvb_file_upload_url",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SfvbApi#get_sfvb_file_upload_url\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Read one library entry including its CJSON
     # 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. 
     # @param storefront_oid [Integer] 
@@ -2412,6 +2549,84 @@ module UltracartClient
       return data, status_code, headers
     end
 
+    # Store a binary asset that was already uploaded
+    # The second half of the two step upload.  The bytes are fetched from the key, checked against the extension they claim to be, and written exactly as a text write is - so the same If-Match precondition, the same read only refusal and the same publish gate apply.  An SVG is sanitized before it is stored.  Writing outside /themes/ requires sfvb_publish, because anything served off the storefront root is live by definition. 
+    # @param storefront_oid [Integer] 
+    # @param file_upload_request [SfvbFileUploadRequest] Where to store the uploaded bytes
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :if_match Content hash from the last read.  Required when the file already exists; 428 when absent, 412 when stale.
+    # @return [SfvbFileWriteResponse]
+    def upload_sfvb_file(storefront_oid, file_upload_request, opts = {})
+      data, _status_code, _headers = upload_sfvb_file_with_http_info(storefront_oid, file_upload_request, opts)
+      data
+    end
+
+    # Store a binary asset that was already uploaded
+    # The second half of the two step upload.  The bytes are fetched from the key, checked against the extension they claim to be, and written exactly as a text write is - so the same If-Match precondition, the same read only refusal and the same publish gate apply.  An SVG is sanitized before it is stored.  Writing outside /themes/ requires sfvb_publish, because anything served off the storefront root is live by definition. 
+    # @param storefront_oid [Integer] 
+    # @param file_upload_request [SfvbFileUploadRequest] Where to store the uploaded bytes
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :if_match Content hash from the last read.  Required when the file already exists; 428 when absent, 412 when stale.
+    # @return [Array<(SfvbFileWriteResponse, Integer, Hash)>] SfvbFileWriteResponse data, response status code and response headers
+    def upload_sfvb_file_with_http_info(storefront_oid, file_upload_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SfvbApi.upload_sfvb_file ...'
+      end
+      # verify the required parameter 'storefront_oid' is set
+      if @api_client.config.client_side_validation && storefront_oid.nil?
+        fail ArgumentError, "Missing the required parameter 'storefront_oid' when calling SfvbApi.upload_sfvb_file"
+      end
+      # verify the required parameter 'file_upload_request' is set
+      if @api_client.config.client_side_validation && file_upload_request.nil?
+        fail ArgumentError, "Missing the required parameter 'file_upload_request' when calling SfvbApi.upload_sfvb_file"
+      end
+      # resource path
+      local_var_path = '/sfvb/storefronts/{storefront_oid}/files/upload'.sub('{' + 'storefront_oid' + '}', CGI.escape(storefront_oid.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      header_params['X-UltraCart-Api-Version'] = @api_client.select_header_api_version()
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'If-Match'] = opts[:'if_match'] if !opts[:'if_match'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(file_upload_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SfvbFileWriteResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ultraCartOauth', 'ultraCartSimpleApiKey']
+
+      new_options = opts.merge(
+        :operation => :"SfvbApi.upload_sfvb_file",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SfvbApi#upload_sfvb_file\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Validate CJSON
     # Runs the structural schema, the contextual business rules for the destination owner type, and the quality lint.  A document that fails returns HTTP 200 with valid false rather than a transport error - the request was well formed, the document was not. 
     # @param validate_request [SfvbValidateRequest] CJSON to validate

data/lib/ultracart_api/models/sfvb_file_content_response.rb

@@ -24,7 +24,7 @@ module UltracartClient
     # StoreFront file system file oid.
     attr_accessor :fs_file_oid
 
-    # SHA-256 of the content.  Also returned as the ETag header; send it back as If-Match when writing.
+    # SHA-256 of the content.  Send this 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 this body value is the authoritative one.  Both forms are accepted on write.
     attr_accessor :hash_sha256
 
     # Mime type.

data/lib/ultracart_api/models/sfvb_file_upload_request.rb

@@ -0,0 +1,250 @@
+=begin
+#UltraCart Rest API V2
+
+#UltraCart REST API Version 2
+
+The version of the OpenAPI document: 2.0.0
+Contact: support@ultracart.com
+Generated by: https://openapi-generator.tech
+OpenAPI Generator version: 6.0.1-SNAPSHOT
+
+=end
+
+require 'date'
+require 'time'
+
+module UltracartClient
+  class SfvbFileUploadRequest
+    # Optional comment recorded against the version this write creates.
+    attr_accessor :comment
+
+    # Create the file if it does not exist.  Defaults to true.
+    attr_accessor :create_if_missing
+
+    # The key returned when the upload URL was issued.
+    attr_accessor :key
+
+    # Storefront path to write, for example /assets/imgs/hero.jpg.  The extension must match the one the upload URL was issued for, and must match the bytes.
+    attr_accessor :path
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'comment' => :'comment',
+        :'create_if_missing' => :'create_if_missing',
+        :'key' => :'key',
+        :'path' => :'path'
+      }
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'comment' => :'String',
+        :'create_if_missing' => :'Boolean',
+        :'key' => :'String',
+        :'path' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `UltracartClient::SfvbFileUploadRequest` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!self.class.attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `UltracartClient::SfvbFileUploadRequest`. Please check the name to make sure it's valid. List of attributes: " + self.class.attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'comment')
+        self.comment = attributes[:'comment']
+      end
+
+      if attributes.key?(:'create_if_missing')
+        self.create_if_missing = attributes[:'create_if_missing']
+      end
+
+      if attributes.key?(:'key')
+        self.key = attributes[:'key']
+      end
+
+      if attributes.key?(:'path')
+        self.path = attributes[:'path']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      invalid_properties = Array.new
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      true
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          comment == o.comment &&
+          create_if_missing == o.create_if_missing &&
+          key == o.key &&
+          path == o.path
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [comment, create_if_missing, key, path].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      new.build_from_hash(attributes)
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      self.class.openapi_types.each_pair do |key, type|
+        if attributes[self.class.attribute_map[key]].nil? && self.class.openapi_nullable.include?(key)
+          self.send("#{key}=", nil)
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[self.class.attribute_map[key]].is_a?(Array)
+            self.send("#{key}=", attributes[self.class.attribute_map[key]].map { |v| _deserialize($1, v) })
+          end
+        elsif !attributes[self.class.attribute_map[key]].nil?
+          self.send("#{key}=", _deserialize(type, attributes[self.class.attribute_map[key]]))
+        end
+      end
+
+      self
+    end
+
+    # Deserializes the data based on type
+    # @param string type Data type
+    # @param string value Value to be deserialized
+    # @return [Object] Deserialized data
+    def _deserialize(type, value)
+      case type.to_sym
+      when :Time
+        Time.parse(value)
+      when :Date
+        Date.parse(value)
+      when :String
+        value.to_s
+      when :Integer
+        value.to_i
+      when :Float
+        value.to_f
+      when :Boolean
+        if value.to_s =~ /\A(true|t|yes|y|1)\z/i
+          true
+        else
+          false
+        end
+      when :Object
+        # generic object (usually a Hash), return directly
+        value
+      when /\AArray<(?<inner_type>.+)>\z/
+        inner_type = Regexp.last_match[:inner_type]
+        value.map { |v| _deserialize(inner_type, v) }
+      when /\AHash<(?<k_type>.+?), (?<v_type>.+)>\z/
+        k_type = Regexp.last_match[:k_type]
+        v_type = Regexp.last_match[:v_type]
+        {}.tap do |hash|
+          value.each do |k, v|
+            hash[_deserialize(k_type, k)] = _deserialize(v_type, v)
+          end
+        end
+      else # model
+        # models (e.g. Pet) or oneOf
+        klass = UltracartClient.const_get(type)
+        klass.respond_to?(:openapi_one_of) ? klass.build(value) : klass.build_from_hash(value)
+      end
+    end
+
+    # Returns the string representation of the object
+    # @return [String] String presentation of the object
+    def to_s
+      to_hash.to_s
+    end
+
+    # to_body is an alias to to_hash (backward compatibility)
+    # @return [Hash] Returns the object in the form of hash
+    def to_body
+      to_hash
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+    # Outputs non-array value in the form of hash
+    # For object, use to_hash. Otherwise, just return the value
+    # @param [Object] value Any valid value
+    # @return [Hash] Returns the value in the form of hash
+    def _to_hash(value)
+      if value.is_a?(Array)
+        value.compact.map { |v| _to_hash(v) }
+      elsif value.is_a?(Hash)
+        {}.tap do |hash|
+          value.each { |k, v| hash[k] = _to_hash(v) }
+        end
+      elsif value.respond_to? :to_hash
+        value.to_hash
+      else
+        value
+      end
+    end
+
+  end
+
+end

data/lib/ultracart_api/models/sfvb_file_upload_url_response.rb

@@ -0,0 +1,250 @@
+=begin
+#UltraCart Rest API V2
+
+#UltraCart REST API Version 2
+
+The version of the OpenAPI document: 2.0.0
+Contact: support@ultracart.com
+Generated by: https://openapi-generator.tech
+OpenAPI Generator version: 6.0.1-SNAPSHOT
+
+=end
+
+require 'date'
+require 'time'
+
+module UltracartClient
+  class SfvbFileUploadUrlResponse
+    # Seconds until the upload URL stops working.  Ask for a new one rather than holding this across a long job.
+    attr_accessor :expires_in_seconds
+
+    # HTTP method the upload URL expects.
+    attr_accessor :http_method
+
+    # Quote this back to the upload endpoint once the bytes are in place.  It identifies the uploaded object and is bound to your account.
+    attr_accessor :key
+
+    # Send the raw bytes to this URL.  It is short lived and single use, and it is not part of this API - do not send an Authorization header with it.
+    attr_accessor :upload_url
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'expires_in_seconds' => :'expires_in_seconds',
+        :'http_method' => :'http_method',
+        :'key' => :'key',
+        :'upload_url' => :'upload_url'
+      }
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'expires_in_seconds' => :'Integer',
+        :'http_method' => :'String',
+        :'key' => :'String',
+        :'upload_url' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `UltracartClient::SfvbFileUploadUrlResponse` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!self.class.attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `UltracartClient::SfvbFileUploadUrlResponse`. Please check the name to make sure it's valid. List of attributes: " + self.class.attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'expires_in_seconds')
+        self.expires_in_seconds = attributes[:'expires_in_seconds']
+      end
+
+      if attributes.key?(:'http_method')
+        self.http_method = attributes[:'http_method']
+      end
+
+      if attributes.key?(:'key')
+        self.key = attributes[:'key']
+      end
+
+      if attributes.key?(:'upload_url')
+        self.upload_url = attributes[:'upload_url']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      invalid_properties = Array.new
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      true
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          expires_in_seconds == o.expires_in_seconds &&
+          http_method == o.http_method &&
+          key == o.key &&
+          upload_url == o.upload_url
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [expires_in_seconds, http_method, key, upload_url].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      new.build_from_hash(attributes)
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      self.class.openapi_types.each_pair do |key, type|
+        if attributes[self.class.attribute_map[key]].nil? && self.class.openapi_nullable.include?(key)
+          self.send("#{key}=", nil)
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[self.class.attribute_map[key]].is_a?(Array)
+            self.send("#{key}=", attributes[self.class.attribute_map[key]].map { |v| _deserialize($1, v) })
+          end
+        elsif !attributes[self.class.attribute_map[key]].nil?
+          self.send("#{key}=", _deserialize(type, attributes[self.class.attribute_map[key]]))
+        end
+      end
+
+      self
+    end
+
+    # Deserializes the data based on type
+    # @param string type Data type
+    # @param string value Value to be deserialized
+    # @return [Object] Deserialized data
+    def _deserialize(type, value)
+      case type.to_sym
+      when :Time
+        Time.parse(value)
+      when :Date
+        Date.parse(value)
+      when :String
+        value.to_s
+      when :Integer
+        value.to_i
+      when :Float
+        value.to_f
+      when :Boolean
+        if value.to_s =~ /\A(true|t|yes|y|1)\z/i
+          true
+        else
+          false
+        end
+      when :Object
+        # generic object (usually a Hash), return directly
+        value
+      when /\AArray<(?<inner_type>.+)>\z/
+        inner_type = Regexp.last_match[:inner_type]
+        value.map { |v| _deserialize(inner_type, v) }
+      when /\AHash<(?<k_type>.+?), (?<v_type>.+)>\z/
+        k_type = Regexp.last_match[:k_type]
+        v_type = Regexp.last_match[:v_type]
+        {}.tap do |hash|
+          value.each do |k, v|
+            hash[_deserialize(k_type, k)] = _deserialize(v_type, v)
+          end
+        end
+      else # model
+        # models (e.g. Pet) or oneOf
+        klass = UltracartClient.const_get(type)
+        klass.respond_to?(:openapi_one_of) ? klass.build(value) : klass.build_from_hash(value)
+      end
+    end
+
+    # Returns the string representation of the object
+    # @return [String] String presentation of the object
+    def to_s
+      to_hash.to_s
+    end
+
+    # to_body is an alias to to_hash (backward compatibility)
+    # @return [Hash] Returns the object in the form of hash
+    def to_body
+      to_hash
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+    # Outputs non-array value in the form of hash
+    # For object, use to_hash. Otherwise, just return the value
+    # @param [Object] value Any valid value
+    # @return [Hash] Returns the value in the form of hash
+    def _to_hash(value)
+      if value.is_a?(Array)
+        value.compact.map { |v| _to_hash(v) }
+      elsif value.is_a?(Hash)
+        {}.tap do |hash|
+          value.each { |k, v| hash[k] = _to_hash(v) }
+        end
+      elsif value.respond_to? :to_hash
+        value.to_hash
+      else
+        value
+      end
+    end
+
+  end
+
+end

data/lib/ultracart_api/models/sfvb_file_write_response.rb

@@ -23,6 +23,9 @@ module UltracartClient
     # New SHA-256.  Use as the next If-Match value.
     attr_accessor :hash_sha256
 
+    # Where a shopper's browser will fetch this file, for use in an img src or a background image.  Present only for a path outside /themes/, which is served straight off the storefront root.  A file inside a theme is absent here because its public URL depends on which theme is active, and guessing it would be worse than omitting it.
+    attr_accessor :public_url
+
     attr_accessor :validation
 
     # Velocity errors recorded by the store.  Present means the file was written but is not valid.
@@ -37,6 +40,7 @@ module UltracartClient
         :'compiled_path' => :'compiled_path',
         :'file' => :'file',
         :'hash_sha256' => :'hash_sha256',
+        :'public_url' => :'public_url',
         :'validation' => :'validation',
         :'velocity_errors' => :'velocity_errors',
         :'version' => :'version'
@@ -54,6 +58,7 @@ module UltracartClient
         :'compiled_path' => :'String',
         :'file' => :'SfvbFileEntry',
         :'hash_sha256' => :'String',
+        :'public_url' => :'String',
         :'validation' => :'SfvbValidationResponse',
         :'velocity_errors' => :'String',
         :'version' => :'Integer'
@@ -93,6 +98,10 @@ module UltracartClient
         self.hash_sha256 = attributes[:'hash_sha256']
       end
 
+      if attributes.key?(:'public_url')
+        self.public_url = attributes[:'public_url']
+      end
+
       if attributes.key?(:'validation')
         self.validation = attributes[:'validation']
       end
@@ -127,6 +136,7 @@ module UltracartClient
           compiled_path == o.compiled_path &&
           file == o.file &&
           hash_sha256 == o.hash_sha256 &&
+          public_url == o.public_url &&
           validation == o.validation &&
           velocity_errors == o.velocity_errors &&
           version == o.version
@@ -141,7 +151,7 @@ module UltracartClient
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [compiled_path, file, hash_sha256, validation, velocity_errors, version].hash
+      [compiled_path, file, hash_sha256, public_url, validation, velocity_errors, version].hash
     end
 
     # Builds the object from hash

data/lib/ultracart_api/version.rb

@@ -11,5 +11,5 @@ OpenAPI Generator version: 6.0.1-SNAPSHOT
 =end
 
 module UltracartClient
-  VERSION = '4.1.143'
+  VERSION = '4.1.144'
 end

data/lib/ultracart_api.rb

@@ -989,6 +989,8 @@ require 'ultracart_api/models/sfvb_file_entry'
 require 'ultracart_api/models/sfvb_file_revert_request'
 require 'ultracart_api/models/sfvb_file_search_request'
 require 'ultracart_api/models/sfvb_file_search_response'
+require 'ultracart_api/models/sfvb_file_upload_request'
+require 'ultracart_api/models/sfvb_file_upload_url_response'
 require 'ultracart_api/models/sfvb_file_version'
 require 'ultracart_api/models/sfvb_file_versions_response'
 require 'ultracart_api/models/sfvb_file_write_request'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ultracart_api
 version: !ruby/object:Gem::Version
-  version: 4.1.143
+  version: 4.1.144
 platform: ruby
 authors:
 - UltraCart
@@ -1051,6 +1051,8 @@ files:
 - docs/SfvbFileRevertRequest.md
 - docs/SfvbFileSearchRequest.md
 - docs/SfvbFileSearchResponse.md
+- docs/SfvbFileUploadRequest.md
+- docs/SfvbFileUploadUrlResponse.md
 - docs/SfvbFileVersion.md
 - docs/SfvbFileVersionsResponse.md
 - docs/SfvbFileWriteRequest.md
@@ -2173,6 +2175,8 @@ files:
 - lib/ultracart_api/models/sfvb_file_revert_request.rb
 - lib/ultracart_api/models/sfvb_file_search_request.rb
 - lib/ultracart_api/models/sfvb_file_search_response.rb
+- lib/ultracart_api/models/sfvb_file_upload_request.rb
+- lib/ultracart_api/models/sfvb_file_upload_url_response.rb
 - lib/ultracart_api/models/sfvb_file_version.rb
 - lib/ultracart_api/models/sfvb_file_versions_response.rb
 - lib/ultracart_api/models/sfvb_file_write_request.rb