ultracart_api 4.1.150 → 4.1.152

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0dd10e0e13b853be44db9716b0141fab32c531e40f176c6e6e116107da27464e
-  data.tar.gz: 551f2e71eef3b0d331b0599f79113a70c50ce1e610135a6b4b1cb0ba34cc7431
+  metadata.gz: f0ea0de2841710ce3dec7e18831851afe0ed6050c7032c7fb438545e70dfd728
+  data.tar.gz: fdd7b997d12a5ad7e6e554fba251212dc8385dc0f33ab34d8994613dd8edb224
 SHA512:
-  metadata.gz: 1a1fea1e8d56f3a4ce8e45a3bec035bb1044e5fef96f3b3afc8eef8723c07d48f0f498e7d2c27b3e0cdf992876e0dd7db75cd16625fb94780cb6f0d87930cec0
-  data.tar.gz: 18df8e1fdbf9bc225af078d8259641e2930491d5fbec6b3fcdf0b48a506ec17a35aa7ab20c99b57f7088e1097d790467058f032953b20b54915e1d90ca61c0ad
+  metadata.gz: 07e8aa7717a139f16a11934a5935d4c373fc14ad444ceb8ee9d239aec4ba0b14e60a5144027001c41db199316ac082ffc0c8228672050bd47efb8d1ee3777bd2
+  data.tar.gz: 36700814e5460576a8233647604a6a7fcfa744079b364b81ad0ef0785eef69183fcf3db282a7ada0a060baf0ae1b165cc287e938fac601d24c85a6a788777225

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.150
+- Package version: 4.1.152
 - 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.150'
+gem 'ultracart_api', '4.1.152'
 ```
 
 install:
@@ -252,6 +252,7 @@ Class | Method | HTTP request | Description
 *UltracartClient::ConversationApi* | [**insert_pbx_time_range**](docs/ConversationApi.md#insert_pbx_time_range) | **POST** /conversation/pbx/time_range | Insert pbx timeRange
 *UltracartClient::ConversationApi* | [**insert_pbx_voicemail_mailbox**](docs/ConversationApi.md#insert_pbx_voicemail_mailbox) | **POST** /conversation/pbx/voicemail_mailbox | Insert pbx voicemailMailbox
 *UltracartClient::ConversationApi* | [**insert_user_pbx_audio**](docs/ConversationApi.md#insert_user_pbx_audio) | **POST** /conversation/pbx/audio/user | Insert user pbx audio
+*UltracartClient::ConversationApi* | [**join_agent_test_session**](docs/ConversationApi.md#join_agent_test_session) | **PUT** /conversation/agent/profiles/{user_id}/test_session/{conversation_uuid}/join | Join a test conversation as the simulated customer
 *UltracartClient::ConversationApi* | [**join_conversation**](docs/ConversationApi.md#join_conversation) | **PUT** /conversation/conversations/{conversation_uuid}/join | Join a conversation
 *UltracartClient::ConversationApi* | [**leave_conversation**](docs/ConversationApi.md#leave_conversation) | **DELETE** /conversation/conversations/{conversation_uuid}/leave | Leave a conversation
 *UltracartClient::ConversationApi* | [**listened_pbx_agent_voicemail**](docs/ConversationApi.md#listened_pbx_agent_voicemail) | **GET** /conversation/pbx/agent/voicemails/{recording_sid}/listened | Listened Agent Voicemail
@@ -267,6 +268,7 @@ Class | Method | HTTP request | Description
 *UltracartClient::ConversationApi* | [**search_pbx_available_phone_numbers**](docs/ConversationApi.md#search_pbx_available_phone_numbers) | **GET** /conversation/pbx/phone_number/search | Search for available phone numbers
 *UltracartClient::ConversationApi* | [**search_pbx_calls**](docs/ConversationApi.md#search_pbx_calls) | **POST** /conversation/pbx/call/search | Search pbx call records
 *UltracartClient::ConversationApi* | [**sms_unsubscribe_conversation**](docs/ConversationApi.md#sms_unsubscribe_conversation) | **PUT** /conversation/conversations/{conversation_uuid}/sms_unsubscribe | Unsubscribe any SMS participants in this conversation
+*UltracartClient::ConversationApi* | [**start_agent_test_session**](docs/ConversationApi.md#start_agent_test_session) | **PUT** /conversation/agent/profiles/{user_id}/test_session | Start a test conversation with this AI agent
 *UltracartClient::ConversationApi* | [**start_conversation**](docs/ConversationApi.md#start_conversation) | **PUT** /conversation/conversations | Start a conversation
 *UltracartClient::ConversationApi* | [**update_agent_profile**](docs/ConversationApi.md#update_agent_profile) | **PUT** /conversation/agent/profile | Update agent profile
 *UltracartClient::ConversationApi* | [**update_agent_profile_mcp**](docs/ConversationApi.md#update_agent_profile_mcp) | **POST** /conversation/agent/profiles/{user_id}/mcps/{mcp_server_uuid} | Update an agent MCP server
@@ -485,6 +487,7 @@ Class | Method | HTTP request | Description
 *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
+*UltracartClient::SfvbApi* | [**get_sfvb_theme_attributes**](docs/SfvbApi.md#get_sfvb_theme_attributes) | **GET** /sfvb/storefronts/{storefront_oid}/themes/{theme_oid}/attributes | Read a theme's colors, fonts and settings
 *UltracartClient::SfvbApi* | [**get_sfvb_theme_job**](docs/SfvbApi.md#get_sfvb_theme_job) | **GET** /sfvb/storefronts/{storefront_oid}/theme_jobs/{job_id} | Status of an asynchronous theme job
 *UltracartClient::SfvbApi* | [**get_sfvb_version**](docs/SfvbApi.md#get_sfvb_version) | **GET** /sfvb/version | Compiler version for this merchant
 *UltracartClient::SfvbApi* | [**get_sfvb_whoami**](docs/SfvbApi.md#get_sfvb_whoami) | **GET** /sfvb/whoami | Who this token is
@@ -499,6 +502,7 @@ Class | Method | HTTP request | Description
 *UltracartClient::SfvbApi* | [**put_sfvb_container**](docs/SfvbApi.md#put_sfvb_container) | **PUT** /sfvb/storefronts/{storefront_oid}/containers/{owner_type}/{owner_object_id} | Write a container stored outside the file system
 *UltracartClient::SfvbApi* | [**put_sfvb_file_content**](docs/SfvbApi.md#put_sfvb_file_content) | **PUT** /sfvb/storefronts/{storefront_oid}/files/content | Write a storefront file
 *UltracartClient::SfvbApi* | [**put_sfvb_preview_session**](docs/SfvbApi.md#put_sfvb_preview_session) | **PUT** /sfvb/storefronts/{storefront_oid}/preview_sessions/{preview_session_id} | Push containers into a preview session
+*UltracartClient::SfvbApi* | [**put_sfvb_theme_attributes**](docs/SfvbApi.md#put_sfvb_theme_attributes) | **PUT** /sfvb/storefronts/{storefront_oid}/themes/{theme_oid}/attributes | Change a theme's colors, fonts and settings
 *UltracartClient::SfvbApi* | [**render_sfvb_widgets**](docs/SfvbApi.md#render_sfvb_widgets) | **POST** /sfvb/storefronts/{storefront_oid}/themes/{theme_oid}/render | Render a CJSON node to HTML
 *UltracartClient::SfvbApi* | [**reserve_sfvb_widget_ids**](docs/SfvbApi.md#reserve_sfvb_widget_ids) | **POST** /sfvb/storefronts/{storefront_oid}/widget_ids | Reserve a block of widget ids
 *UltracartClient::SfvbApi* | [**revert_sfvb_container**](docs/SfvbApi.md#revert_sfvb_container) | **POST** /sfvb/storefronts/{storefront_oid}/containers/{owner_type}/{owner_object_id}/revert | Revert a container stored outside the file system
@@ -941,6 +945,9 @@ Class | Method | HTTP request | Description
  - [UltracartClient::ConversationAgentStatusRollupSearchResponse](docs/ConversationAgentStatusRollupSearchResponse.md)
  - [UltracartClient::ConversationAgentStatusSummaryResponse](docs/ConversationAgentStatusSummaryResponse.md)
  - [UltracartClient::ConversationAgentStatusTimelineResponse](docs/ConversationAgentStatusTimelineResponse.md)
+ - [UltracartClient::ConversationAgentTestSessionJoinRequest](docs/ConversationAgentTestSessionJoinRequest.md)
+ - [UltracartClient::ConversationAgentTestSessionRequest](docs/ConversationAgentTestSessionRequest.md)
+ - [UltracartClient::ConversationAgentTestSessionResponse](docs/ConversationAgentTestSessionResponse.md)
  - [UltracartClient::ConversationAutocompleteRequest](docs/ConversationAutocompleteRequest.md)
  - [UltracartClient::ConversationAutocompleteResponse](docs/ConversationAutocompleteResponse.md)
  - [UltracartClient::ConversationAutocompleteValue](docs/ConversationAutocompleteValue.md)
@@ -948,6 +955,7 @@ Class | Method | HTTP request | Description
  - [UltracartClient::ConversationCannedMessageResponse](docs/ConversationCannedMessageResponse.md)
  - [UltracartClient::ConversationCannedMessagesResponse](docs/ConversationCannedMessagesResponse.md)
  - [UltracartClient::ConversationCannedMessagesSearch](docs/ConversationCannedMessagesSearch.md)
+ - [UltracartClient::ConversationCustomerAuth](docs/ConversationCustomerAuth.md)
  - [UltracartClient::ConversationDeleteKnowledgeBaseDocumentResponse](docs/ConversationDeleteKnowledgeBaseDocumentResponse.md)
  - [UltracartClient::ConversationDepartment](docs/ConversationDepartment.md)
  - [UltracartClient::ConversationDepartmentMember](docs/ConversationDepartmentMember.md)
@@ -1754,7 +1762,13 @@ Class | Method | HTTP request | Description
  - [UltracartClient::SfvbStorefront](docs/SfvbStorefront.md)
  - [UltracartClient::SfvbStorefrontsResponse](docs/SfvbStorefrontsResponse.md)
  - [UltracartClient::SfvbTheme](docs/SfvbTheme.md)
+ - [UltracartClient::SfvbThemeAttribute](docs/SfvbThemeAttribute.md)
+ - [UltracartClient::SfvbThemeAttributeUpdate](docs/SfvbThemeAttributeUpdate.md)
+ - [UltracartClient::SfvbThemeAttributeUpdateRequest](docs/SfvbThemeAttributeUpdateRequest.md)
+ - [UltracartClient::SfvbThemeAttributesResponse](docs/SfvbThemeAttributesResponse.md)
  - [UltracartClient::SfvbThemeDuplicateRequest](docs/SfvbThemeDuplicateRequest.md)
+ - [UltracartClient::SfvbThemeFont](docs/SfvbThemeFont.md)
+ - [UltracartClient::SfvbThemeFontFamily](docs/SfvbThemeFontFamily.md)
  - [UltracartClient::SfvbThemeJobResponse](docs/SfvbThemeJobResponse.md)
  - [UltracartClient::SfvbThemesResponse](docs/SfvbThemesResponse.md)
  - [UltracartClient::SfvbUpsellOffer](docs/SfvbUpsellOffer.md)
@@ -1928,6 +1942,8 @@ Not every change is committed to every SDK.
 
 | Version | Date | Comments |
 | --: | :-: | --- |
+| 4.1.152 | 09/09/2026 | sfvb - internal testing |
+| 4.1.151 | 09/04/2026 | conversations - added ai agent capabilities |
 | 4.1.150 | 09/04/2026 | conversations - add ai agent capabilities |
 | 4.1.149 | 09/04/2026 | conversations - added ai agent capabilities |
 | 4.1.148 | 09/04/2026 | conversations - added ai agent capabilities |

data/docs/ConversationAgentTestSessionJoinRequest.md

@@ -0,0 +1,18 @@
+# UltracartClient::ConversationAgentTestSessionJoinRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **conversation_webchat_queue_uuid** | **String** | Queue entry uuid returned when the test session was started | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::ConversationAgentTestSessionJoinRequest.new(
+  conversation_webchat_queue_uuid: null
+)
+```
+

data/docs/ConversationAgentTestSessionRequest.md

@@ -0,0 +1,24 @@
+# UltracartClient::ConversationAgentTestSessionRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **customer_profile_oid** | **Integer** | Customer profile to converse as.  The cart is established as a soft login for this customer, so the agent sees their real order history. | [optional] |
+| **question** | **String** | Optional opening question, the same way a customer types one before joining the queue. | [optional] |
+| **queue_name** | **String** | Webchat queue to join.  The agent is selected explicitly, so this does not have to be a queue the agent is assigned to. | [optional] |
+| **storefront_host_name** | **String** | Host name of the storefront to test against, with no protocol prefix.  Determines which catalog the agent searches. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::ConversationAgentTestSessionRequest.new(
+  customer_profile_oid: null,
+  question: null,
+  queue_name: null,
+  storefront_host_name: null
+)
+```
+

data/docs/ConversationAgentTestSessionResponse.md

@@ -0,0 +1,32 @@
+# UltracartClient::ConversationAgentTestSessionResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **cart_id** | **String** | Cart established for this session, soft logged in as the chosen customer profile.  Real, and anything the agent adds to it persists. | [optional] |
+| **conversation_webchat_queue_uuid** | **String** | Queue entry created for this session | [optional] |
+| **customer_auth** | [**ConversationCustomerAuth**](ConversationCustomerAuth.md) |  | [optional] |
+| **error** | [**Error**](Error.md) |  | [optional] |
+| **metadata** | [**ResponseMetadata**](ResponseMetadata.md) |  | [optional] |
+| **storefront_host_name** | **String** | Storefront the session is running against | [optional] |
+| **success** | **Boolean** |  | [optional] |
+| **warning** | [**Warning**](Warning.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::ConversationAgentTestSessionResponse.new(
+  cart_id: null,
+  conversation_webchat_queue_uuid: null,
+  customer_auth: null,
+  error: null,
+  metadata: null,
+  storefront_host_name: null,
+  success: null,
+  warning: null
+)
+```
+

data/docs/ConversationApi.md

@@ -107,6 +107,7 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
 | [**insert_pbx_time_range**](ConversationApi.md#insert_pbx_time_range) | **POST** /conversation/pbx/time_range | Insert pbx timeRange |
 | [**insert_pbx_voicemail_mailbox**](ConversationApi.md#insert_pbx_voicemail_mailbox) | **POST** /conversation/pbx/voicemail_mailbox | Insert pbx voicemailMailbox |
 | [**insert_user_pbx_audio**](ConversationApi.md#insert_user_pbx_audio) | **POST** /conversation/pbx/audio/user | Insert user pbx audio |
+| [**join_agent_test_session**](ConversationApi.md#join_agent_test_session) | **PUT** /conversation/agent/profiles/{user_id}/test_session/{conversation_uuid}/join | Join a test conversation as the simulated customer |
 | [**join_conversation**](ConversationApi.md#join_conversation) | **PUT** /conversation/conversations/{conversation_uuid}/join | Join a conversation |
 | [**leave_conversation**](ConversationApi.md#leave_conversation) | **DELETE** /conversation/conversations/{conversation_uuid}/leave | Leave a conversation |
 | [**listened_pbx_agent_voicemail**](ConversationApi.md#listened_pbx_agent_voicemail) | **GET** /conversation/pbx/agent/voicemails/{recording_sid}/listened | Listened Agent Voicemail |
@@ -122,6 +123,7 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
 | [**search_pbx_available_phone_numbers**](ConversationApi.md#search_pbx_available_phone_numbers) | **GET** /conversation/pbx/phone_number/search | Search for available phone numbers |
 | [**search_pbx_calls**](ConversationApi.md#search_pbx_calls) | **POST** /conversation/pbx/call/search | Search pbx call records |
 | [**sms_unsubscribe_conversation**](ConversationApi.md#sms_unsubscribe_conversation) | **PUT** /conversation/conversations/{conversation_uuid}/sms_unsubscribe | Unsubscribe any SMS participants in this conversation |
+| [**start_agent_test_session**](ConversationApi.md#start_agent_test_session) | **PUT** /conversation/agent/profiles/{user_id}/test_session | Start a test conversation with this AI agent |
 | [**start_conversation**](ConversationApi.md#start_conversation) | **PUT** /conversation/conversations | Start a conversation |
 | [**update_agent_profile**](ConversationApi.md#update_agent_profile) | **PUT** /conversation/agent/profile | Update agent profile |
 | [**update_agent_profile_mcp**](ConversationApi.md#update_agent_profile_mcp) | **POST** /conversation/agent/profiles/{user_id}/mcps/{mcp_server_uuid} | Update an agent MCP server |
@@ -5632,6 +5634,61 @@ end
 - **Accept**: application/json
 
 
+## join_agent_test_session
+
+> join_agent_test_session(user_id, conversation_uuid, join_request)
+
+Join a test conversation as the simulated customer
+
+Joins the simulated customer to the conversation the agent opened for a test session.  This mirrors what the storefront webchat widget does after an agent picks up its queue entry, and it is what gives the conversation a customer participant.  Requires a logged in user with conversations admin; an API key or OAuth application cannot call this. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the join_agent_test_session_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)> join_agent_test_session_with_http_info(user_id, conversation_uuid, join_request)
+
+```ruby
+begin
+  # Join a test conversation as the simulated customer
+  data, status_code, headers = api_instance.join_agent_test_session_with_http_info(user_id, conversation_uuid, join_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue UltracartClient::ApiError => e
+  puts "Error when calling ConversationApi->join_agent_test_session_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **user_id** | **Integer** |  |  |
+| **conversation_uuid** | **String** |  |  |
+| **join_request** | [**ConversationAgentTestSessionJoinRequest**](ConversationAgentTestSessionJoinRequest.md) | Test session join request |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## join_conversation
 
 > join_conversation(conversation_uuid, opts)
@@ -6449,6 +6506,60 @@ nil (empty response body)
 - **Accept**: application/json
 
 
+## start_agent_test_session
+
+> <ConversationAgentTestSessionResponse> start_agent_test_session(user_id, test_session_request)
+
+Start a test conversation with this AI agent
+
+Opens a webchat conversation against this specific AI agent as if the given customer had started it from the storefront, so the agent can be tried out before it is put in front of anyone.  The session runs against live data: the cart is real, the customer is real, and anything the agent does during the conversation actually happens.  Requires a logged in user with conversations admin; an API key or OAuth application cannot call this. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the start_agent_test_session_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ConversationAgentTestSessionResponse>, Integer, Hash)> start_agent_test_session_with_http_info(user_id, test_session_request)
+
+```ruby
+begin
+  # Start a test conversation with this AI agent
+  data, status_code, headers = api_instance.start_agent_test_session_with_http_info(user_id, test_session_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ConversationAgentTestSessionResponse>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling ConversationApi->start_agent_test_session_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **user_id** | **Integer** |  |  |
+| **test_session_request** | [**ConversationAgentTestSessionRequest**](ConversationAgentTestSessionRequest.md) | Test session request |  |
+
+### Return type
+
+[**ConversationAgentTestSessionResponse**](ConversationAgentTestSessionResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## start_conversation
 
 > <ConversationStartResponse> start_conversation(start_request)

data/docs/ConversationCustomerAuth.md

@@ -0,0 +1,30 @@
+# UltracartClient::ConversationCustomerAuth
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **conversation_participant_arn** | **String** |  | [optional] |
+| **conversation_participant_name** | **String** |  | [optional] |
+| **join_dts_conversation_participant_arn** | **String** |  | [optional] |
+| **jwt** | **String** |  | [optional] |
+| **merchant_id** | **String** |  | [optional] |
+| **merchant_id_queue_name** | **String** |  | [optional] |
+| **websocket_url** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::ConversationCustomerAuth.new(
+  conversation_participant_arn: null,
+  conversation_participant_name: null,
+  join_dts_conversation_participant_arn: null,
+  jwt: null,
+  merchant_id: null,
+  merchant_id_queue_name: null,
+  websocket_url: null
+)
+```
+

data/docs/SfvbApi.md

@@ -19,6 +19,7 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
 | [**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 |
+| [**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_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 |
@@ -33,6 +34,7 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
 | [**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_file_content**](SfvbApi.md#put_sfvb_file_content) | **PUT** /sfvb/storefronts/{storefront_oid}/files/content | Write a storefront file |
 | [**put_sfvb_preview_session**](SfvbApi.md#put_sfvb_preview_session) | **PUT** /sfvb/storefronts/{storefront_oid}/preview_sessions/{preview_session_id} | Push containers into a preview session |
+| [**put_sfvb_theme_attributes**](SfvbApi.md#put_sfvb_theme_attributes) | **PUT** /sfvb/storefronts/{storefront_oid}/themes/{theme_oid}/attributes | Change a theme's colors, fonts and settings |
 | [**render_sfvb_widgets**](SfvbApi.md#render_sfvb_widgets) | **POST** /sfvb/storefronts/{storefront_oid}/themes/{theme_oid}/render | Render a CJSON node to HTML |
 | [**reserve_sfvb_widget_ids**](SfvbApi.md#reserve_sfvb_widget_ids) | **POST** /sfvb/storefronts/{storefront_oid}/widget_ids | Reserve a block of widget ids |
 | [**revert_sfvb_container**](SfvbApi.md#revert_sfvb_container) | **POST** /sfvb/storefronts/{storefront_oid}/containers/{owner_type}/{owner_object_id}/revert | Revert a container stored outside the file system |
@@ -853,6 +855,60 @@ end
 - **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)
@@ -1604,6 +1660,61 @@ end
 - **Accept**: application/json
 
 
+## put_sfvb_theme_attributes
+
+> <SfvbThemeAttributesResponse> put_sfvb_theme_attributes(storefront_oid, theme_oid, attribute_update_request)
+
+Change a theme's colors, fonts and settings
+
+A partial update.  Only the slots you name are changed and every other slot on the theme keeps its value, so there is no need to send the whole set back to change one color.  Send a whole palette in one call rather than one call per color - they are applied together, so the storefront never renders half of a change.  Needs sfvb_publish when the theme is the one serving live traffic, because a color is referenced by name from every template that uses it and one write repaints the whole storefront at once.  On a dormant theme sfvb_write is enough, which is what makes duplicate-then-restyle work. 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the put_sfvb_theme_attributes_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SfvbThemeAttributesResponse>, Integer, Hash)> put_sfvb_theme_attributes_with_http_info(storefront_oid, theme_oid, attribute_update_request)
+
+```ruby
+begin
+  # Change a theme's colors, fonts and settings
+  data, status_code, headers = api_instance.put_sfvb_theme_attributes_with_http_info(storefront_oid, theme_oid, attribute_update_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SfvbThemeAttributesResponse>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling SfvbApi->put_sfvb_theme_attributes_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **storefront_oid** | **Integer** |  |  |
+| **theme_oid** | **Integer** |  |  |
+| **attribute_update_request** | [**SfvbThemeAttributeUpdateRequest**](SfvbThemeAttributeUpdateRequest.md) | Slots to change |  |
+
+### Return type
+
+[**SfvbThemeAttributesResponse**](SfvbThemeAttributesResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## render_sfvb_widgets
 
 > <SfvbRenderResponse> render_sfvb_widgets(storefront_oid, theme_oid, render_request)

data/docs/SfvbThemeAttribute.md

@@ -0,0 +1,34 @@
+# UltracartClient::SfvbThemeAttribute
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **default_value** | **String** | What the declaring template falls back to when this slot has no value. | [optional] |
+| **deprecated** | **Boolean** | True when the theme marks this slot as on its way out.  Prefer not to build on it. | [optional] |
+| **description** | **String** | What this slot is for, where the theme author documented it. | [optional] |
+| **font** | [**SfvbThemeFont**](SfvbThemeFont.md) |  | [optional] |
+| **name** | **String** | Slot name, for example Theme Color 01.  Returned in the casing the theme's templates declare, which may differ from the casing you wrote.  Compare case insensitively. | [optional] |
+| **type** | **String** | What kind of slot this is, taken from the template that declares it rather than guessed from the value.  orphan means nothing declares it. | [optional] |
+| **undeclared** | **Boolean** | True when no template in this theme references this name.  Writing such a name is allowed and is how the builder stores its own settings, but if you did not mean to create one this is a misspelling and the write changed nothing visible. | [optional] |
+| **unused** | **Boolean** | True when the slot is declared but nothing in the theme actually reads it, so setting it has no visible effect. | [optional] |
+| **value** | **String** | The applied value.  For a colour this is a hex or rgb string, for a boolean the text true or false, for a font the raw JSON document also given in the font field.  When the stored value is empty the current preset's default is filled in here. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbThemeAttribute.new(
+  default_value: null,
+  deprecated: null,
+  description: null,
+  font: null,
+  name: null,
+  type: null,
+  undeclared: null,
+  unused: null,
+  value: null
+)
+```
+

data/docs/SfvbThemeAttributeUpdate.md

@@ -0,0 +1,24 @@
+# UltracartClient::SfvbThemeAttributeUpdate
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **font** | [**SfvbThemeFont**](SfvbThemeFont.md) |  | [optional] |
+| **name** | **String** | Slot name.  Matched without regard to case against what the theme already has, so you do not have to reproduce the exact casing.  A name nothing matches creates a new slot. | [optional] |
+| **type** | **String** | Only consulted when creating a slot the theme does not already have.  For a slot that exists the declared type always wins, because the templates decide it and not the caller. | [optional] |
+| **value** | **String** | The value to store.  An empty string clears the slot, which makes it fall back to the theme's default rather than removing it.  Ignored for a font when the font field is supplied. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbThemeAttributeUpdate.new(
+  font: null,
+  name: null,
+  type: null,
+  value: null
+)
+```
+

data/docs/SfvbThemeAttributeUpdateRequest.md

@@ -0,0 +1,18 @@
+# UltracartClient::SfvbThemeAttributeUpdateRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **attributes** | [**Array<SfvbThemeAttributeUpdate>**](SfvbThemeAttributeUpdate.md) | The slots to change.  Sending several in one call is preferred over one call each - they are applied together, so a palette lands as a single change rather than as a sequence a shopper could see halfway through. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbThemeAttributeUpdateRequest.new(
+  attributes: null
+)
+```
+

data/docs/SfvbThemeAttributesResponse.md

@@ -0,0 +1,24 @@
+# UltracartClient::SfvbThemeAttributesResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **active** | **Boolean** | True when this theme is the one serving live traffic.  Changing an active theme's colours changes what shoppers see immediately, so the write requires the sfvb_publish scope.  Duplicate the theme and restyle the copy to work with an ordinary write scope. | [optional] |
+| **attributes** | [**Array<SfvbThemeAttribute>**](SfvbThemeAttribute.md) | Every slot this theme has, including ones declared by a template but never set.  Sorted by name. | [optional] |
+| **theme_name** | **String** | Theme name, so a caller can confirm it is working on the theme it meant. | [optional] |
+| **theme_oid** | **Integer** | StoreFront theme oid these belong to. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbThemeAttributesResponse.new(
+  active: null,
+  attributes: null,
+  theme_name: null,
+  theme_oid: null
+)
+```
+

data/docs/SfvbThemeFont.md

@@ -0,0 +1,22 @@
+# UltracartClient::SfvbThemeFont
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **families** | [**Array<SfvbThemeFontFamily>**](SfvbThemeFontFamily.md) | Ordered font stack.  The browser uses the first one it can load, so a generic family belongs last as the fallback. | [optional] |
+| **size** | **String** | Font size as a number without units, for example 16.  Empty means the theme decides. | [optional] |
+| **weight** | **String** | CSS font weight, for example 400 or bold.  Empty means the theme decides. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbThemeFont.new(
+  families: null,
+  size: null,
+  weight: null
+)
+```
+

data/docs/SfvbThemeFontFamily.md

@@ -0,0 +1,22 @@
+# UltracartClient::SfvbThemeFontFamily
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **family** | **String** | Family name, for example Montserrat. | [optional] |
+| **kit_id** | **String** | Typekit kit identifier.  Only meaningful when type is typekit. | [optional] |
+| **type** | **String** | Where the font comes from.  native means a font installed on the shopper's machine, generic means a CSS keyword such as serif or sans-serif and belongs last in the stack. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbThemeFontFamily.new(
+  family: null,
+  kit_id: null,
+  type: null
+)
+```
+