ultracart_api 4.1.195 → 4.1.197

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 913c595bb012587a97be23d91ccf87c852bf23a3e0f8d4883ff2a50c80082f31
-  data.tar.gz: 7a529e70b9ff0da2f5bc10d47b75a92554d84b89ddf6c6f1d7bd7c47b877634b
+  metadata.gz: 6fe7b304156560d1e196d23728e0569a8141041cf889a1aadd16eafb407dc0c8
+  data.tar.gz: fd009f2cacaa559948fea1fd8e21f9d831f4189e8628bc3183cb6723d95fcf56
 SHA512:
-  metadata.gz: 51f4fc8ae45a432249541f61c2ca9c2b8a2ea0cf5ed1beb486bc49f066154d860fbd734d501d3579711bdf29fe7d85cdff358abdc955867cf4809f10677cb956
-  data.tar.gz: 2ad0c79821a9a6032ae6aaa99dab7f5a0cc0fae393c3862443588f130fda3b99a0ad20332ac5a0849ea9288436e1ef51b6005f567ffc71cef297e6e44264b53b
+  metadata.gz: 82cb0045062bf8dc09f8a6ad0e86e47002ace1f36c92a803a3ecefccf6cf3495808be8991716d3ddc2b2914b14702c5532fd7c747bd13b898f1f02fbee8b41d8
+  data.tar.gz: eda307bb7562d8185edb79aad7dcc4e29fe2519663663e4e8aefb42281af92fe545f0cec0341d065a2e9998dd1ce86a9378cef0b382645b3c62d365e24eb74e1

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.195
+- Package version: 4.1.197
 - 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.195'
+gem 'ultracart_api', '4.1.197'
 ```
 
 install:
@@ -486,6 +486,7 @@ Class | Method | HTTP request | Description
 *UltracartClient::SfvbApi* | [**create_sfvb_library_entry**](docs/SfvbApi.md#create_sfvb_library_entry) | **POST** /sfvb/storefronts/{storefront_oid}/library | Save a fragment to the library
 *UltracartClient::SfvbApi* | [**create_sfvb_preview_access**](docs/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
 *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_approval**](docs/SfvbApi.md#delete_sfvb_approval) | **DELETE** /sfvb/approvals/{approval_id} | Cancel a pending approval request
 *UltracartClient::SfvbApi* | [**delete_sfvb_blog_post**](docs/SfvbApi.md#delete_sfvb_blog_post) | **DELETE** /sfvb/storefronts/{storefront_oid}/blog_posts/{blog_post_oid} | Delete a blog post
 *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_item_attribute**](docs/SfvbApi.md#delete_sfvb_item_attribute) | **DELETE** /sfvb/storefronts/{storefront_oid}/items/attributes | Delete an attribute from an item
@@ -508,6 +509,8 @@ Class | Method | HTTP request | Description
 *UltracartClient::SfvbApi* | [**enable_sfvb_i18n_language**](docs/SfvbApi.md#enable_sfvb_i18n_language) | **POST** /sfvb/storefronts/{storefront_oid}/i18n/languages/{code}/enable | Enable a language
 *UltracartClient::SfvbApi* | [**end_sfvb_experiment**](docs/SfvbApi.md#end_sfvb_experiment) | **POST** /sfvb/storefronts/{storefront_oid}/experiments/{experiment_oid}/end | End an experiment
 *UltracartClient::SfvbApi* | [**favorite_sfvb_library_entry**](docs/SfvbApi.md#favorite_sfvb_library_entry) | **PUT** /sfvb/storefronts/{storefront_oid}/library/{library_oid}/favorite | Favorite a library entry
+*UltracartClient::SfvbApi* | [**get_sfvb_approval**](docs/SfvbApi.md#get_sfvb_approval) | **GET** /sfvb/approvals/{approval_id} | Read one approval request
+*UltracartClient::SfvbApi* | [**get_sfvb_approvals**](docs/SfvbApi.md#get_sfvb_approvals) | **GET** /sfvb/approvals | List this sign-in's approval requests
 *UltracartClient::SfvbApi* | [**get_sfvb_blog_post**](docs/SfvbApi.md#get_sfvb_blog_post) | **GET** /sfvb/storefronts/{storefront_oid}/blog_posts/{blog_post_oid} | Read a blog post
 *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
@@ -554,6 +557,7 @@ Class | Method | HTTP request | Description
 *UltracartClient::SfvbApi* | [**get_sfvb_whoami**](docs/SfvbApi.md#get_sfvb_whoami) | **GET** /sfvb/whoami | Who this token is
 *UltracartClient::SfvbApi* | [**ignore_sfvb_not_found_entry**](docs/SfvbApi.md#ignore_sfvb_not_found_entry) | **POST** /sfvb/storefronts/{storefront_oid}/not_found/{not_found_id}/ignore | Ignore a 404 path
 *UltracartClient::SfvbApi* | [**import_sfvb_redirects**](docs/SfvbApi.md#import_sfvb_redirects) | **POST** /sfvb/storefronts/{storefront_oid}/redirects/import | Apply a reviewed redirect import
+*UltracartClient::SfvbApi* | [**insert_sfvb_approval**](docs/SfvbApi.md#insert_sfvb_approval) | **POST** /sfvb/approvals | Request a human approval
 *UltracartClient::SfvbApi* | [**insert_sfvb_blog_post**](docs/SfvbApi.md#insert_sfvb_blog_post) | **POST** /sfvb/storefronts/{storefront_oid}/blog_posts | Create a blog post
 *UltracartClient::SfvbApi* | [**insert_sfvb_page**](docs/SfvbApi.md#insert_sfvb_page) | **POST** /sfvb/storefronts/{storefront_oid}/pages | Create a page
 *UltracartClient::SfvbApi* | [**insert_sfvb_redirect**](docs/SfvbApi.md#insert_sfvb_redirect) | **POST** /sfvb/storefronts/{storefront_oid}/redirects | Create a 301 redirect rule
@@ -1851,6 +1855,10 @@ Class | Method | HTTP request | Description
  - [UltracartClient::ScreenRecordingUserProperty](docs/ScreenRecordingUserProperty.md)
  - [UltracartClient::ScreenshotsResponse](docs/ScreenshotsResponse.md)
  - [UltracartClient::SelfConfig](docs/SelfConfig.md)
+ - [UltracartClient::SfvbApproval](docs/SfvbApproval.md)
+ - [UltracartClient::SfvbApprovalCreateRequest](docs/SfvbApprovalCreateRequest.md)
+ - [UltracartClient::SfvbApprovalParams](docs/SfvbApprovalParams.md)
+ - [UltracartClient::SfvbApprovalsResponse](docs/SfvbApprovalsResponse.md)
  - [UltracartClient::SfvbBlogPost](docs/SfvbBlogPost.md)
  - [UltracartClient::SfvbBlogPostDetail](docs/SfvbBlogPostDetail.md)
  - [UltracartClient::SfvbBlogPostImage](docs/SfvbBlogPostImage.md)
@@ -2210,6 +2218,8 @@ Not every change is committed to every SDK.
 
 | Version | Date | Comments |
 | --: | :-: | --- |
+| 4.1.197 | 10/08/2026 | sfvb internal testing |
+| 4.1.196 | 10/08/2026 | sfvb internal testing |
 | 4.1.195 | 10/07/2026 | sfvb internal testing |
 | 4.1.194 | 10/07/2026 | sfvb internal testing |
 | 4.1.193 | 10/06/2026 | sfvb internal testing |

data/docs/SfvbApi.md

@@ -14,6 +14,7 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
 | [**create_sfvb_library_entry**](SfvbApi.md#create_sfvb_library_entry) | **POST** /sfvb/storefronts/{storefront_oid}/library | Save a fragment to the library |
 | [**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_approval**](SfvbApi.md#delete_sfvb_approval) | **DELETE** /sfvb/approvals/{approval_id} | Cancel a pending approval request |
 | [**delete_sfvb_blog_post**](SfvbApi.md#delete_sfvb_blog_post) | **DELETE** /sfvb/storefronts/{storefront_oid}/blog_posts/{blog_post_oid} | Delete a blog post |
 | [**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 |
@@ -36,6 +37,8 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
 | [**enable_sfvb_i18n_language**](SfvbApi.md#enable_sfvb_i18n_language) | **POST** /sfvb/storefronts/{storefront_oid}/i18n/languages/{code}/enable | Enable a language |
 | [**end_sfvb_experiment**](SfvbApi.md#end_sfvb_experiment) | **POST** /sfvb/storefronts/{storefront_oid}/experiments/{experiment_oid}/end | End an experiment |
 | [**favorite_sfvb_library_entry**](SfvbApi.md#favorite_sfvb_library_entry) | **PUT** /sfvb/storefronts/{storefront_oid}/library/{library_oid}/favorite | Favorite a library entry |
+| [**get_sfvb_approval**](SfvbApi.md#get_sfvb_approval) | **GET** /sfvb/approvals/{approval_id} | Read one approval request |
+| [**get_sfvb_approvals**](SfvbApi.md#get_sfvb_approvals) | **GET** /sfvb/approvals | List this sign-in's approval requests |
 | [**get_sfvb_blog_post**](SfvbApi.md#get_sfvb_blog_post) | **GET** /sfvb/storefronts/{storefront_oid}/blog_posts/{blog_post_oid} | Read a blog post |
 | [**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 |
@@ -82,6 +85,7 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
 | [**get_sfvb_whoami**](SfvbApi.md#get_sfvb_whoami) | **GET** /sfvb/whoami | Who this token is |
 | [**ignore_sfvb_not_found_entry**](SfvbApi.md#ignore_sfvb_not_found_entry) | **POST** /sfvb/storefronts/{storefront_oid}/not_found/{not_found_id}/ignore | Ignore a 404 path |
 | [**import_sfvb_redirects**](SfvbApi.md#import_sfvb_redirects) | **POST** /sfvb/storefronts/{storefront_oid}/redirects/import | Apply a reviewed redirect import |
+| [**insert_sfvb_approval**](SfvbApi.md#insert_sfvb_approval) | **POST** /sfvb/approvals | Request a human approval |
 | [**insert_sfvb_blog_post**](SfvbApi.md#insert_sfvb_blog_post) | **POST** /sfvb/storefronts/{storefront_oid}/blog_posts | Create a blog post |
 | [**insert_sfvb_page**](SfvbApi.md#insert_sfvb_page) | **POST** /sfvb/storefronts/{storefront_oid}/pages | Create a page |
 | [**insert_sfvb_redirect**](SfvbApi.md#insert_sfvb_redirect) | **POST** /sfvb/storefronts/{storefront_oid}/redirects | Create a 301 redirect rule |
@@ -696,9 +700,62 @@ end
 - **Accept**: application/json
 
 
+## delete_sfvb_approval
+
+> delete_sfvb_approval(approval_id)
+
+Cancel a pending approval request
+
+Withdraws a request nobody has decided yet, which frees one of the five pending slots a sign-in has.  A request that was already decided, used or expired cannot be cancelled. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the delete_sfvb_approval_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)> delete_sfvb_approval_with_http_info(approval_id)
+
+```ruby
+begin
+  # Cancel a pending approval request
+  data, status_code, headers = api_instance.delete_sfvb_approval_with_http_info(approval_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->delete_sfvb_approval_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **approval_id** | **String** |  |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## delete_sfvb_blog_post
 
-> delete_sfvb_blog_post(storefront_oid, blog_post_oid)
+> delete_sfvb_blog_post(storefront_oid, blog_post_oid, opts)
 
 Delete a blog post
 
@@ -715,12 +772,12 @@ Takes the post off every page and deletes it.  There is no undo.  A post that is
 
 This returns an Array which contains the response data (`nil` in this case), status code and headers.
 
-> <Array(nil, Integer, Hash)> delete_sfvb_blog_post_with_http_info(storefront_oid, blog_post_oid)
+> <Array(nil, Integer, Hash)> delete_sfvb_blog_post_with_http_info(storefront_oid, blog_post_oid, opts)
 
 ```ruby
 begin
   # Delete a blog post
-  data, status_code, headers = api_instance.delete_sfvb_blog_post_with_http_info(storefront_oid, blog_post_oid)
+  data, status_code, headers = api_instance.delete_sfvb_blog_post_with_http_info(storefront_oid, blog_post_oid, opts)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => nil
@@ -735,6 +792,7 @@ end
 | ---- | ---- | ----------- | ----- |
 | **storefront_oid** | **Integer** |  |  |
 | **blog_post_oid** | **Integer** |  |  |
+| **approval_id** | **String** | The approval_id of an approved blog_post.delete request for this post.  See POST /sfvb/approvals. | [optional] |
 
 ### Return type
 
@@ -790,6 +848,7 @@ end
 | **storefront_oid** | **Integer** |  |  |
 | **if_match** | **String** | Content hash of the file being deleted.  Required; 428 when absent, 412 when stale. |  |
 | **path** | **String** |  | [optional] |
+| **approval_id** | **String** | The approval_id of an approved file.delete request for this exact path.  See POST /sfvb/approvals. | [optional] |
 
 ### Return type
 
@@ -1902,6 +1961,110 @@ nil (empty response body)
 - **Accept**: application/json
 
 
+## get_sfvb_approval
+
+> <SfvbApproval> get_sfvb_approval(approval_id)
+
+Read one approval request
+
+Poll this every interval_seconds after requesting an approval.  status is pending until the person decides, then approved or denied, and expired if nobody acts in 10 minutes.  Once the gated call has used it, status is used and outcome says whether the call succeeded.  Used with no outcome means the result is unknown, so check the target - never repeat the call. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the get_sfvb_approval_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbApproval>, Integer, Hash)> get_sfvb_approval_with_http_info(approval_id)
+
+```ruby
+begin
+  # Read one approval request
+  data, status_code, headers = api_instance.get_sfvb_approval_with_http_info(approval_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbApproval>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->get_sfvb_approval_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **approval_id** | **String** |  |  |
+
+### Return type
+
+[**SfvbApproval**](SfvbApproval.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_sfvb_approvals
+
+> <SfvbApprovalsResponse> get_sfvb_approvals
+
+List this sign-in's approval requests
+
+Requests made with this sign-in in the last 24 hours, newest first, at most 50, with their status and outcome.  Use it to find a request whose id was lost, or to see what an earlier run did. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the get_sfvb_approvals_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbApprovalsResponse>, Integer, Hash)> get_sfvb_approvals_with_http_info
+
+```ruby
+begin
+  # List this sign-in's approval requests
+  data, status_code, headers = api_instance.get_sfvb_approvals_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbApprovalsResponse>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->get_sfvb_approvals_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**SfvbApprovalsResponse**](SfvbApprovalsResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## get_sfvb_blog_post
 
 > <SfvbBlogPostDetail> get_sfvb_blog_post(storefront_oid, blog_post_oid)
@@ -4399,6 +4562,60 @@ end
 - **Accept**: application/json
 
 
+## insert_sfvb_approval
+
+> insert_sfvb_approval(approval_request, opts)
+
+Request a human approval
+
+Asks the person who signed in the CLI to approve one gated action on one exact target.  Name the storefront with the storefront_oid query parameter.  The target is checked the way the action will check it, so nobody is asked to approve a call that would fail.  Show the person approval_url and user_code, poll GET approvals/{approval_id} every interval_seconds, and once it is approved repeat the gated call with the approval_id in the Approval-Id header.  Asking again for the same thing returns the pending request (200) rather than a new one (201).  A request lapses after 10 minutes.  Requires a token that resolves to a user, so use the device authorization flow. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the insert_sfvb_approval_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)> insert_sfvb_approval_with_http_info(approval_request, opts)
+
+```ruby
+begin
+  # Request a human approval
+  data, status_code, headers = api_instance.insert_sfvb_approval_with_http_info(approval_request, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->insert_sfvb_approval_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **approval_request** | [**SfvbApprovalCreateRequest**](SfvbApprovalCreateRequest.md) | The request |  |
+| **storefront_oid** | **Integer** | The storefront the action runs on.  Required for storefront actions, left out for account-wide ones. | [optional] |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json; charset=UTF-8
+- **Accept**: application/json
+
+
 ## insert_sfvb_blog_post
 
 > <SfvbBlogPostDetail> insert_sfvb_blog_post(storefront_oid, blog_post_request)

data/docs/SfvbApproval.md

@@ -0,0 +1,54 @@
+# UltracartClient::SfvbApproval
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **action** | **String** | The gated action. | [optional] |
+| **approval_id** | **String** | Send this as the Approval-Id header on the gated call once status is approved. | [optional] |
+| **approval_url** | **String** | The page where the person approves or denies.  Show it to them.  Never open or fill it in yourself. | [optional] |
+| **created_at** | **String** | When the request was made, ISO 8601 UTC. | [optional] |
+| **description** | **String** | The sentence the person reads before approving.  Written by the server, not the agent. | [optional] |
+| **expires_at** | **String** | When this approval stops being usable, ISO 8601 UTC.  For a pending request, when it lapses undecided.  For an approved one, when it must have been used by. | [optional] |
+| **expires_in_seconds** | **Integer** | Seconds until expires_at.  Zero once passed. | [optional] |
+| **fresh_code_required** | **Boolean** | True when the person must enter a new 2FA code for this request even inside an approval session. | [optional] |
+| **interval_seconds** | **Integer** | Poll no more often than this. | [optional] |
+| **outcome** | **String** | Once used, succeeded or failed.  Used with no outcome means the result is unknown.  Check the target and never send the call again with this approval. | [optional] |
+| **outcome_code** | **String** | The error code the gated call failed with. | [optional] |
+| **outcome_http_status** | **Integer** | The HTTP status the gated call answered with. | [optional] |
+| **params** | [**SfvbApprovalParams**](SfvbApprovalParams.md) |  | [optional] |
+| **reason** | **String** | The reason the agent sent, as stored and shown (cleaned and capped). | [optional] |
+| **scope** | **String** | Where the action applies.  The storefront host name, or account for account-wide actions. | [optional] |
+| **status** | **String** | pending, approved, denied, cancelled, expired or used.  Only approved may be sent with the gated call. | [optional] |
+| **storefront_oid** | **Integer** | The storefront the action runs on.  Absent for account-wide actions. | [optional] |
+| **used_at** | **String** | When the gated call used this approval, ISO 8601 UTC. | [optional] |
+| **user_code** | **String** | Short matching code.  Print it next to approval_url so the person can check the page shows the same code. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbApproval.new(
+  action: null,
+  approval_id: null,
+  approval_url: null,
+  created_at: null,
+  description: null,
+  expires_at: null,
+  expires_in_seconds: null,
+  fresh_code_required: null,
+  interval_seconds: null,
+  outcome: null,
+  outcome_code: null,
+  outcome_http_status: null,
+  params: null,
+  reason: null,
+  scope: null,
+  status: null,
+  storefront_oid: null,
+  used_at: null,
+  user_code: null
+)
+```
+

data/docs/SfvbApprovalCreateRequest.md

@@ -0,0 +1,22 @@
+# UltracartClient::SfvbApprovalCreateRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **action** | **String** | The gated action to approve. | [optional] |
+| **params** | [**SfvbApprovalParams**](SfvbApprovalParams.md) |  | [optional] |
+| **reason** | **String** | Why the agent wants to do this, in a sentence.  Shown to the person as unverified text, capped at 500 characters. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbApprovalCreateRequest.new(
+  action: null,
+  params: null,
+  reason: null
+)
+```
+

data/docs/SfvbApprovalParams.md

@@ -0,0 +1,20 @@
+# UltracartClient::SfvbApprovalParams
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **blog_post_oid** | **Integer** | The blog post, for blog_post.delete. | [optional] |
+| **path** | **String** | The file path, for file.delete.  Exactly as the delete call will send it. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbApprovalParams.new(
+  blog_post_oid: null,
+  path: null
+)
+```
+

data/docs/SfvbApprovalsResponse.md

@@ -0,0 +1,18 @@
+# UltracartClient::SfvbApprovalsResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **approvals** | [**Array<SfvbApproval>**](SfvbApproval.md) | This sign-in's requests from the last 24 hours, newest first, at most 50.  Pending ones are always within that window, because a request expires after 10 minutes. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbApprovalsResponse.new(
+  approvals: null
+)
+```
+