From d37bc8550240b12f949f97e087b89a66c146548b Mon Sep 17 00:00:00 2001 From: "piyush.tayal" Date: Mon, 19 Jan 2026 16:54:15 +0530 Subject: [PATCH 1/2] SCAL-290722: playground test --- api-spec/openapiSpecv3-2_0.json | 422 +++++++++++++++++++++++++++++++- 1 file changed, 421 insertions(+), 1 deletion(-) diff --git a/api-spec/openapiSpecv3-2_0.json b/api-spec/openapiSpecv3-2_0.json index c4778b0d..7f8a4324 100644 --- a/api-spec/openapiSpecv3-2_0.json +++ b/api-spec/openapiSpecv3-2_0.json @@ -21,6 +21,14 @@ ], "description": "Roles for version 10.4.0.cl" }, + { + "name": "26.4.0.cl", + "id": "26.4.0.cl", + "tags": [ + "26.4.0.cl" + ], + "description": "Roles for version 26.4.0.cl" + }, { "name": "10.15.0.cl", "id": "10.15.0.cl", @@ -345,6 +353,155 @@ } } }, + "/api/rest/2.0/ai/agent/conversation/{conversation_id}/delete": { + "post": { + "operationId": "deleteConversation", + "description": "Beta Version: 26.4.0.cl or later", + "tags": [ + "AI", + "26.4.0.cl" + ], + "parameters": [ + { + "in": "path", + "name": "conversation_id", + "required": true, + "schema": { + "type": "string" + }, + "description": "Unique identifier of the conversation to delete." + } + ], + "responses": { + "200": { + "description": "Common successful response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/DeleteConversationResponse" + } + } + } + }, + "201": { + "description": "Common error response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/DeleteConversationResponse" + } + } + } + }, + "400": { + "description": "Operation failed", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorResponse" + } + } + } + }, + "500": { + "description": "Operation failed", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorResponse" + } + } + } + } + } + } + }, + "/api/rest/2.0/ai/agent/conversations": { + "get": { + "operationId": "getConversationHistory", + "description": "Beta Version: 26.4.0.cl or later", + "tags": [ + "AI", + "26.4.0.cl" + ], + "parameters": [ + { + "in": "query", + "name": "limit", + "required": false, + "schema": { + "type": "integer", + "format": "int32" + }, + "description": "Maximum number of conversations to return (default: 20).", + "default": 20 + }, + { + "in": "query", + "name": "offset", + "required": false, + "schema": { + "type": "integer", + "format": "int32" + }, + "description": "Number of conversations to skip for pagination (default: 0).", + "default": 0 + }, + { + "in": "query", + "name": "skip_empty", + "required": false, + "schema": { + "type": "boolean" + }, + "description": "Skip empty conversations without messages (default: true).", + "default": true + } + ], + "responses": { + "200": { + "description": "Common successful response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ConversationHistoryResponse" + } + } + } + }, + "201": { + "description": "Common error response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ConversationHistoryResponse" + } + } + } + }, + "400": { + "description": "Operation failed", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorResponse" + } + } + } + }, + "500": { + "description": "Operation failed", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorResponse" + } + } + } + } + } + } + }, "/api/rest/2.0/ai/data-source-suggestions": { "post": { "operationId": "getDataSourceSuggestions", @@ -588,6 +745,69 @@ } } }, + "/api/rest/2.0/ai/agent/conversation/{conversation_id}": { + "get": { + "operationId": "loadConversation", + "description": "Beta Version: 26.4.0.cl or later", + "tags": [ + "AI", + "26.4.0.cl" + ], + "parameters": [ + { + "in": "path", + "name": "conversation_id", + "required": true, + "schema": { + "type": "string" + }, + "description": "Unique identifier of the conversation to load." + } + ], + "responses": { + "200": { + "description": "Common successful response", + "content": { + "application/json": { + "schema": { + "type": "object" + } + } + } + }, + "201": { + "description": "Common error response", + "content": { + "application/json": { + "schema": { + "type": "object" + } + } + } + }, + "400": { + "description": "Operation failed", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorResponse" + } + } + } + }, + "500": { + "description": "Operation failed", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorResponse" + } + } + } + } + } + } + }, "/api/rest/2.0/ai/analytical-questions": { "post": { "operationId": "queryGetDecomposedQuery", @@ -699,6 +919,88 @@ } } }, + "/api/rest/2.0/ai/agent/conversation/{conversation_id}/rename": { + "post": { + "operationId": "renameConversation", + "description": "Beta Version: 26.4.0.cl or later", + "tags": [ + "AI", + "26.4.0.cl" + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "new_title": { + "description": "New title for the conversation.", + "type": "string" + } + }, + "required": [ + "new_title" + ] + } + } + }, + "required": true + }, + "parameters": [ + { + "in": "path", + "name": "conversation_id", + "required": true, + "schema": { + "type": "string" + }, + "description": "Unique identifier of the conversation." + } + ], + "responses": { + "200": { + "description": "Common successful response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/RenameConversationResponse" + } + } + } + }, + "201": { + "description": "Common error response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/RenameConversationResponse" + } + } + } + }, + "400": { + "description": "Operation failed", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorResponse" + } + } + } + }, + "500": { + "description": "Operation failed", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorResponse" + } + } + } + } + } + } + }, "/api/rest/2.0/ai/agent/{conversation_identifier}/converse": { "post": { "operationId": "sendAgentMessage", @@ -20480,6 +20782,94 @@ }, "description": "MetadataType InputType used in Custom Action API's" }, + "ConversationHistoryResponse": { + "type": "object", + "required": [ + "conversations" + ], + "properties": { + "conversations": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ConversationRecord" + }, + "description": "List of conversations." + } + } + }, + "ConversationRecord": { + "type": "object", + "required": [ + "conversation_id", + "created_at", + "updated_at" + ], + "properties": { + "conversation_id": { + "type": "string", + "description": "Unique identifier of the conversation." + }, + "title": { + "type": "string", + "description": "Title of the conversation.", + "nullable": true + }, + "created_at": { + "type": "string", + "description": "Timestamp when conversation was created." + }, + "updated_at": { + "type": "string", + "description": "Timestamp when conversation was last updated." + }, + "data_source_identifier": { + "type": "string", + "description": "Data source identifier associated with this conversation.", + "nullable": true + }, + "data_source_name": { + "type": "string", + "description": "Data source name.", + "nullable": true + }, + "conversation_settings": { + "$ref": "#/components/schemas/ConversationSettings", + "description": "Conversation settings.", + "nullable": true + }, + "active_thread_length": { + "type": "integer", + "format": "int32", + "description": "Number of messages in active thread.", + "nullable": true + } + } + }, + "ConversationSettings": { + "type": "object", + "properties": { + "enable_contextual_change_analysis": { + "type": "boolean", + "description": "Enable contextual change analysis.", + "nullable": true + }, + "enable_natural_language_answer_generation": { + "type": "boolean", + "description": "Enable natural language answer generation.", + "nullable": true + }, + "enable_reasoning": { + "type": "boolean", + "description": "Enable reasoning.", + "nullable": true + }, + "save_chat_enabled": { + "type": "boolean", + "description": "Enable saving chat.", + "nullable": true + } + } + }, "MetadataContext": { "type": "object", "properties": { @@ -24732,6 +25122,12 @@ "default": false, "description": "Enable reasoning.", "nullable": true + }, + "save_chat_enabled": { + "type": "boolean", + "default": false, + "description": "Enable saving chat.", + "nullable": true } } }, @@ -24762,6 +25158,30 @@ } } }, + "RenameConversationResponse": { + "type": "object", + "required": [ + "success" + ], + "properties": { + "success": { + "type": "boolean", + "description": "Success status." + } + } + }, + "DeleteConversationResponse": { + "type": "object", + "required": [ + "success" + ], + "properties": { + "success": { + "type": "boolean", + "description": "Success status." + } + } + }, "NLInstructionsInfoInput": { "type": "object", "required": [ @@ -25376,4 +25796,4 @@ } } ] -} \ No newline at end of file +} From 67788a0873584bac14f5762f0fd38b5cee792ecd Mon Sep 17 00:00:00 2001 From: ravishah8176 Date: Wed, 21 Jan 2026 13:48:52 +0530 Subject: [PATCH 2/2] [SCAL-290722] - Update openapi spec: remove schema references and add version information for use_browser_language --- api-spec/openapiSpecv3-2_0.json | 134 +++----------------------------- 1 file changed, 11 insertions(+), 123 deletions(-) diff --git a/api-spec/openapiSpecv3-2_0.json b/api-spec/openapiSpecv3-2_0.json index 7f8a4324..92350c9d 100644 --- a/api-spec/openapiSpecv3-2_0.json +++ b/api-spec/openapiSpecv3-2_0.json @@ -378,7 +378,7 @@ "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/DeleteConversationResponse" + "type": "object" } } } @@ -388,7 +388,7 @@ "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/DeleteConversationResponse" + "type": "object" } } } @@ -464,7 +464,7 @@ "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/ConversationHistoryResponse" + "type": "object" } } } @@ -474,7 +474,7 @@ "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/ConversationHistoryResponse" + "type": "object" } } } @@ -963,7 +963,7 @@ "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/RenameConversationResponse" + "type": "object" } } } @@ -973,7 +973,7 @@ "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/RenameConversationResponse" + "type": "object" } } } @@ -14410,7 +14410,7 @@ ] }, "use_browser_language": { - "description": "Flag to indicate whether to use the browser locale for the user in the UI.\nWhen set to true, the preferred_locale value is unset and the browser's\nlanguage setting takes precedence.", + "description": "Flag to indicate whether to use the browser locale for the user in the UI.\nWhen set to true, the preferred_locale value is unset and the browser's\nlanguage setting takes precedence.
Version: 26.3.0.cl or later", "type": "boolean", "nullable": true }, @@ -15304,7 +15304,7 @@ ] }, "use_browser_language": { - "description": "Flag to indicate whether to use the browser locale for the user in the UI.\nWhen set to true, the preferred_locale value is unset and the browser's\nlanguage setting takes precedence.", + "description": "Flag to indicate whether to use the browser locale for the user in the UI.\nWhen set to true, the preferred_locale value is unset and the browser's\nlanguage setting takes precedence.
Version: 26.3.0.cl or later", "type": "boolean", "nullable": true }, @@ -17761,7 +17761,7 @@ }, "use_browser_language": { "type": "boolean", - "description": "Flag to indicate whether to use the browser locale for the user in the UI.\nWhen set to true, the preferred_locale value is unset and the browser's\nlanguage setting takes precedence.", + "description": "Flag to indicate whether to use the browser locale for the user in the UI.\nWhen set to true, the preferred_locale value is unset and the browser's\nlanguage setting takes precedence.
Version: 26.3.0.cl or later", "nullable": true }, "extended_properties": { @@ -20782,94 +20782,6 @@ }, "description": "MetadataType InputType used in Custom Action API's" }, - "ConversationHistoryResponse": { - "type": "object", - "required": [ - "conversations" - ], - "properties": { - "conversations": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ConversationRecord" - }, - "description": "List of conversations." - } - } - }, - "ConversationRecord": { - "type": "object", - "required": [ - "conversation_id", - "created_at", - "updated_at" - ], - "properties": { - "conversation_id": { - "type": "string", - "description": "Unique identifier of the conversation." - }, - "title": { - "type": "string", - "description": "Title of the conversation.", - "nullable": true - }, - "created_at": { - "type": "string", - "description": "Timestamp when conversation was created." - }, - "updated_at": { - "type": "string", - "description": "Timestamp when conversation was last updated." - }, - "data_source_identifier": { - "type": "string", - "description": "Data source identifier associated with this conversation.", - "nullable": true - }, - "data_source_name": { - "type": "string", - "description": "Data source name.", - "nullable": true - }, - "conversation_settings": { - "$ref": "#/components/schemas/ConversationSettings", - "description": "Conversation settings.", - "nullable": true - }, - "active_thread_length": { - "type": "integer", - "format": "int32", - "description": "Number of messages in active thread.", - "nullable": true - } - } - }, - "ConversationSettings": { - "type": "object", - "properties": { - "enable_contextual_change_analysis": { - "type": "boolean", - "description": "Enable contextual change analysis.", - "nullable": true - }, - "enable_natural_language_answer_generation": { - "type": "boolean", - "description": "Enable natural language answer generation.", - "nullable": true - }, - "enable_reasoning": { - "type": "boolean", - "description": "Enable reasoning.", - "nullable": true - }, - "save_chat_enabled": { - "type": "boolean", - "description": "Enable saving chat.", - "nullable": true - } - } - }, "MetadataContext": { "type": "object", "properties": { @@ -22580,7 +22492,7 @@ }, "preferred_locale": { "type": "string", - "description": "Locale for the user.", + "description": "Locale for the user. When setting this value, do not set use_browser_language to true, otherwise the browser's language setting will take precedence and the preferred_locale value will be ignored.", "nullable": true, "enum": [ "en-CA", @@ -22614,7 +22526,7 @@ }, "use_browser_language": { "type": "boolean", - "description": "Flag to indicate whether to use the browser locale for the user in the UI.\nWhen set to true, the preferred_locale value is unset and the browser's\nlanguage setting takes precedence.", + "description": "Flag to indicate whether to use the browser locale for the user in the UI.\nWhen set to true, the preferred_locale value is unset and the browser's\nlanguage setting takes precedence.
Version: 26.3.0.cl or later", "nullable": true } } @@ -25158,30 +25070,6 @@ } } }, - "RenameConversationResponse": { - "type": "object", - "required": [ - "success" - ], - "properties": { - "success": { - "type": "boolean", - "description": "Success status." - } - } - }, - "DeleteConversationResponse": { - "type": "object", - "required": [ - "success" - ], - "properties": { - "success": { - "type": "boolean", - "description": "Success status." - } - } - }, "NLInstructionsInfoInput": { "type": "object", "required": [