ultracart_api 4.1.30 → 4.1.31

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 7a845e391cdd0dcac524c109083ccccd725addd41909f047385503d42b1f6dc1
4
- data.tar.gz: 51ca82a1a0564032d0ba104e22a47d4303bf001041dc80ef5dca64ba41c91148
3
+ metadata.gz: 356e493e1cda66e4aa916676e6711790fda172e9d69493586ae7325fc5c1cca6
4
+ data.tar.gz: 04fb93d5f314c1fb20bc2ae3749be3d5d85fae4c593cc641c64ea50ed4aafa6f
5
5
  SHA512:
6
- metadata.gz: 298aff841a5034cb910c2f1edb1b8f84bbe0cbc0183cef5a217304d3438b52306a848751cbfc57de761014440fe6e07e41fae94c424bd7bf82a6209354fc77e4
7
- data.tar.gz: e510059249aee5a9a68d2dcac1697b4b474e8886704549af31481e7b53129418ec424335fe59cf936998892b83d83f3416908b87a523603229e63ba3d19f82ce
6
+ metadata.gz: 03fbcbba8870dafb2f4c8f72523ae129ca12fdd446d60280dcfb3aa883f72970f80bce0c0edf10adfa5de718ff54455111b72ecc6db142c4fd3be9a0af0b6b00
7
+ data.tar.gz: 26b7c1a96af69693302ca8f0bd592e3b9711a35312756111a4c87fc16af056c3e94b50d03bae275ede0f27bce65108cbf04cd40d3f19eb0b0ec0073d5d207047
data/README.md CHANGED
@@ -7,7 +7,7 @@ Note: Every method has a sample for every language. See https://github.com/Ultr
7
7
  This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
8
8
 
9
9
  - API version: 2.0.0
10
- - Package version: 4.1.30
10
+ - Package version: 4.1.31
11
11
  - Build package: org.openapitools.codegen.languages.RubyClientCodegen
12
12
  - For more information, please visit [http://www.ultracart.com/api/](http://www.ultracart.com/api/)
13
13
 
@@ -16,7 +16,7 @@ This SDK is automatically generated by the [OpenAPI Generator](https://openapi-g
16
16
  gemfile:
17
17
 
18
18
  ```shell
19
- gem 'ultracart_api', '4.1.30'
19
+ gem 'ultracart_api', '4.1.31'
20
20
  ```
21
21
 
22
22
  install:
@@ -130,6 +130,7 @@ Class | Method | HTTP request | Description
130
130
  *UltracartClient::CheckoutApi* | [**update_cart**](docs/CheckoutApi.md#update_cart) | **PUT** /checkout/cart | Update cart
131
131
  *UltracartClient::CheckoutApi* | [**validate_cart**](docs/CheckoutApi.md#validate_cart) | **POST** /checkout/cart/validate | Validate
132
132
  *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
133
+ *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
133
134
  *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
134
135
  *UltracartClient::ConversationApi* | [**delete_department**](docs/ConversationApi.md#delete_department) | **DELETE** /conversation/departments/{conversation_department_oid} | Delete a conversation department
135
136
  *UltracartClient::ConversationApi* | [**delete_engagement**](docs/ConversationApi.md#delete_engagement) | **DELETE** /conversation/engagements/{conversation_engagement_oid} | Delete a conversation engagement
@@ -145,6 +146,7 @@ Class | Method | HTTP request | Description
145
146
  *UltracartClient::ConversationApi* | [**get_agent_profile**](docs/ConversationApi.md#get_agent_profile) | **GET** /conversation/agent/profile | Get agent profile
146
147
  *UltracartClient::ConversationApi* | [**get_agent_profile_knowledge_base**](docs/ConversationApi.md#get_agent_profile_knowledge_base) | **GET** /conversation/agent/profiles/{user_id}/knowledge_base | Get the list of knowledge base documents associated with this agent profile
147
148
  *UltracartClient::ConversationApi* | [**get_agent_profile_mcp**](docs/ConversationApi.md#get_agent_profile_mcp) | **GET** /conversation/agent/profiles/{user_id}/mcps/{mcp_server_uuid} | Get an MCP server associated with this agent
149
+ *UltracartClient::ConversationApi* | [**get_agent_profile_mcp_tools**](docs/ConversationApi.md#get_agent_profile_mcp_tools) | **GET** /conversation/agent/profiles/{user_id}/mcps/{mcp_server_uuid}/tools | Get the tools available from the MCP server
148
150
  *UltracartClient::ConversationApi* | [**get_agent_profile_mcps**](docs/ConversationApi.md#get_agent_profile_mcps) | **GET** /conversation/agent/profiles/{user_id}/mcps | Get the list of MCP servers associated with this agent
149
151
  *UltracartClient::ConversationApi* | [**get_agent_profiles**](docs/ConversationApi.md#get_agent_profiles) | **GET** /conversation/agent/profiles | Get agent profiles
150
152
  *UltracartClient::ConversationApi* | [**get_agent_websocket_authorization**](docs/ConversationApi.md#get_agent_websocket_authorization) | **PUT** /conversation/agent/auth | Get agent websocket authorization
@@ -210,7 +212,6 @@ Class | Method | HTTP request | Description
210
212
  *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
211
213
  *UltracartClient::ConversationApi* | [**start_conversation**](docs/ConversationApi.md#start_conversation) | **PUT** /conversation/conversations | Start a conversation
212
214
  *UltracartClient::ConversationApi* | [**update_agent_profile**](docs/ConversationApi.md#update_agent_profile) | **PUT** /conversation/agent/profile | Update agent profile
213
- *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
214
215
  *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
215
216
  *UltracartClient::ConversationApi* | [**update_conversation_department**](docs/ConversationApi.md#update_conversation_department) | **PUT** /conversation/departments/{conversation_department_oid} | Update a department
216
217
  *UltracartClient::ConversationApi* | [**update_conversation_engagement**](docs/ConversationApi.md#update_conversation_engagement) | **PUT** /conversation/engagements/{conversation_engagement_oid} | Update a engagement
@@ -790,6 +791,7 @@ Class | Method | HTTP request | Description
790
791
  - [UltracartClient::ConversationLocationsResponse](docs/ConversationLocationsResponse.md)
791
792
  - [UltracartClient::ConversationMcpServer](docs/ConversationMcpServer.md)
792
793
  - [UltracartClient::ConversationMcpServerResponse](docs/ConversationMcpServerResponse.md)
794
+ - [UltracartClient::ConversationMcpServerToolsResponse](docs/ConversationMcpServerToolsResponse.md)
793
795
  - [UltracartClient::ConversationMcpServersResponse](docs/ConversationMcpServersResponse.md)
794
796
  - [UltracartClient::ConversationMessage](docs/ConversationMessage.md)
795
797
  - [UltracartClient::ConversationMessageTranslation](docs/ConversationMessageTranslation.md)
@@ -1596,6 +1598,7 @@ Not every change is committed to every SDK.
1596
1598
 
1597
1599
  | Version | Date | Comments |
1598
1600
  | --: | :-: | --- |
1601
+ | 4.1.31 | 11/20/2025 | conversation - AI agent mcp server tools function |
1599
1602
  | 4.1.30 | 11/19/2025 | conversation - AI agent MCP server configuration methods |
1600
1603
  | 4.1.29 | 11/13/2025 | conversations - AI capabilities flag for generate coupon |
1601
1604
  | 4.1.28 | 11/07/2025 | OrderApi.assignToAffiliate |
@@ -5,6 +5,7 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
5
5
  | Method | HTTP request | Description |
6
6
  | ------ | ------------ | ----------- |
7
7
  | [**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 |
8
+ | [**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 |
8
9
  | [**delete_conversation_canned_message**](ConversationApi.md#delete_conversation_canned_message) | **DELETE** /conversation/canned_messages/{conversation_canned_message_oid} | Delete a conversation canned message |
9
10
  | [**delete_department**](ConversationApi.md#delete_department) | **DELETE** /conversation/departments/{conversation_department_oid} | Delete a conversation department |
10
11
  | [**delete_engagement**](ConversationApi.md#delete_engagement) | **DELETE** /conversation/engagements/{conversation_engagement_oid} | Delete a conversation engagement |
@@ -20,6 +21,7 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
20
21
  | [**get_agent_profile**](ConversationApi.md#get_agent_profile) | **GET** /conversation/agent/profile | Get agent profile |
21
22
  | [**get_agent_profile_knowledge_base**](ConversationApi.md#get_agent_profile_knowledge_base) | **GET** /conversation/agent/profiles/{user_id}/knowledge_base | Get the list of knowledge base documents associated with this agent profile |
22
23
  | [**get_agent_profile_mcp**](ConversationApi.md#get_agent_profile_mcp) | **GET** /conversation/agent/profiles/{user_id}/mcps/{mcp_server_uuid} | Get an MCP server associated with this agent |
24
+ | [**get_agent_profile_mcp_tools**](ConversationApi.md#get_agent_profile_mcp_tools) | **GET** /conversation/agent/profiles/{user_id}/mcps/{mcp_server_uuid}/tools | Get the tools available from the MCP server |
23
25
  | [**get_agent_profile_mcps**](ConversationApi.md#get_agent_profile_mcps) | **GET** /conversation/agent/profiles/{user_id}/mcps | Get the list of MCP servers associated with this agent |
24
26
  | [**get_agent_profiles**](ConversationApi.md#get_agent_profiles) | **GET** /conversation/agent/profiles | Get agent profiles |
25
27
  | [**get_agent_websocket_authorization**](ConversationApi.md#get_agent_websocket_authorization) | **PUT** /conversation/agent/auth | Get agent websocket authorization |
@@ -85,7 +87,6 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
85
87
  | [**sms_unsubscribe_conversation**](ConversationApi.md#sms_unsubscribe_conversation) | **PUT** /conversation/conversations/{conversation_uuid}/sms_unsubscribe | Unsubscribe any SMS participants in this conversation |
86
88
  | [**start_conversation**](ConversationApi.md#start_conversation) | **PUT** /conversation/conversations | Start a conversation |
87
89
  | [**update_agent_profile**](ConversationApi.md#update_agent_profile) | **PUT** /conversation/agent/profile | Update agent profile |
88
- | [**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 |
89
90
  | [**update_conversation_canned_message**](ConversationApi.md#update_conversation_canned_message) | **PUT** /conversation/canned_messages/{conversation_canned_message_oid} | Update a canned message |
90
91
  | [**update_conversation_department**](ConversationApi.md#update_conversation_department) | **PUT** /conversation/departments/{conversation_department_oid} | Update a department |
91
92
  | [**update_conversation_engagement**](ConversationApi.md#update_conversation_engagement) | **PUT** /conversation/engagements/{conversation_engagement_oid} | Update a engagement |
@@ -156,6 +157,60 @@ end
156
157
  - **Accept**: application/json
157
158
 
158
159
 
160
+ ## delete_agent_profile_mcp
161
+
162
+ > delete_agent_profile_mcp(user_id, mcp_server_uuid)
163
+
164
+ Delete an agent MCP server
165
+
166
+ Delete an agent MCP server
167
+
168
+
169
+ ### Examples
170
+
171
+
172
+ (No example for this operation).
173
+
174
+
175
+ #### Using the delete_agent_profile_mcp_with_http_info variant
176
+
177
+ This returns an Array which contains the response data (`nil` in this case), status code and headers.
178
+
179
+ > <Array(nil, Integer, Hash)> delete_agent_profile_mcp_with_http_info(user_id, mcp_server_uuid)
180
+
181
+ ```ruby
182
+ begin
183
+ # Delete an agent MCP server
184
+ data, status_code, headers = api_instance.delete_agent_profile_mcp_with_http_info(user_id, mcp_server_uuid)
185
+ p status_code # => 2xx
186
+ p headers # => { ... }
187
+ p data # => nil
188
+ rescue UltracartClient::ApiError => e
189
+ puts "Error when calling ConversationApi->delete_agent_profile_mcp_with_http_info: #{e}"
190
+ end
191
+ ```
192
+
193
+ ### Parameters
194
+
195
+ | Name | Type | Description | Notes |
196
+ | ---- | ---- | ----------- | ----- |
197
+ | **user_id** | **Integer** | | |
198
+ | **mcp_server_uuid** | **String** | | |
199
+
200
+ ### Return type
201
+
202
+ nil (empty response body)
203
+
204
+ ### Authorization
205
+
206
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
207
+
208
+ ### HTTP request headers
209
+
210
+ - **Content-Type**: Not defined
211
+ - **Accept**: application/json
212
+
213
+
159
214
  ## delete_conversation_canned_message
160
215
 
161
216
  > delete_conversation_canned_message(conversation_canned_message_oid)
@@ -962,6 +1017,60 @@ end
962
1017
  - **Accept**: application/json
963
1018
 
964
1019
 
1020
+ ## get_agent_profile_mcp_tools
1021
+
1022
+ > <ConversationMcpServerToolsResponse> get_agent_profile_mcp_tools(user_id, mcp_server_uuid)
1023
+
1024
+ Get the tools available from the MCP server
1025
+
1026
+ Get the tools available from the MCP server
1027
+
1028
+
1029
+ ### Examples
1030
+
1031
+
1032
+ (No example for this operation).
1033
+
1034
+
1035
+ #### Using the get_agent_profile_mcp_tools_with_http_info variant
1036
+
1037
+ This returns an Array which contains the response data, status code and headers.
1038
+
1039
+ > <Array(<ConversationMcpServerToolsResponse>, Integer, Hash)> get_agent_profile_mcp_tools_with_http_info(user_id, mcp_server_uuid)
1040
+
1041
+ ```ruby
1042
+ begin
1043
+ # Get the tools available from the MCP server
1044
+ data, status_code, headers = api_instance.get_agent_profile_mcp_tools_with_http_info(user_id, mcp_server_uuid)
1045
+ p status_code # => 2xx
1046
+ p headers # => { ... }
1047
+ p data # => <ConversationMcpServerToolsResponse>
1048
+ rescue UltracartClient::ApiError => e
1049
+ puts "Error when calling ConversationApi->get_agent_profile_mcp_tools_with_http_info: #{e}"
1050
+ end
1051
+ ```
1052
+
1053
+ ### Parameters
1054
+
1055
+ | Name | Type | Description | Notes |
1056
+ | ---- | ---- | ----------- | ----- |
1057
+ | **user_id** | **Integer** | | |
1058
+ | **mcp_server_uuid** | **String** | | |
1059
+
1060
+ ### Return type
1061
+
1062
+ [**ConversationMcpServerToolsResponse**](ConversationMcpServerToolsResponse.md)
1063
+
1064
+ ### Authorization
1065
+
1066
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
1067
+
1068
+ ### HTTP request headers
1069
+
1070
+ - **Content-Type**: Not defined
1071
+ - **Accept**: application/json
1072
+
1073
+
965
1074
  ## get_agent_profile_mcps
966
1075
 
967
1076
  > <ConversationMcpServersResponse> get_agent_profile_mcps(user_id)
@@ -4437,61 +4546,6 @@ end
4437
4546
  - **Accept**: application/json
4438
4547
 
4439
4548
 
4440
- ## update_agent_profile_mcp
4441
-
4442
- > <ConversationMcpServerResponse> update_agent_profile_mcp(user_id, mcp_server_uuid, mcp_server)
4443
-
4444
- Update an agent MCP server
4445
-
4446
- Update an agent MCP server
4447
-
4448
-
4449
- ### Examples
4450
-
4451
-
4452
- (No example for this operation).
4453
-
4454
-
4455
- #### Using the update_agent_profile_mcp_with_http_info variant
4456
-
4457
- This returns an Array which contains the response data, status code and headers.
4458
-
4459
- > <Array(<ConversationMcpServerResponse>, Integer, Hash)> update_agent_profile_mcp_with_http_info(user_id, mcp_server_uuid, mcp_server)
4460
-
4461
- ```ruby
4462
- begin
4463
- # Update an agent MCP server
4464
- data, status_code, headers = api_instance.update_agent_profile_mcp_with_http_info(user_id, mcp_server_uuid, mcp_server)
4465
- p status_code # => 2xx
4466
- p headers # => { ... }
4467
- p data # => <ConversationMcpServerResponse>
4468
- rescue UltracartClient::ApiError => e
4469
- puts "Error when calling ConversationApi->update_agent_profile_mcp_with_http_info: #{e}"
4470
- end
4471
- ```
4472
-
4473
- ### Parameters
4474
-
4475
- | Name | Type | Description | Notes |
4476
- | ---- | ---- | ----------- | ----- |
4477
- | **user_id** | **Integer** | | |
4478
- | **mcp_server_uuid** | **String** | | |
4479
- | **mcp_server** | [**ConversationMcpServer**](ConversationMcpServer.md) | MCP Server | |
4480
-
4481
- ### Return type
4482
-
4483
- [**ConversationMcpServerResponse**](ConversationMcpServerResponse.md)
4484
-
4485
- ### Authorization
4486
-
4487
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
4488
-
4489
- ### HTTP request headers
4490
-
4491
- - **Content-Type**: application/json
4492
- - **Accept**: application/json
4493
-
4494
-
4495
4549
  ## update_conversation_canned_message
4496
4550
 
4497
4551
  > <ConversationCannedMessageResponse> update_conversation_canned_message(conversation_canned_message_oid, canned_message)
@@ -0,0 +1,26 @@
1
+ # UltracartClient::ConversationMcpServerToolsResponse
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **error** | [**Error**](Error.md) | | [optional] |
8
+ | **metadata** | [**ResponseMetadata**](ResponseMetadata.md) | | [optional] |
9
+ | **success** | **Boolean** | Indicates if API call was successful | [optional] |
10
+ | **tools_json** | **String** | | [optional] |
11
+ | **warning** | [**Warning**](Warning.md) | | [optional] |
12
+
13
+ ## Example
14
+
15
+ ```ruby
16
+ require 'ultracart_api'
17
+
18
+ instance = UltracartClient::ConversationMcpServerToolsResponse.new(
19
+ error: null,
20
+ metadata: null,
21
+ success: null,
22
+ tools_json: null,
23
+ warning: null
24
+ )
25
+ ```
26
+
@@ -102,6 +102,76 @@ module UltracartClient
102
102
  return data, status_code, headers
103
103
  end
104
104
 
105
+ # Delete an agent MCP server
106
+ # Delete an agent MCP server
107
+ # @param user_id [Integer]
108
+ # @param mcp_server_uuid [String]
109
+ # @param [Hash] opts the optional parameters
110
+ # @return [nil]
111
+ def delete_agent_profile_mcp(user_id, mcp_server_uuid, opts = {})
112
+ delete_agent_profile_mcp_with_http_info(user_id, mcp_server_uuid, opts)
113
+ nil
114
+ end
115
+
116
+ # Delete an agent MCP server
117
+ # Delete an agent MCP server
118
+ # @param user_id [Integer]
119
+ # @param mcp_server_uuid [String]
120
+ # @param [Hash] opts the optional parameters
121
+ # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
122
+ def delete_agent_profile_mcp_with_http_info(user_id, mcp_server_uuid, opts = {})
123
+ if @api_client.config.debugging
124
+ @api_client.config.logger.debug 'Calling API: ConversationApi.delete_agent_profile_mcp ...'
125
+ end
126
+ # verify the required parameter 'user_id' is set
127
+ if @api_client.config.client_side_validation && user_id.nil?
128
+ fail ArgumentError, "Missing the required parameter 'user_id' when calling ConversationApi.delete_agent_profile_mcp"
129
+ end
130
+ # verify the required parameter 'mcp_server_uuid' is set
131
+ if @api_client.config.client_side_validation && mcp_server_uuid.nil?
132
+ fail ArgumentError, "Missing the required parameter 'mcp_server_uuid' when calling ConversationApi.delete_agent_profile_mcp"
133
+ end
134
+ # resource path
135
+ 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))
136
+
137
+ # query parameters
138
+ query_params = opts[:query_params] || {}
139
+
140
+ # header parameters
141
+ header_params = opts[:header_params] || {}
142
+ header_params['X-UltraCart-Api-Version'] = @api_client.select_header_api_version()
143
+ # HTTP header 'Accept' (if needed)
144
+ header_params['Accept'] = @api_client.select_header_accept(['application/json'])
145
+
146
+ # form parameters
147
+ form_params = opts[:form_params] || {}
148
+
149
+ # http body (model)
150
+ post_body = opts[:debug_body]
151
+
152
+ # return_type
153
+ return_type = opts[:debug_return_type]
154
+
155
+ # auth_names
156
+ auth_names = opts[:debug_auth_names] || ['ultraCartOauth', 'ultraCartSimpleApiKey']
157
+
158
+ new_options = opts.merge(
159
+ :operation => :"ConversationApi.delete_agent_profile_mcp",
160
+ :header_params => header_params,
161
+ :query_params => query_params,
162
+ :form_params => form_params,
163
+ :body => post_body,
164
+ :auth_names => auth_names,
165
+ :return_type => return_type
166
+ )
167
+
168
+ data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
169
+ if @api_client.config.debugging
170
+ @api_client.config.logger.debug "API called: ConversationApi#delete_agent_profile_mcp\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
171
+ end
172
+ return data, status_code, headers
173
+ end
174
+
105
175
  # Delete a conversation canned message
106
176
  # Delete a conversation canned message
107
177
  # @param conversation_canned_message_oid [Integer]
@@ -1062,6 +1132,76 @@ module UltracartClient
1062
1132
  return data, status_code, headers
1063
1133
  end
1064
1134
 
1135
+ # Get the tools available from the MCP server
1136
+ # Get the tools available from the MCP server
1137
+ # @param user_id [Integer]
1138
+ # @param mcp_server_uuid [String]
1139
+ # @param [Hash] opts the optional parameters
1140
+ # @return [ConversationMcpServerToolsResponse]
1141
+ def get_agent_profile_mcp_tools(user_id, mcp_server_uuid, opts = {})
1142
+ data, _status_code, _headers = get_agent_profile_mcp_tools_with_http_info(user_id, mcp_server_uuid, opts)
1143
+ data
1144
+ end
1145
+
1146
+ # Get the tools available from the MCP server
1147
+ # Get the tools available from the MCP server
1148
+ # @param user_id [Integer]
1149
+ # @param mcp_server_uuid [String]
1150
+ # @param [Hash] opts the optional parameters
1151
+ # @return [Array<(ConversationMcpServerToolsResponse, Integer, Hash)>] ConversationMcpServerToolsResponse data, response status code and response headers
1152
+ def get_agent_profile_mcp_tools_with_http_info(user_id, mcp_server_uuid, opts = {})
1153
+ if @api_client.config.debugging
1154
+ @api_client.config.logger.debug 'Calling API: ConversationApi.get_agent_profile_mcp_tools ...'
1155
+ end
1156
+ # verify the required parameter 'user_id' is set
1157
+ if @api_client.config.client_side_validation && user_id.nil?
1158
+ fail ArgumentError, "Missing the required parameter 'user_id' when calling ConversationApi.get_agent_profile_mcp_tools"
1159
+ end
1160
+ # verify the required parameter 'mcp_server_uuid' is set
1161
+ if @api_client.config.client_side_validation && mcp_server_uuid.nil?
1162
+ fail ArgumentError, "Missing the required parameter 'mcp_server_uuid' when calling ConversationApi.get_agent_profile_mcp_tools"
1163
+ end
1164
+ # resource path
1165
+ local_var_path = '/conversation/agent/profiles/{user_id}/mcps/{mcp_server_uuid}/tools'.sub('{' + 'user_id' + '}', CGI.escape(user_id.to_s)).sub('{' + 'mcp_server_uuid' + '}', CGI.escape(mcp_server_uuid.to_s))
1166
+
1167
+ # query parameters
1168
+ query_params = opts[:query_params] || {}
1169
+
1170
+ # header parameters
1171
+ header_params = opts[:header_params] || {}
1172
+ header_params['X-UltraCart-Api-Version'] = @api_client.select_header_api_version()
1173
+ # HTTP header 'Accept' (if needed)
1174
+ header_params['Accept'] = @api_client.select_header_accept(['application/json'])
1175
+
1176
+ # form parameters
1177
+ form_params = opts[:form_params] || {}
1178
+
1179
+ # http body (model)
1180
+ post_body = opts[:debug_body]
1181
+
1182
+ # return_type
1183
+ return_type = opts[:debug_return_type] || 'ConversationMcpServerToolsResponse'
1184
+
1185
+ # auth_names
1186
+ auth_names = opts[:debug_auth_names] || ['ultraCartOauth', 'ultraCartSimpleApiKey']
1187
+
1188
+ new_options = opts.merge(
1189
+ :operation => :"ConversationApi.get_agent_profile_mcp_tools",
1190
+ :header_params => header_params,
1191
+ :query_params => query_params,
1192
+ :form_params => form_params,
1193
+ :body => post_body,
1194
+ :auth_names => auth_names,
1195
+ :return_type => return_type
1196
+ )
1197
+
1198
+ data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
1199
+ if @api_client.config.debugging
1200
+ @api_client.config.logger.debug "API called: ConversationApi#get_agent_profile_mcp_tools\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
1201
+ end
1202
+ return data, status_code, headers
1203
+ end
1204
+
1065
1205
  # Get the list of MCP servers associated with this agent
1066
1206
  # Retrieve MCP servers associated with this agent
1067
1207
  # @param user_id [Integer]
@@ -5242,87 +5382,6 @@ module UltracartClient
5242
5382
  return data, status_code, headers
5243
5383
  end
5244
5384
 
5245
- # Update an agent MCP server
5246
- # Update an agent MCP server
5247
- # @param user_id [Integer]
5248
- # @param mcp_server_uuid [String]
5249
- # @param mcp_server [ConversationMcpServer] MCP Server
5250
- # @param [Hash] opts the optional parameters
5251
- # @return [ConversationMcpServerResponse]
5252
- def update_agent_profile_mcp(user_id, mcp_server_uuid, mcp_server, opts = {})
5253
- data, _status_code, _headers = update_agent_profile_mcp_with_http_info(user_id, mcp_server_uuid, mcp_server, opts)
5254
- data
5255
- end
5256
-
5257
- # Update an agent MCP server
5258
- # Update an agent MCP server
5259
- # @param user_id [Integer]
5260
- # @param mcp_server_uuid [String]
5261
- # @param mcp_server [ConversationMcpServer] MCP Server
5262
- # @param [Hash] opts the optional parameters
5263
- # @return [Array<(ConversationMcpServerResponse, Integer, Hash)>] ConversationMcpServerResponse data, response status code and response headers
5264
- def update_agent_profile_mcp_with_http_info(user_id, mcp_server_uuid, mcp_server, opts = {})
5265
- if @api_client.config.debugging
5266
- @api_client.config.logger.debug 'Calling API: ConversationApi.update_agent_profile_mcp ...'
5267
- end
5268
- # verify the required parameter 'user_id' is set
5269
- if @api_client.config.client_side_validation && user_id.nil?
5270
- fail ArgumentError, "Missing the required parameter 'user_id' when calling ConversationApi.update_agent_profile_mcp"
5271
- end
5272
- # verify the required parameter 'mcp_server_uuid' is set
5273
- if @api_client.config.client_side_validation && mcp_server_uuid.nil?
5274
- fail ArgumentError, "Missing the required parameter 'mcp_server_uuid' when calling ConversationApi.update_agent_profile_mcp"
5275
- end
5276
- # verify the required parameter 'mcp_server' is set
5277
- if @api_client.config.client_side_validation && mcp_server.nil?
5278
- fail ArgumentError, "Missing the required parameter 'mcp_server' when calling ConversationApi.update_agent_profile_mcp"
5279
- end
5280
- # resource path
5281
- 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))
5282
-
5283
- # query parameters
5284
- query_params = opts[:query_params] || {}
5285
-
5286
- # header parameters
5287
- header_params = opts[:header_params] || {}
5288
- header_params['X-UltraCart-Api-Version'] = @api_client.select_header_api_version()
5289
- # HTTP header 'Accept' (if needed)
5290
- header_params['Accept'] = @api_client.select_header_accept(['application/json'])
5291
- # HTTP header 'Content-Type'
5292
- content_type = @api_client.select_header_content_type(['application/json'])
5293
- if !content_type.nil?
5294
- header_params['Content-Type'] = content_type
5295
- end
5296
-
5297
- # form parameters
5298
- form_params = opts[:form_params] || {}
5299
-
5300
- # http body (model)
5301
- post_body = opts[:debug_body] || @api_client.object_to_http_body(mcp_server)
5302
-
5303
- # return_type
5304
- return_type = opts[:debug_return_type] || 'ConversationMcpServerResponse'
5305
-
5306
- # auth_names
5307
- auth_names = opts[:debug_auth_names] || ['ultraCartOauth', 'ultraCartSimpleApiKey']
5308
-
5309
- new_options = opts.merge(
5310
- :operation => :"ConversationApi.update_agent_profile_mcp",
5311
- :header_params => header_params,
5312
- :query_params => query_params,
5313
- :form_params => form_params,
5314
- :body => post_body,
5315
- :auth_names => auth_names,
5316
- :return_type => return_type
5317
- )
5318
-
5319
- data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
5320
- if @api_client.config.debugging
5321
- @api_client.config.logger.debug "API called: ConversationApi#update_agent_profile_mcp\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
5322
- end
5323
- return data, status_code, headers
5324
- end
5325
-
5326
5385
  # Update a canned message
5327
5386
  # Update a canned message
5328
5387
  # @param conversation_canned_message_oid [Integer]
@@ -0,0 +1,256 @@
1
+ =begin
2
+ #UltraCart Rest API V2
3
+
4
+ #UltraCart REST API Version 2
5
+
6
+ The version of the OpenAPI document: 2.0.0
7
+ Contact: support@ultracart.com
8
+ Generated by: https://openapi-generator.tech
9
+ OpenAPI Generator version: 6.0.1-SNAPSHOT
10
+
11
+ =end
12
+
13
+ require 'date'
14
+ require 'time'
15
+
16
+ module UltracartClient
17
+ class ConversationMcpServerToolsResponse
18
+ attr_accessor :error
19
+
20
+ attr_accessor :metadata
21
+
22
+ # Indicates if API call was successful
23
+ attr_accessor :success
24
+
25
+ attr_accessor :tools_json
26
+
27
+ attr_accessor :warning
28
+
29
+ # Attribute mapping from ruby-style variable name to JSON key.
30
+ def self.attribute_map
31
+ {
32
+ :'error' => :'error',
33
+ :'metadata' => :'metadata',
34
+ :'success' => :'success',
35
+ :'tools_json' => :'tools_json',
36
+ :'warning' => :'warning'
37
+ }
38
+ end
39
+
40
+ # Returns all the JSON keys this model knows about
41
+ def self.acceptable_attributes
42
+ attribute_map.values
43
+ end
44
+
45
+ # Attribute type mapping.
46
+ def self.openapi_types
47
+ {
48
+ :'error' => :'Error',
49
+ :'metadata' => :'ResponseMetadata',
50
+ :'success' => :'Boolean',
51
+ :'tools_json' => :'String',
52
+ :'warning' => :'Warning'
53
+ }
54
+ end
55
+
56
+ # List of attributes with nullable: true
57
+ def self.openapi_nullable
58
+ Set.new([
59
+ ])
60
+ end
61
+
62
+ # Initializes the object
63
+ # @param [Hash] attributes Model attributes in the form of hash
64
+ def initialize(attributes = {})
65
+ if (!attributes.is_a?(Hash))
66
+ fail ArgumentError, "The input argument (attributes) must be a hash in `UltracartClient::ConversationMcpServerToolsResponse` initialize method"
67
+ end
68
+
69
+ # check to see if the attribute exists and convert string to symbol for hash key
70
+ attributes = attributes.each_with_object({}) { |(k, v), h|
71
+ if (!self.class.attribute_map.key?(k.to_sym))
72
+ fail ArgumentError, "`#{k}` is not a valid attribute in `UltracartClient::ConversationMcpServerToolsResponse`. Please check the name to make sure it's valid. List of attributes: " + self.class.attribute_map.keys.inspect
73
+ end
74
+ h[k.to_sym] = v
75
+ }
76
+
77
+ if attributes.key?(:'error')
78
+ self.error = attributes[:'error']
79
+ end
80
+
81
+ if attributes.key?(:'metadata')
82
+ self.metadata = attributes[:'metadata']
83
+ end
84
+
85
+ if attributes.key?(:'success')
86
+ self.success = attributes[:'success']
87
+ end
88
+
89
+ if attributes.key?(:'tools_json')
90
+ self.tools_json = attributes[:'tools_json']
91
+ end
92
+
93
+ if attributes.key?(:'warning')
94
+ self.warning = attributes[:'warning']
95
+ end
96
+ end
97
+
98
+ # Show invalid properties with the reasons. Usually used together with valid?
99
+ # @return Array for valid properties with the reasons
100
+ def list_invalid_properties
101
+ invalid_properties = Array.new
102
+ invalid_properties
103
+ end
104
+
105
+ # Check to see if the all the properties in the model are valid
106
+ # @return true if the model is valid
107
+ def valid?
108
+ true
109
+ end
110
+
111
+ # Checks equality by comparing each attribute.
112
+ # @param [Object] Object to be compared
113
+ def ==(o)
114
+ return true if self.equal?(o)
115
+ self.class == o.class &&
116
+ error == o.error &&
117
+ metadata == o.metadata &&
118
+ success == o.success &&
119
+ tools_json == o.tools_json &&
120
+ warning == o.warning
121
+ end
122
+
123
+ # @see the `==` method
124
+ # @param [Object] Object to be compared
125
+ def eql?(o)
126
+ self == o
127
+ end
128
+
129
+ # Calculates hash code according to all attributes.
130
+ # @return [Integer] Hash code
131
+ def hash
132
+ [error, metadata, success, tools_json, warning].hash
133
+ end
134
+
135
+ # Builds the object from hash
136
+ # @param [Hash] attributes Model attributes in the form of hash
137
+ # @return [Object] Returns the model itself
138
+ def self.build_from_hash(attributes)
139
+ new.build_from_hash(attributes)
140
+ end
141
+
142
+ # Builds the object from hash
143
+ # @param [Hash] attributes Model attributes in the form of hash
144
+ # @return [Object] Returns the model itself
145
+ def build_from_hash(attributes)
146
+ return nil unless attributes.is_a?(Hash)
147
+ attributes = attributes.transform_keys(&:to_sym)
148
+ self.class.openapi_types.each_pair do |key, type|
149
+ if attributes[self.class.attribute_map[key]].nil? && self.class.openapi_nullable.include?(key)
150
+ self.send("#{key}=", nil)
151
+ elsif type =~ /\AArray<(.*)>/i
152
+ # check to ensure the input is an array given that the attribute
153
+ # is documented as an array but the input is not
154
+ if attributes[self.class.attribute_map[key]].is_a?(Array)
155
+ self.send("#{key}=", attributes[self.class.attribute_map[key]].map { |v| _deserialize($1, v) })
156
+ end
157
+ elsif !attributes[self.class.attribute_map[key]].nil?
158
+ self.send("#{key}=", _deserialize(type, attributes[self.class.attribute_map[key]]))
159
+ end
160
+ end
161
+
162
+ self
163
+ end
164
+
165
+ # Deserializes the data based on type
166
+ # @param string type Data type
167
+ # @param string value Value to be deserialized
168
+ # @return [Object] Deserialized data
169
+ def _deserialize(type, value)
170
+ case type.to_sym
171
+ when :Time
172
+ Time.parse(value)
173
+ when :Date
174
+ Date.parse(value)
175
+ when :String
176
+ value.to_s
177
+ when :Integer
178
+ value.to_i
179
+ when :Float
180
+ value.to_f
181
+ when :Boolean
182
+ if value.to_s =~ /\A(true|t|yes|y|1)\z/i
183
+ true
184
+ else
185
+ false
186
+ end
187
+ when :Object
188
+ # generic object (usually a Hash), return directly
189
+ value
190
+ when /\AArray<(?<inner_type>.+)>\z/
191
+ inner_type = Regexp.last_match[:inner_type]
192
+ value.map { |v| _deserialize(inner_type, v) }
193
+ when /\AHash<(?<k_type>.+?), (?<v_type>.+)>\z/
194
+ k_type = Regexp.last_match[:k_type]
195
+ v_type = Regexp.last_match[:v_type]
196
+ {}.tap do |hash|
197
+ value.each do |k, v|
198
+ hash[_deserialize(k_type, k)] = _deserialize(v_type, v)
199
+ end
200
+ end
201
+ else # model
202
+ # models (e.g. Pet) or oneOf
203
+ klass = UltracartClient.const_get(type)
204
+ klass.respond_to?(:openapi_one_of) ? klass.build(value) : klass.build_from_hash(value)
205
+ end
206
+ end
207
+
208
+ # Returns the string representation of the object
209
+ # @return [String] String presentation of the object
210
+ def to_s
211
+ to_hash.to_s
212
+ end
213
+
214
+ # to_body is an alias to to_hash (backward compatibility)
215
+ # @return [Hash] Returns the object in the form of hash
216
+ def to_body
217
+ to_hash
218
+ end
219
+
220
+ # Returns the object in the form of hash
221
+ # @return [Hash] Returns the object in the form of hash
222
+ def to_hash
223
+ hash = {}
224
+ self.class.attribute_map.each_pair do |attr, param|
225
+ value = self.send(attr)
226
+ if value.nil?
227
+ is_nullable = self.class.openapi_nullable.include?(attr)
228
+ next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
229
+ end
230
+
231
+ hash[param] = _to_hash(value)
232
+ end
233
+ hash
234
+ end
235
+
236
+ # Outputs non-array value in the form of hash
237
+ # For object, use to_hash. Otherwise, just return the value
238
+ # @param [Object] value Any valid value
239
+ # @return [Hash] Returns the value in the form of hash
240
+ def _to_hash(value)
241
+ if value.is_a?(Array)
242
+ value.compact.map { |v| _to_hash(v) }
243
+ elsif value.is_a?(Hash)
244
+ {}.tap do |hash|
245
+ value.each { |k, v| hash[k] = _to_hash(v) }
246
+ end
247
+ elsif value.respond_to? :to_hash
248
+ value.to_hash
249
+ else
250
+ value
251
+ end
252
+ end
253
+
254
+ end
255
+
256
+ end
@@ -11,5 +11,5 @@ OpenAPI Generator version: 6.0.1-SNAPSHOT
11
11
  =end
12
12
 
13
13
  module UltracartClient
14
- VERSION = '4.1.30'
14
+ VERSION = '4.1.31'
15
15
  end
data/lib/ultracart_api.rb CHANGED
@@ -188,6 +188,7 @@ require 'ultracart_api/models/conversation_location_state_province'
188
188
  require 'ultracart_api/models/conversation_locations_response'
189
189
  require 'ultracart_api/models/conversation_mcp_server'
190
190
  require 'ultracart_api/models/conversation_mcp_server_response'
191
+ require 'ultracart_api/models/conversation_mcp_server_tools_response'
191
192
  require 'ultracart_api/models/conversation_mcp_servers_response'
192
193
  require 'ultracart_api/models/conversation_message'
193
194
  require 'ultracart_api/models/conversation_message_translation'
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: ultracart_api
3
3
  version: !ruby/object:Gem::Version
4
- version: 4.1.30
4
+ version: 4.1.31
5
5
  platform: ruby
6
6
  authors:
7
7
  - UltraCart
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2025-11-19 00:00:00.000000000 Z
11
+ date: 2025-11-20 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: typhoeus
@@ -237,6 +237,7 @@ files:
237
237
  - docs/ConversationLocationsResponse.md
238
238
  - docs/ConversationMcpServer.md
239
239
  - docs/ConversationMcpServerResponse.md
240
+ - docs/ConversationMcpServerToolsResponse.md
240
241
  - docs/ConversationMcpServersResponse.md
241
242
  - docs/ConversationMessage.md
242
243
  - docs/ConversationMessageTranslation.md
@@ -1179,6 +1180,7 @@ files:
1179
1180
  - lib/ultracart_api/models/conversation_locations_response.rb
1180
1181
  - lib/ultracart_api/models/conversation_mcp_server.rb
1181
1182
  - lib/ultracart_api/models/conversation_mcp_server_response.rb
1183
+ - lib/ultracart_api/models/conversation_mcp_server_tools_response.rb
1182
1184
  - lib/ultracart_api/models/conversation_mcp_servers_response.rb
1183
1185
  - lib/ultracart_api/models/conversation_message.rb
1184
1186
  - lib/ultracart_api/models/conversation_message_translation.rb