ultracart_api 4.1.31 → 4.1.33

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 356e493e1cda66e4aa916676e6711790fda172e9d69493586ae7325fc5c1cca6
-  data.tar.gz: 04fb93d5f314c1fb20bc2ae3749be3d5d85fae4c593cc641c64ea50ed4aafa6f
+  metadata.gz: 6bd605fcee263cc35c856f6df50be7ece87bbe5683b86c54e7a2366e91639998
+  data.tar.gz: 01eea49791850f1d4d8f416fe780cc57bdd31ca194dfa5b7b4f75518c47c9aa1
 SHA512:
-  metadata.gz: 03fbcbba8870dafb2f4c8f72523ae129ca12fdd446d60280dcfb3aa883f72970f80bce0c0edf10adfa5de718ff54455111b72ecc6db142c4fd3be9a0af0b6b00
-  data.tar.gz: 26b7c1a96af69693302ca8f0bd592e3b9711a35312756111a4c87fc16af056c3e94b50d03bae275ede0f27bce65108cbf04cd40d3f19eb0b0ec0073d5d207047
+  metadata.gz: 349154cee847c3ec826108d90022a9957d1f18936c0882a78987934544f28ffd8a4ece78e2f4eef8bcefa8004685cf737aed6f260ed5f6bdaf5cc2e3c3e44807
+  data.tar.gz: 833b98cb8d450c8cc0b1138d1dd622cfb79e69dad04a055cb8bd153d4aa7b8426922d91656d346bc0a84ec29fce407dff42cb6543c44483df063fe08a928d22c

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.31
+- Package version: 4.1.33
 - 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.31'
+gem 'ultracart_api', '4.1.33'
 ```
 
 install:
@@ -130,7 +130,7 @@ Class | Method | HTTP request | Description
 *UltracartClient::CheckoutApi* | [**update_cart**](docs/CheckoutApi.md#update_cart) | **PUT** /checkout/cart | Update cart
 *UltracartClient::CheckoutApi* | [**validate_cart**](docs/CheckoutApi.md#validate_cart) | **POST** /checkout/cart/validate | Validate
 *UltracartClient::ConversationApi* | [**delete_agent_profile_knowledge_base_document**](docs/ConversationApi.md#delete_agent_profile_knowledge_base_document) | **DELETE** /conversation/agent/profiles/{user_id}/knowledge_base/{document_uuid} | Delete a knowledge base document
-*UltracartClient::ConversationApi* | [**delete_agent_profile_mcp**](docs/ConversationApi.md#delete_agent_profile_mcp) | **POST** /conversation/agent/profiles/{user_id}/mcps/{mcp_server_uuid} | Delete an agent MCP server
+*UltracartClient::ConversationApi* | [**delete_agent_profile_mcp**](docs/ConversationApi.md#delete_agent_profile_mcp) | **DELETE** /conversation/agent/profiles/{user_id}/mcps/{mcp_server_uuid} | Delete an agent MCP server
 *UltracartClient::ConversationApi* | [**delete_conversation_canned_message**](docs/ConversationApi.md#delete_conversation_canned_message) | **DELETE** /conversation/canned_messages/{conversation_canned_message_oid} | Delete a conversation canned message
 *UltracartClient::ConversationApi* | [**delete_department**](docs/ConversationApi.md#delete_department) | **DELETE** /conversation/departments/{conversation_department_oid} | Delete a conversation department
 *UltracartClient::ConversationApi* | [**delete_engagement**](docs/ConversationApi.md#delete_engagement) | **DELETE** /conversation/engagements/{conversation_engagement_oid} | Delete a conversation engagement
@@ -212,6 +212,7 @@ Class | Method | HTTP request | Description
 *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_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
 *UltracartClient::ConversationApi* | [**update_conversation_canned_message**](docs/ConversationApi.md#update_conversation_canned_message) | **PUT** /conversation/canned_messages/{conversation_canned_message_oid} | Update a canned message
 *UltracartClient::ConversationApi* | [**update_conversation_department**](docs/ConversationApi.md#update_conversation_department) | **PUT** /conversation/departments/{conversation_department_oid} | Update a department
 *UltracartClient::ConversationApi* | [**update_conversation_engagement**](docs/ConversationApi.md#update_conversation_engagement) | **PUT** /conversation/engagements/{conversation_engagement_oid} | Update a engagement
@@ -1598,6 +1599,8 @@ Not every change is committed to every SDK.
 
 | Version | Date | Comments |
 | --: | :-: | --- |
+| 4.1.33 | 11/26/2025 | conversation - AI agent profile fields |
+| 4.1.32 | 11/20/2025 | conversion api bug fix on incorrect signature |
 | 4.1.31 | 11/20/2025 | conversation - AI agent mcp server tools function |
 | 4.1.30 | 11/19/2025 | conversation - AI agent MCP server configuration methods |
 | 4.1.29 | 11/13/2025 | conversations - AI capabilities flag for generate coupon |

data/docs/ConversationAgentProfile.md

@@ -8,6 +8,7 @@
 | **ai_chat_instructions** | **String** | Additional instructions for this AI when handle web chats | [optional] |
 | **ai_persona** | **String** | Persona of this AI agent | [optional] |
 | **ai_sms_instructions** | **String** | Additional instructions for this AI when handle SMS messages | [optional] |
+| **ai_ticket_instructions** | **String** | Additional instructions for this AI when handling ticket draft replies | [optional] |
 | **chat_limit** | **Integer** | The number of engagement chats that can be pushed on them at any given time. | [optional] |
 | **default_language_iso_code** | **String** | The default language the agent is chatting in | [optional] |
 | **default_status** | **String** | Default status when the agent loads conversations app. | [optional] |
@@ -16,6 +17,8 @@
 | **profile_image_upload_key** | **String** | An upload key used to update the profile image. | [optional] |
 | **profile_image_url** | **String** | Their current profile image URL | [optional] |
 | **user_id** | **Integer** | User ID associated with the agent.  Populated by getAgentProfiles call only. | [optional] |
+| **zohodesk_classifications** | **Array<String>** | Restrict this agent to drafting replies only to tickets with these classifications | [optional] |
+| **zohodesk_departments** | **Array<String>** | Restrict this agent to drafting replies only to these department ids | [optional] |
 
 ## Example
 
@@ -27,6 +30,7 @@ instance = UltracartClient::ConversationAgentProfile.new(
   ai_chat_instructions: null,
   ai_persona: null,
   ai_sms_instructions: null,
+  ai_ticket_instructions: null,
   chat_limit: null,
   default_language_iso_code: null,
   default_status: null,
@@ -34,7 +38,9 @@ instance = UltracartClient::ConversationAgentProfile.new(
   name: null,
   profile_image_upload_key: null,
   profile_image_url: null,
-  user_id: null
+  user_id: null,
+  zohodesk_classifications: null,
+  zohodesk_departments: null
 )
 ```
 

data/docs/ConversationApi.md

@@ -5,7 +5,7 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
 | [**delete_agent_profile_knowledge_base_document**](ConversationApi.md#delete_agent_profile_knowledge_base_document) | **DELETE** /conversation/agent/profiles/{user_id}/knowledge_base/{document_uuid} | Delete a knowledge base document |
-| [**delete_agent_profile_mcp**](ConversationApi.md#delete_agent_profile_mcp) | **POST** /conversation/agent/profiles/{user_id}/mcps/{mcp_server_uuid} | Delete an agent MCP server |
+| [**delete_agent_profile_mcp**](ConversationApi.md#delete_agent_profile_mcp) | **DELETE** /conversation/agent/profiles/{user_id}/mcps/{mcp_server_uuid} | Delete an agent MCP server |
 | [**delete_conversation_canned_message**](ConversationApi.md#delete_conversation_canned_message) | **DELETE** /conversation/canned_messages/{conversation_canned_message_oid} | Delete a conversation canned message |
 | [**delete_department**](ConversationApi.md#delete_department) | **DELETE** /conversation/departments/{conversation_department_oid} | Delete a conversation department |
 | [**delete_engagement**](ConversationApi.md#delete_engagement) | **DELETE** /conversation/engagements/{conversation_engagement_oid} | Delete a conversation engagement |
@@ -87,6 +87,7 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
 | [**sms_unsubscribe_conversation**](ConversationApi.md#sms_unsubscribe_conversation) | **PUT** /conversation/conversations/{conversation_uuid}/sms_unsubscribe | Unsubscribe any SMS participants in this conversation |
 | [**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 |
 | [**update_conversation_canned_message**](ConversationApi.md#update_conversation_canned_message) | **PUT** /conversation/canned_messages/{conversation_canned_message_oid} | Update a canned message |
 | [**update_conversation_department**](ConversationApi.md#update_conversation_department) | **PUT** /conversation/departments/{conversation_department_oid} | Update a department |
 | [**update_conversation_engagement**](ConversationApi.md#update_conversation_engagement) | **PUT** /conversation/engagements/{conversation_engagement_oid} | Update a engagement |
@@ -4546,6 +4547,61 @@ end
 - **Accept**: application/json
 
 
+## update_agent_profile_mcp
+
+> <ConversationMcpServerResponse> update_agent_profile_mcp(user_id, mcp_server_uuid, mcp_server)
+
+Update an agent MCP server
+
+Update an agent MCP server 
+
+
+### Examples
+
+
+(No example for this operation).
+
+
+#### Using the update_agent_profile_mcp_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ConversationMcpServerResponse>, Integer, Hash)> update_agent_profile_mcp_with_http_info(user_id, mcp_server_uuid, mcp_server)
+
+```ruby
+begin
+  # Update an agent MCP server
+  data, status_code, headers = api_instance.update_agent_profile_mcp_with_http_info(user_id, mcp_server_uuid, mcp_server)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ConversationMcpServerResponse>
+rescue UltracartClient::ApiError => e
+  puts "Error when calling ConversationApi->update_agent_profile_mcp_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **user_id** | **Integer** |  |  |
+| **mcp_server_uuid** | **String** |  |  |
+| **mcp_server** | [**ConversationMcpServer**](ConversationMcpServer.md) | MCP Server |  |
+
+### Return type
+
+[**ConversationMcpServerResponse**](ConversationMcpServerResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## update_conversation_canned_message
 
 > <ConversationCannedMessageResponse> update_conversation_canned_message(conversation_canned_message_oid, canned_message)

data/lib/ultracart_api/api/conversation_api.rb

@@ -165,7 +165,7 @@ module UltracartClient
         :return_type => return_type
       )
 
-      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
       if @api_client.config.debugging
         @api_client.config.logger.debug "API called: ConversationApi#delete_agent_profile_mcp\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
@@ -5382,6 +5382,87 @@ module UltracartClient
       return data, status_code, headers
     end
 
+    # Update an agent MCP server
+    # Update an agent MCP server 
+    # @param user_id [Integer] 
+    # @param mcp_server_uuid [String] 
+    # @param mcp_server [ConversationMcpServer] MCP Server
+    # @param [Hash] opts the optional parameters
+    # @return [ConversationMcpServerResponse]
+    def update_agent_profile_mcp(user_id, mcp_server_uuid, mcp_server, opts = {})
+      data, _status_code, _headers = update_agent_profile_mcp_with_http_info(user_id, mcp_server_uuid, mcp_server, opts)
+      data
+    end
+
+    # Update an agent MCP server
+    # Update an agent MCP server 
+    # @param user_id [Integer] 
+    # @param mcp_server_uuid [String] 
+    # @param mcp_server [ConversationMcpServer] MCP Server
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ConversationMcpServerResponse, Integer, Hash)>] ConversationMcpServerResponse data, response status code and response headers
+    def update_agent_profile_mcp_with_http_info(user_id, mcp_server_uuid, mcp_server, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ConversationApi.update_agent_profile_mcp ...'
+      end
+      # verify the required parameter 'user_id' is set
+      if @api_client.config.client_side_validation && user_id.nil?
+        fail ArgumentError, "Missing the required parameter 'user_id' when calling ConversationApi.update_agent_profile_mcp"
+      end
+      # verify the required parameter 'mcp_server_uuid' is set
+      if @api_client.config.client_side_validation && mcp_server_uuid.nil?
+        fail ArgumentError, "Missing the required parameter 'mcp_server_uuid' when calling ConversationApi.update_agent_profile_mcp"
+      end
+      # verify the required parameter 'mcp_server' is set
+      if @api_client.config.client_side_validation && mcp_server.nil?
+        fail ArgumentError, "Missing the required parameter 'mcp_server' when calling ConversationApi.update_agent_profile_mcp"
+      end
+      # resource path
+      local_var_path = '/conversation/agent/profiles/{user_id}/mcps/{mcp_server_uuid}'.sub('{' + 'user_id' + '}', CGI.escape(user_id.to_s)).sub('{' + 'mcp_server_uuid' + '}', CGI.escape(mcp_server_uuid.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
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(mcp_server)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ConversationMcpServerResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ultraCartOauth', 'ultraCartSimpleApiKey']
+
+      new_options = opts.merge(
+        :operation => :"ConversationApi.update_agent_profile_mcp",
+        :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: ConversationApi#update_agent_profile_mcp\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Update a canned message
     # Update a canned message 
     # @param conversation_canned_message_oid [Integer] 

data/lib/ultracart_api/models/conversation_agent_profile.rb

@@ -27,6 +27,9 @@ module UltracartClient
     # Additional instructions for this AI when handle SMS messages
     attr_accessor :ai_sms_instructions
 
+    # Additional instructions for this AI when handling ticket draft replies
+    attr_accessor :ai_ticket_instructions
+
     # The number of engagement chats that can be pushed on them at any given time.
     attr_accessor :chat_limit
 
@@ -51,6 +54,12 @@ module UltracartClient
     # User ID associated with the agent.  Populated by getAgentProfiles call only.
     attr_accessor :user_id
 
+    # Restrict this agent to drafting replies only to tickets with these classifications
+    attr_accessor :zohodesk_classifications
+
+    # Restrict this agent to drafting replies only to these department ids
+    attr_accessor :zohodesk_departments
+
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -80,6 +89,7 @@ module UltracartClient
         :'ai_chat_instructions' => :'ai_chat_instructions',
         :'ai_persona' => :'ai_persona',
         :'ai_sms_instructions' => :'ai_sms_instructions',
+        :'ai_ticket_instructions' => :'ai_ticket_instructions',
         :'chat_limit' => :'chat_limit',
         :'default_language_iso_code' => :'default_language_iso_code',
         :'default_status' => :'default_status',
@@ -87,7 +97,9 @@ module UltracartClient
         :'name' => :'name',
         :'profile_image_upload_key' => :'profile_image_upload_key',
         :'profile_image_url' => :'profile_image_url',
-        :'user_id' => :'user_id'
+        :'user_id' => :'user_id',
+        :'zohodesk_classifications' => :'zohodesk_classifications',
+        :'zohodesk_departments' => :'zohodesk_departments'
       }
     end
 
@@ -103,6 +115,7 @@ module UltracartClient
         :'ai_chat_instructions' => :'String',
         :'ai_persona' => :'String',
         :'ai_sms_instructions' => :'String',
+        :'ai_ticket_instructions' => :'String',
         :'chat_limit' => :'Integer',
         :'default_language_iso_code' => :'String',
         :'default_status' => :'String',
@@ -110,7 +123,9 @@ module UltracartClient
         :'name' => :'String',
         :'profile_image_upload_key' => :'String',
         :'profile_image_url' => :'String',
-        :'user_id' => :'Integer'
+        :'user_id' => :'Integer',
+        :'zohodesk_classifications' => :'Array<String>',
+        :'zohodesk_departments' => :'Array<String>'
       }
     end
 
@@ -151,6 +166,10 @@ module UltracartClient
         self.ai_sms_instructions = attributes[:'ai_sms_instructions']
       end
 
+      if attributes.key?(:'ai_ticket_instructions')
+        self.ai_ticket_instructions = attributes[:'ai_ticket_instructions']
+      end
+
       if attributes.key?(:'chat_limit')
         self.chat_limit = attributes[:'chat_limit']
       end
@@ -182,6 +201,18 @@ module UltracartClient
       if attributes.key?(:'user_id')
         self.user_id = attributes[:'user_id']
       end
+
+      if attributes.key?(:'zohodesk_classifications')
+        if (value = attributes[:'zohodesk_classifications']).is_a?(Array)
+          self.zohodesk_classifications = value
+        end
+      end
+
+      if attributes.key?(:'zohodesk_departments')
+        if (value = attributes[:'zohodesk_departments']).is_a?(Array)
+          self.zohodesk_departments = value
+        end
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -218,6 +249,7 @@ module UltracartClient
           ai_chat_instructions == o.ai_chat_instructions &&
           ai_persona == o.ai_persona &&
           ai_sms_instructions == o.ai_sms_instructions &&
+          ai_ticket_instructions == o.ai_ticket_instructions &&
           chat_limit == o.chat_limit &&
           default_language_iso_code == o.default_language_iso_code &&
           default_status == o.default_status &&
@@ -225,7 +257,9 @@ module UltracartClient
           name == o.name &&
           profile_image_upload_key == o.profile_image_upload_key &&
           profile_image_url == o.profile_image_url &&
-          user_id == o.user_id
+          user_id == o.user_id &&
+          zohodesk_classifications == o.zohodesk_classifications &&
+          zohodesk_departments == o.zohodesk_departments
     end
 
     # @see the `==` method
@@ -237,7 +271,7 @@ module UltracartClient
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [ai, ai_chat_instructions, ai_persona, ai_sms_instructions, chat_limit, default_language_iso_code, default_status, display_name, name, profile_image_upload_key, profile_image_url, user_id].hash
+      [ai, ai_chat_instructions, ai_persona, ai_sms_instructions, ai_ticket_instructions, chat_limit, default_language_iso_code, default_status, display_name, name, profile_image_upload_key, profile_image_url, user_id, zohodesk_classifications, zohodesk_departments].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.31'
+  VERSION = '4.1.33'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ultracart_api
 version: !ruby/object:Gem::Version
-  version: 4.1.31
+  version: 4.1.33
 platform: ruby
 authors:
 - UltraCart
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-20 00:00:00.000000000 Z
+date: 2025-11-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: typhoeus