algolia 3.40.0 → 3.41.0

data/lib/algolia/api/agent_studio_client.rb

@@ -0,0 +1,2364 @@
+# frozen_string_literal: true
+
+# Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
+
+require "openssl"
+require "base64"
+
+module Algolia
+  class AgentStudioClient
+    attr_accessor :api_client
+
+    def initialize(config = nil)
+      raise "`config` is missing." if config.nil?
+      raise "`app_id` is missing." if config.app_id.nil? || config.app_id == ""
+      raise "`api_key` is missing." if config.api_key.nil? || config.api_key == ""
+
+      if config.connect_timeout.nil?
+        config.connect_timeout = 25000
+      end
+
+      if config.read_timeout.nil?
+        config.read_timeout = 25000
+      end
+
+      if config.write_timeout.nil?
+        config.write_timeout = 25000
+      end
+
+      @api_client = Algolia::ApiClient.new(config)
+      warn(
+        "[algolia] Agent Studio API is in beta and subject to breaking changes. See https://www.algolia.com/doc/rest-api/agent-studio"
+      )
+    end
+
+    def self.create(app_id, api_key, opts = {})
+      hosts = []
+      hosts << Transport::StatefulHost.new("#{app_id}-dsn.algolia.net", accept: CallType::READ)
+      hosts << Transport::StatefulHost.new("#{app_id}.algolia.net", accept: CallType::WRITE)
+
+      hosts += 1
+        .upto(3)
+        .map do |i|
+          Transport::StatefulHost.new("#{app_id}-#{i}.algolianet.com", accept: CallType::READ | CallType::WRITE)
+        end
+        .shuffle
+
+      config = Algolia::Configuration.new(app_id, api_key, hosts, "AgentStudio", opts)
+      new(config)
+    end
+
+    def self.create_with_config(config)
+      new(config)
+    end
+
+    # Helper method to switch the API key used to authenticate the requests.
+    #
+    # @param api_key [String] the new API key to use.
+    # @return [void]
+    def set_client_api_key(api_key)
+      @api_client.set_client_api_key(api_key)
+
+      self
+    end
+
+    def add_user_agent_segment(segment, version = nil)
+      @api_client.config.add_user_agent_segment(segment, version)
+
+      self
+    end
+
+    # Add multiple allowed domain patterns. Duplicates are skipped.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param agent_id [String] The agentId. (required)
+    # @param allowed_domain_bulk_insert [AllowedDomainBulkInsert]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def bulk_create_allowed_domains_with_http_info(agent_id, allowed_domain_bulk_insert, request_options = {})
+      # verify the required parameter 'agent_id' is set
+      if @api_client.config.client_side_validation && agent_id.nil?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `bulk_create_allowed_domains`."
+      end
+      # verify the required parameter 'agent_id' is not empty
+      if @api_client.config.client_side_validation && agent_id.empty?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `bulk_create_allowed_domains`."
+      end
+      # verify the required parameter 'allowed_domain_bulk_insert' is set
+      if @api_client.config.client_side_validation && allowed_domain_bulk_insert.nil?
+        raise(
+          ArgumentError,
+          "Parameter `allowed_domain_bulk_insert` is required when calling `bulk_create_allowed_domains`."
+        )
+      end
+
+      path = "/agent-studio/1/agents/{agentId}/allowed-domains/bulk".sub(
+        "{" + "agentId" + "}",
+        Transport.encode_uri(agent_id.to_s)
+      )
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body] || @api_client.object_to_http_body(allowed_domain_bulk_insert)
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.bulk_create_allowed_domains",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:POST, path, new_options)
+    end
+
+    # Add multiple allowed domain patterns. Duplicates are skipped.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param agent_id [String] The agentId. (required)
+    # @param allowed_domain_bulk_insert [AllowedDomainBulkInsert]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [AllowedDomainListResponse]
+    def bulk_create_allowed_domains(agent_id, allowed_domain_bulk_insert, request_options = {})
+      response = bulk_create_allowed_domains_with_http_info(agent_id, allowed_domain_bulk_insert, request_options)
+      @api_client.deserialize(
+        response.body,
+        request_options[:debug_return_type] || "AgentStudio::AllowedDomainListResponse"
+      )
+    end
+
+    # Delete allowed domains by id list.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param agent_id [String] The agentId. (required)
+    # @param allowed_domain_bulk_delete [AllowedDomainBulkDelete]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def bulk_delete_allowed_domains_with_http_info(agent_id, allowed_domain_bulk_delete, request_options = {})
+      # verify the required parameter 'agent_id' is set
+      if @api_client.config.client_side_validation && agent_id.nil?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `bulk_delete_allowed_domains`."
+      end
+      # verify the required parameter 'agent_id' is not empty
+      if @api_client.config.client_side_validation && agent_id.empty?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `bulk_delete_allowed_domains`."
+      end
+      # verify the required parameter 'allowed_domain_bulk_delete' is set
+      if @api_client.config.client_side_validation && allowed_domain_bulk_delete.nil?
+        raise(
+          ArgumentError,
+          "Parameter `allowed_domain_bulk_delete` is required when calling `bulk_delete_allowed_domains`."
+        )
+      end
+
+      path = "/agent-studio/1/agents/{agentId}/allowed-domains/bulk".sub(
+        "{" + "agentId" + "}",
+        Transport.encode_uri(agent_id.to_s)
+      )
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body] || @api_client.object_to_http_body(allowed_domain_bulk_delete)
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.bulk_delete_allowed_domains",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:DELETE, path, new_options)
+    end
+
+    # Delete allowed domains by id list.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param agent_id [String] The agentId. (required)
+    # @param allowed_domain_bulk_delete [AllowedDomainBulkDelete]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [nil]
+    def bulk_delete_allowed_domains(agent_id, allowed_domain_bulk_delete, request_options = {})
+      bulk_delete_allowed_domains_with_http_info(agent_id, allowed_domain_bulk_delete, request_options)
+      nil
+    end
+
+    # Create a new agent.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param agent_config_create [AgentConfigCreate]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def create_agent_with_http_info(agent_config_create, request_options = {})
+      # verify the required parameter 'agent_config_create' is set
+      if @api_client.config.client_side_validation && agent_config_create.nil?
+        raise ArgumentError, "Parameter `agent_config_create` is required when calling `create_agent`."
+      end
+
+      path = "/agent-studio/1/agents"
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body] || @api_client.object_to_http_body(agent_config_create)
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.create_agent",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:POST, path, new_options)
+    end
+
+    # Create a new agent.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param agent_config_create [AgentConfigCreate]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [AgentWithVersionResponse]
+    def create_agent(agent_config_create, request_options = {})
+      response = create_agent_with_http_info(agent_config_create, request_options)
+      @api_client.deserialize(
+        response.body,
+        request_options[:debug_return_type] || "AgentStudio::AgentWithVersionResponse"
+      )
+    end
+
+    # Add a single allowed domain pattern (e.g. https://app.example.com or *.example.com).
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param agent_id [String] The agentId. (required)
+    # @param allowed_domain_create [AllowedDomainCreate]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def create_agent_allowed_domain_with_http_info(agent_id, allowed_domain_create, request_options = {})
+      # verify the required parameter 'agent_id' is set
+      if @api_client.config.client_side_validation && agent_id.nil?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `create_agent_allowed_domain`."
+      end
+      # verify the required parameter 'agent_id' is not empty
+      if @api_client.config.client_side_validation && agent_id.empty?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `create_agent_allowed_domain`."
+      end
+      # verify the required parameter 'allowed_domain_create' is set
+      if @api_client.config.client_side_validation && allowed_domain_create.nil?
+        raise ArgumentError, "Parameter `allowed_domain_create` is required when calling `create_agent_allowed_domain`."
+      end
+
+      path = "/agent-studio/1/agents/{agentId}/allowed-domains".sub(
+        "{" + "agentId" + "}",
+        Transport.encode_uri(agent_id.to_s)
+      )
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body] || @api_client.object_to_http_body(allowed_domain_create)
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.create_agent_allowed_domain",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:POST, path, new_options)
+    end
+
+    # Add a single allowed domain pattern (e.g. https://app.example.com or *.example.com).
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param agent_id [String] The agentId. (required)
+    # @param allowed_domain_create [AllowedDomainCreate]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [AllowedDomainResponse]
+    def create_agent_allowed_domain(agent_id, allowed_domain_create, request_options = {})
+      response = create_agent_allowed_domain_with_http_info(agent_id, allowed_domain_create, request_options)
+      @api_client.deserialize(
+        response.body,
+        request_options[:debug_return_type] || "AgentStudio::AllowedDomainResponse"
+      )
+    end
+
+    # Create a completion for the specified agent.  This endpoint handles two types of requests: 1. Normal completion request: User message -> Agent response 2. Tool approval response: User approval -> Execute tool -> Agent response  Tool Approval Flow (for MCP tools with requiresApproval: true): - Request 1: User sends message -> Agent requests tool call -> Return approval request - Request 2: User approves -> Execute tool -> Agent continues with result.
+    #
+    # Required API Key ACLs:
+    #   - search
+    # @param agent_id [String] The agentId. (required)
+    # @param compatibility_mode [CompatibilityMode] Compatibility mode for the completion API. (required)
+    # @param agent_completion_request [AgentCompletionRequest]  (required)
+    # @param stream [Boolean] Whether to stream the response or not. (default to true)
+    # @param cache [Boolean] Use cached responses if available. (default to true)
+    # @param memory [Boolean] Set to false to disable memory (enabled by default).
+    # @param analytics [Boolean] Set to false to skip analytics for this completion (default: true). Disables Agent Studio BigQuery analytics, Algolia search analytics, click analytics, and query-suggestions training. Useful for offline-eval workflows. (default to true)
+    # @param x_algolia_secure_user_token [String] The X-Algolia-Secure-User-Token.
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def create_agent_completion_with_http_info(
+      agent_id,
+      compatibility_mode,
+      agent_completion_request,
+      stream = nil,
+      cache = nil,
+      memory = nil,
+      analytics = nil,
+      x_algolia_secure_user_token = nil,
+      request_options = {}
+    )
+      # verify the required parameter 'agent_id' is set
+      if @api_client.config.client_side_validation && agent_id.nil?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `create_agent_completion`."
+      end
+      # verify the required parameter 'agent_id' is not empty
+      if @api_client.config.client_side_validation && agent_id.empty?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `create_agent_completion`."
+      end
+      # verify the required parameter 'compatibility_mode' is set
+      if @api_client.config.client_side_validation && compatibility_mode.nil?
+        raise ArgumentError, "Parameter `compatibility_mode` is required when calling `create_agent_completion`."
+      end
+      # verify the required parameter 'agent_completion_request' is set
+      if @api_client.config.client_side_validation && agent_completion_request.nil?
+        raise ArgumentError, "Parameter `agent_completion_request` is required when calling `create_agent_completion`."
+      end
+
+      path = "/agent-studio/1/agents/{agentId}/completions".sub(
+        "{" + "agentId" + "}",
+        Transport.encode_uri(agent_id.to_s)
+      )
+      query_params = {}
+      query_params[:compatibilityMode] = compatibility_mode
+      query_params[:stream] = stream unless stream.nil?
+      query_params[:cache] = cache unless cache.nil?
+      query_params[:memory] = memory unless memory.nil?
+      query_params[:analytics] = analytics unless analytics.nil?
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      unless x_algolia_secure_user_token.nil?
+        header_params[:"X-Algolia-Secure-User-Token"] = x_algolia_secure_user_token
+      end
+
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body] || @api_client.object_to_http_body(agent_completion_request)
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.create_agent_completion",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:POST, path, new_options)
+    end
+
+    # Create a completion for the specified agent.  This endpoint handles two types of requests: 1. Normal completion request: User message -> Agent response 2. Tool approval response: User approval -> Execute tool -> Agent response  Tool Approval Flow (for MCP tools with requiresApproval: true): - Request 1: User sends message -> Agent requests tool call -> Return approval request - Request 2: User approves -> Execute tool -> Agent continues with result.
+    #
+    # Required API Key ACLs:
+    #   - search
+    # @param agent_id [String] The agentId. (required)
+    # @param compatibility_mode [CompatibilityMode] Compatibility mode for the completion API. (required)
+    # @param agent_completion_request [AgentCompletionRequest]  (required)
+    # @param stream [Boolean] Whether to stream the response or not. (default to true)
+    # @param cache [Boolean] Use cached responses if available. (default to true)
+    # @param memory [Boolean] Set to false to disable memory (enabled by default).
+    # @param analytics [Boolean] Set to false to skip analytics for this completion (default: true). Disables Agent Studio BigQuery analytics, Algolia search analytics, click analytics, and query-suggestions training. Useful for offline-eval workflows. (default to true)
+    # @param x_algolia_secure_user_token [String] The X-Algolia-Secure-User-Token.
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Hash<String, Object>]
+    def create_agent_completion(
+      agent_id,
+      compatibility_mode,
+      agent_completion_request,
+      stream = nil,
+      cache = nil,
+      memory = nil,
+      analytics = nil,
+      x_algolia_secure_user_token = nil,
+      request_options = {}
+    )
+      response = create_agent_completion_with_http_info(
+        agent_id,
+        compatibility_mode,
+        agent_completion_request,
+        stream,
+        cache,
+        memory,
+        analytics,
+        x_algolia_secure_user_token,
+        request_options
+      )
+      @api_client.deserialize(response.body, request_options[:debug_return_type] || "Hash<String, Object>")
+    end
+
+    # Create new feedback entry.
+    #
+    # Required API Key ACLs:
+    #   - search
+    # @param feedback_creation_request [FeedbackCreationRequest]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def create_feedback_with_http_info(feedback_creation_request, request_options = {})
+      # verify the required parameter 'feedback_creation_request' is set
+      if @api_client.config.client_side_validation && feedback_creation_request.nil?
+        raise ArgumentError, "Parameter `feedback_creation_request` is required when calling `create_feedback`."
+      end
+
+      path = "/agent-studio/1/feedback"
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body] || @api_client.object_to_http_body(feedback_creation_request)
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.create_feedback",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:POST, path, new_options)
+    end
+
+    # Create new feedback entry.
+    #
+    # Required API Key ACLs:
+    #   - search
+    # @param feedback_creation_request [FeedbackCreationRequest]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [FeedbackResponse]
+    def create_feedback(feedback_creation_request, request_options = {})
+      response = create_feedback_with_http_info(feedback_creation_request, request_options)
+      @api_client.deserialize(response.body, request_options[:debug_return_type] || "AgentStudio::FeedbackResponse")
+    end
+
+    # Create Provider.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param provider_authentication_create [ProviderAuthenticationCreate]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def create_provider_with_http_info(provider_authentication_create, request_options = {})
+      # verify the required parameter 'provider_authentication_create' is set
+      if @api_client.config.client_side_validation && provider_authentication_create.nil?
+        raise ArgumentError, "Parameter `provider_authentication_create` is required when calling `create_provider`."
+      end
+
+      path = "/agent-studio/1/providers"
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body] || @api_client.object_to_http_body(provider_authentication_create)
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.create_provider",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:POST, path, new_options)
+    end
+
+    # Create Provider.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param provider_authentication_create [ProviderAuthenticationCreate]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [ProviderAuthenticationResponse]
+    def create_provider(provider_authentication_create, request_options = {})
+      response = create_provider_with_http_info(provider_authentication_create, request_options)
+      @api_client.deserialize(
+        response.body,
+        request_options[:debug_return_type] || "AgentStudio::ProviderAuthenticationResponse"
+      )
+    end
+
+    # Create Secret Key.
+    #
+    # Required API Key ACLs:
+    #   - admin
+    # @param secret_key_create [SecretKeyCreate]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def create_secret_key_with_http_info(secret_key_create, request_options = {})
+      # verify the required parameter 'secret_key_create' is set
+      if @api_client.config.client_side_validation && secret_key_create.nil?
+        raise ArgumentError, "Parameter `secret_key_create` is required when calling `create_secret_key`."
+      end
+
+      path = "/agent-studio/1/secret-keys"
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body] || @api_client.object_to_http_body(secret_key_create)
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.create_secret_key",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:POST, path, new_options)
+    end
+
+    # Create Secret Key.
+    #
+    # Required API Key ACLs:
+    #   - admin
+    # @param secret_key_create [SecretKeyCreate]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [SecretKeyResponse]
+    def create_secret_key(secret_key_create, request_options = {})
+      response = create_secret_key_with_http_info(secret_key_create, request_options)
+      @api_client.deserialize(response.body, request_options[:debug_return_type] || "AgentStudio::SecretKeyResponse")
+    end
+
+    # This method lets you send requests to the Algolia REST API.
+
+    # @param path [String] Path of the endpoint, for example `1/newFeature`. (required)
+    # @param parameters [Hash<String, Object>] Query parameters to apply to the current query.
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def custom_delete_with_http_info(path, parameters = nil, request_options = {})
+      # verify the required parameter 'path' is set
+      if @api_client.config.client_side_validation && path.nil?
+        raise ArgumentError, "Parameter `path` is required when calling `custom_delete`."
+      end
+      # verify the required parameter 'path' is not empty
+      if @api_client.config.client_side_validation && path.empty?
+        raise ArgumentError, "Parameter `path` is required when calling `custom_delete`."
+      end
+
+      path = "/agent-studio/{path}".sub("{" + "path" + "}", path.to_s)
+      query_params = {}
+      query_params = query_params.merge(parameters) unless parameters.nil?
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.custom_delete",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:DELETE, path, new_options)
+    end
+
+    # This method lets you send requests to the Algolia REST API.
+
+    # @param path [String] Path of the endpoint, for example `1/newFeature`. (required)
+    # @param parameters [Hash<String, Object>] Query parameters to apply to the current query.
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Object]
+    def custom_delete(path, parameters = nil, request_options = {})
+      response = custom_delete_with_http_info(path, parameters, request_options)
+      @api_client.deserialize(response.body, request_options[:debug_return_type] || "Object")
+    end
+
+    # This method lets you send requests to the Algolia REST API.
+
+    # @param path [String] Path of the endpoint, for example `1/newFeature`. (required)
+    # @param parameters [Hash<String, Object>] Query parameters to apply to the current query.
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def custom_get_with_http_info(path, parameters = nil, request_options = {})
+      # verify the required parameter 'path' is set
+      if @api_client.config.client_side_validation && path.nil?
+        raise ArgumentError, "Parameter `path` is required when calling `custom_get`."
+      end
+      # verify the required parameter 'path' is not empty
+      if @api_client.config.client_side_validation && path.empty?
+        raise ArgumentError, "Parameter `path` is required when calling `custom_get`."
+      end
+
+      path = "/agent-studio/{path}".sub("{" + "path" + "}", path.to_s)
+      query_params = {}
+      query_params = query_params.merge(parameters) unless parameters.nil?
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.custom_get",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:GET, path, new_options)
+    end
+
+    # This method lets you send requests to the Algolia REST API.
+
+    # @param path [String] Path of the endpoint, for example `1/newFeature`. (required)
+    # @param parameters [Hash<String, Object>] Query parameters to apply to the current query.
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Object]
+    def custom_get(path, parameters = nil, request_options = {})
+      response = custom_get_with_http_info(path, parameters, request_options)
+      @api_client.deserialize(response.body, request_options[:debug_return_type] || "Object")
+    end
+
+    # This method lets you send requests to the Algolia REST API.
+
+    # @param path [String] Path of the endpoint, for example `1/newFeature`. (required)
+    # @param parameters [Hash<String, Object>] Query parameters to apply to the current query.
+    # @param body [Object] Parameters to send with the custom request.
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def custom_post_with_http_info(path, parameters = nil, body = nil, request_options = {})
+      # verify the required parameter 'path' is set
+      if @api_client.config.client_side_validation && path.nil?
+        raise ArgumentError, "Parameter `path` is required when calling `custom_post`."
+      end
+      # verify the required parameter 'path' is not empty
+      if @api_client.config.client_side_validation && path.empty?
+        raise ArgumentError, "Parameter `path` is required when calling `custom_post`."
+      end
+
+      path = "/agent-studio/{path}".sub("{" + "path" + "}", path.to_s)
+      query_params = {}
+      query_params = query_params.merge(parameters) unless parameters.nil?
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body] || @api_client.object_to_http_body(body)
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.custom_post",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:POST, path, new_options)
+    end
+
+    # This method lets you send requests to the Algolia REST API.
+
+    # @param path [String] Path of the endpoint, for example `1/newFeature`. (required)
+    # @param parameters [Hash<String, Object>] Query parameters to apply to the current query.
+    # @param body [Object] Parameters to send with the custom request.
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Object]
+    def custom_post(path, parameters = nil, body = nil, request_options = {})
+      response = custom_post_with_http_info(path, parameters, body, request_options)
+      @api_client.deserialize(response.body, request_options[:debug_return_type] || "Object")
+    end
+
+    # This method lets you send requests to the Algolia REST API.
+
+    # @param path [String] Path of the endpoint, for example `1/newFeature`. (required)
+    # @param parameters [Hash<String, Object>] Query parameters to apply to the current query.
+    # @param body [Object] Parameters to send with the custom request.
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def custom_put_with_http_info(path, parameters = nil, body = nil, request_options = {})
+      # verify the required parameter 'path' is set
+      if @api_client.config.client_side_validation && path.nil?
+        raise ArgumentError, "Parameter `path` is required when calling `custom_put`."
+      end
+      # verify the required parameter 'path' is not empty
+      if @api_client.config.client_side_validation && path.empty?
+        raise ArgumentError, "Parameter `path` is required when calling `custom_put`."
+      end
+
+      path = "/agent-studio/{path}".sub("{" + "path" + "}", path.to_s)
+      query_params = {}
+      query_params = query_params.merge(parameters) unless parameters.nil?
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body] || @api_client.object_to_http_body(body)
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.custom_put",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:PUT, path, new_options)
+    end
+
+    # This method lets you send requests to the Algolia REST API.
+
+    # @param path [String] Path of the endpoint, for example `1/newFeature`. (required)
+    # @param parameters [Hash<String, Object>] Query parameters to apply to the current query.
+    # @param body [Object] Parameters to send with the custom request.
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Object]
+    def custom_put(path, parameters = nil, body = nil, request_options = {})
+      response = custom_put_with_http_info(path, parameters, body, request_options)
+      @api_client.deserialize(response.body, request_options[:debug_return_type] || "Object")
+    end
+
+    # Delete the specified agent.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param agent_id [String] The agentId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def delete_agent_with_http_info(agent_id, request_options = {})
+      # verify the required parameter 'agent_id' is set
+      if @api_client.config.client_side_validation && agent_id.nil?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `delete_agent`."
+      end
+      # verify the required parameter 'agent_id' is not empty
+      if @api_client.config.client_side_validation && agent_id.empty?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `delete_agent`."
+      end
+
+      path = "/agent-studio/1/agents/{agentId}".sub("{" + "agentId" + "}", Transport.encode_uri(agent_id.to_s))
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.delete_agent",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:DELETE, path, new_options)
+    end
+
+    # Delete the specified agent.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param agent_id [String] The agentId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [nil]
+    def delete_agent(agent_id, request_options = {})
+      delete_agent_with_http_info(agent_id, request_options)
+      nil
+    end
+
+    # Deletes the conversations matching the given filers.
+    #
+    # Required API Key ACLs:
+    #   - logs
+    # @param agent_id [String] The agentId. (required)
+    # @param start_date [String] Filter conversations created after this date (format: YYYY-MM-DD).
+    # @param end_date [String] Filter conversations created before this date (format: YYYY-MM-DD).
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def delete_agent_conversations_with_http_info(agent_id, start_date = nil, end_date = nil, request_options = {})
+      # verify the required parameter 'agent_id' is set
+      if @api_client.config.client_side_validation && agent_id.nil?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `delete_agent_conversations`."
+      end
+      # verify the required parameter 'agent_id' is not empty
+      if @api_client.config.client_side_validation && agent_id.empty?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `delete_agent_conversations`."
+      end
+
+      path = "/agent-studio/1/agents/{agentId}/conversations".sub(
+        "{" + "agentId" + "}",
+        Transport.encode_uri(agent_id.to_s)
+      )
+      query_params = {}
+      query_params[:startDate] = start_date unless start_date.nil?
+      query_params[:endDate] = end_date unless end_date.nil?
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.delete_agent_conversations",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:DELETE, path, new_options)
+    end
+
+    # Deletes the conversations matching the given filers.
+    #
+    # Required API Key ACLs:
+    #   - logs
+    # @param agent_id [String] The agentId. (required)
+    # @param start_date [String] Filter conversations created after this date (format: YYYY-MM-DD).
+    # @param end_date [String] Filter conversations created before this date (format: YYYY-MM-DD).
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [nil]
+    def delete_agent_conversations(agent_id, start_date = nil, end_date = nil, request_options = {})
+      delete_agent_conversations_with_http_info(agent_id, start_date, end_date, request_options)
+      nil
+    end
+
+    # Remove an allowed domain by id.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param domain_id [String] The domainId. (required)
+    # @param agent_id [String] The agentId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def delete_allowed_domain_with_http_info(domain_id, agent_id, request_options = {})
+      # verify the required parameter 'domain_id' is set
+      if @api_client.config.client_side_validation && domain_id.nil?
+        raise ArgumentError, "Parameter `domain_id` is required when calling `delete_allowed_domain`."
+      end
+      # verify the required parameter 'domain_id' is not empty
+      if @api_client.config.client_side_validation && domain_id.empty?
+        raise ArgumentError, "Parameter `domain_id` is required when calling `delete_allowed_domain`."
+      end
+      # verify the required parameter 'agent_id' is set
+      if @api_client.config.client_side_validation && agent_id.nil?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `delete_allowed_domain`."
+      end
+      # verify the required parameter 'agent_id' is not empty
+      if @api_client.config.client_side_validation && agent_id.empty?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `delete_allowed_domain`."
+      end
+
+      path = "/agent-studio/1/agents/{agentId}/allowed-domains/{domainId}"
+        .sub("{" + "domainId" + "}", Transport.encode_uri(domain_id.to_s))
+        .sub("{" + "agentId" + "}", Transport.encode_uri(agent_id.to_s))
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.delete_allowed_domain",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:DELETE, path, new_options)
+    end
+
+    # Remove an allowed domain by id.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param domain_id [String] The domainId. (required)
+    # @param agent_id [String] The agentId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [nil]
+    def delete_allowed_domain(domain_id, agent_id, request_options = {})
+      delete_allowed_domain_with_http_info(domain_id, agent_id, request_options)
+      nil
+    end
+
+    # Deletes the conversation with the given ID.
+    #
+    # Required API Key ACLs:
+    #   - logs
+    # @param conversation_id [String] The conversationId. (required)
+    # @param agent_id [String] The agentId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def delete_conversation_with_http_info(conversation_id, agent_id, request_options = {})
+      # verify the required parameter 'conversation_id' is set
+      if @api_client.config.client_side_validation && conversation_id.nil?
+        raise ArgumentError, "Parameter `conversation_id` is required when calling `delete_conversation`."
+      end
+      # verify the required parameter 'conversation_id' is not empty
+      if @api_client.config.client_side_validation && conversation_id.empty?
+        raise ArgumentError, "Parameter `conversation_id` is required when calling `delete_conversation`."
+      end
+      # verify the required parameter 'agent_id' is set
+      if @api_client.config.client_side_validation && agent_id.nil?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `delete_conversation`."
+      end
+      # verify the required parameter 'agent_id' is not empty
+      if @api_client.config.client_side_validation && agent_id.empty?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `delete_conversation`."
+      end
+
+      path = "/agent-studio/1/agents/{agentId}/conversations/{conversationId}"
+        .sub("{" + "conversationId" + "}", Transport.encode_uri(conversation_id.to_s))
+        .sub("{" + "agentId" + "}", Transport.encode_uri(agent_id.to_s))
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.delete_conversation",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:DELETE, path, new_options)
+    end
+
+    # Deletes the conversation with the given ID.
+    #
+    # Required API Key ACLs:
+    #   - logs
+    # @param conversation_id [String] The conversationId. (required)
+    # @param agent_id [String] The agentId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [nil]
+    def delete_conversation(conversation_id, agent_id, request_options = {})
+      delete_conversation_with_http_info(conversation_id, agent_id, request_options)
+      nil
+    end
+
+    # Delete Provider.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param provider_id [String] The providerId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def delete_provider_with_http_info(provider_id, request_options = {})
+      # verify the required parameter 'provider_id' is set
+      if @api_client.config.client_side_validation && provider_id.nil?
+        raise ArgumentError, "Parameter `provider_id` is required when calling `delete_provider`."
+      end
+      # verify the required parameter 'provider_id' is not empty
+      if @api_client.config.client_side_validation && provider_id.empty?
+        raise ArgumentError, "Parameter `provider_id` is required when calling `delete_provider`."
+      end
+
+      path = "/agent-studio/1/providers/{providerId}".sub(
+        "{" + "providerId" + "}",
+        Transport.encode_uri(provider_id.to_s)
+      )
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.delete_provider",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:DELETE, path, new_options)
+    end
+
+    # Delete Provider.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param provider_id [String] The providerId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [nil]
+    def delete_provider(provider_id, request_options = {})
+      delete_provider_with_http_info(provider_id, request_options)
+      nil
+    end
+
+    # Delete Secret Key.
+    #
+    # Required API Key ACLs:
+    #   - admin
+    # @param secret_key_id [String] The secretKeyId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def delete_secret_key_with_http_info(secret_key_id, request_options = {})
+      # verify the required parameter 'secret_key_id' is set
+      if @api_client.config.client_side_validation && secret_key_id.nil?
+        raise ArgumentError, "Parameter `secret_key_id` is required when calling `delete_secret_key`."
+      end
+      # verify the required parameter 'secret_key_id' is not empty
+      if @api_client.config.client_side_validation && secret_key_id.empty?
+        raise ArgumentError, "Parameter `secret_key_id` is required when calling `delete_secret_key`."
+      end
+
+      path = "/agent-studio/1/secret-keys/{secretKeyId}".sub(
+        "{" + "secretKeyId" + "}",
+        Transport.encode_uri(secret_key_id.to_s)
+      )
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.delete_secret_key",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:DELETE, path, new_options)
+    end
+
+    # Delete Secret Key.
+    #
+    # Required API Key ACLs:
+    #   - admin
+    # @param secret_key_id [String] The secretKeyId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [nil]
+    def delete_secret_key(secret_key_id, request_options = {})
+      delete_secret_key_with_http_info(secret_key_id, request_options)
+      nil
+    end
+
+    # Permanently deletes all messages for the given user token. Does not delete conversations.
+    #
+    # Required API Key ACLs:
+    #   - logs
+    # @param user_token [String] The userToken. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def delete_user_data_with_http_info(user_token, request_options = {})
+      # verify the required parameter 'user_token' is set
+      if @api_client.config.client_side_validation && user_token.nil?
+        raise ArgumentError, "Parameter `user_token` is required when calling `delete_user_data`."
+      end
+      # verify the required parameter 'user_token' is not empty
+      if @api_client.config.client_side_validation && user_token.empty?
+        raise ArgumentError, "Parameter `user_token` is required when calling `delete_user_data`."
+      end
+
+      path = "/agent-studio/1/user-data/{userToken}".sub("{" + "userToken" + "}", Transport.encode_uri(user_token.to_s))
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.delete_user_data",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:DELETE, path, new_options)
+    end
+
+    # Permanently deletes all messages for the given user token. Does not delete conversations.
+    #
+    # Required API Key ACLs:
+    #   - logs
+    # @param user_token [String] The userToken. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [nil]
+    def delete_user_data(user_token, request_options = {})
+      delete_user_data_with_http_info(user_token, request_options)
+      nil
+    end
+
+    # Exports all conversations based on the passed filters.
+    #
+    # Required API Key ACLs:
+    #   - logs
+    # @param agent_id [String] The agentId. (required)
+    # @param start_date [String] Filter conversations created after this date (format: YYYY-MM-DD).
+    # @param end_date [String] Filter conversations created before this date (format: YYYY-MM-DD).
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def export_conversations_with_http_info(agent_id, start_date = nil, end_date = nil, request_options = {})
+      # verify the required parameter 'agent_id' is set
+      if @api_client.config.client_side_validation && agent_id.nil?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `export_conversations`."
+      end
+      # verify the required parameter 'agent_id' is not empty
+      if @api_client.config.client_side_validation && agent_id.empty?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `export_conversations`."
+      end
+
+      path = "/agent-studio/1/agents/{agentId}/conversations/export".sub(
+        "{" + "agentId" + "}",
+        Transport.encode_uri(agent_id.to_s)
+      )
+      query_params = {}
+      query_params[:startDate] = start_date unless start_date.nil?
+      query_params[:endDate] = end_date unless end_date.nil?
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.export_conversations",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:GET, path, new_options)
+    end
+
+    # Exports all conversations based on the passed filters.
+    #
+    # Required API Key ACLs:
+    #   - logs
+    # @param agent_id [String] The agentId. (required)
+    # @param start_date [String] Filter conversations created after this date (format: YYYY-MM-DD).
+    # @param end_date [String] Filter conversations created before this date (format: YYYY-MM-DD).
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Array<ConversationFullResponse>]
+    def export_conversations(agent_id, start_date = nil, end_date = nil, request_options = {})
+      response = export_conversations_with_http_info(agent_id, start_date, end_date, request_options)
+      @api_client.deserialize(
+        response.body,
+        request_options[:debug_return_type] || "Array<AgentStudio::ConversationFullResponse>"
+      )
+    end
+
+    # Retrieve details of the specified agent.
+    #
+    # Required API Key ACLs:
+    #   - settings
+    # @param agent_id [String] The agentId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def get_agent_with_http_info(agent_id, request_options = {})
+      # verify the required parameter 'agent_id' is set
+      if @api_client.config.client_side_validation && agent_id.nil?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `get_agent`."
+      end
+      # verify the required parameter 'agent_id' is not empty
+      if @api_client.config.client_side_validation && agent_id.empty?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `get_agent`."
+      end
+
+      path = "/agent-studio/1/agents/{agentId}".sub("{" + "agentId" + "}", Transport.encode_uri(agent_id.to_s))
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.get_agent",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:GET, path, new_options)
+    end
+
+    # Retrieve details of the specified agent.
+    #
+    # Required API Key ACLs:
+    #   - settings
+    # @param agent_id [String] The agentId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [AgentWithVersionResponse]
+    def get_agent(agent_id, request_options = {})
+      response = get_agent_with_http_info(agent_id, request_options)
+      @api_client.deserialize(
+        response.body,
+        request_options[:debug_return_type] || "AgentStudio::AgentWithVersionResponse"
+      )
+    end
+
+    # Get a single allowed domain by id.
+    #
+    # Required API Key ACLs:
+    #   - settings
+    # @param domain_id [String] The domainId. (required)
+    # @param agent_id [String] The agentId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def get_allowed_domain_with_http_info(domain_id, agent_id, request_options = {})
+      # verify the required parameter 'domain_id' is set
+      if @api_client.config.client_side_validation && domain_id.nil?
+        raise ArgumentError, "Parameter `domain_id` is required when calling `get_allowed_domain`."
+      end
+      # verify the required parameter 'domain_id' is not empty
+      if @api_client.config.client_side_validation && domain_id.empty?
+        raise ArgumentError, "Parameter `domain_id` is required when calling `get_allowed_domain`."
+      end
+      # verify the required parameter 'agent_id' is set
+      if @api_client.config.client_side_validation && agent_id.nil?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `get_allowed_domain`."
+      end
+      # verify the required parameter 'agent_id' is not empty
+      if @api_client.config.client_side_validation && agent_id.empty?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `get_allowed_domain`."
+      end
+
+      path = "/agent-studio/1/agents/{agentId}/allowed-domains/{domainId}"
+        .sub("{" + "domainId" + "}", Transport.encode_uri(domain_id.to_s))
+        .sub("{" + "agentId" + "}", Transport.encode_uri(agent_id.to_s))
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.get_allowed_domain",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:GET, path, new_options)
+    end
+
+    # Get a single allowed domain by id.
+    #
+    # Required API Key ACLs:
+    #   - settings
+    # @param domain_id [String] The domainId. (required)
+    # @param agent_id [String] The agentId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [AllowedDomainResponse]
+    def get_allowed_domain(domain_id, agent_id, request_options = {})
+      response = get_allowed_domain_with_http_info(domain_id, agent_id, request_options)
+      @api_client.deserialize(
+        response.body,
+        request_options[:debug_return_type] || "AgentStudio::AllowedDomainResponse"
+      )
+    end
+
+    # Get Configuration.
+    #
+    # Required API Key ACLs:
+    #   - logs
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def get_configuration_with_http_info(request_options = {})
+      path = "/agent-studio/1/configuration"
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.get_configuration",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:GET, path, new_options)
+    end
+
+    # Get Configuration.
+    #
+    # Required API Key ACLs:
+    #   - logs
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [ApplicationConfigResponse]
+    def get_configuration(request_options = {})
+      response = get_configuration_with_http_info(request_options)
+      @api_client.deserialize(
+        response.body,
+        request_options[:debug_return_type] || "AgentStudio::ApplicationConfigResponse"
+      )
+    end
+
+    # Retrieves the conversation and its messages for the given ID.
+    #
+    # Required API Key ACLs:
+    #   - logs
+    # @param conversation_id [String] The conversationId. (required)
+    # @param agent_id [String] The agentId. (required)
+    # @param include_feedback [Boolean] Include feedback for the conversation. (default to false)
+    # @param x_algolia_secure_user_token [String] The X-Algolia-Secure-User-Token.
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def get_conversation_with_http_info(
+      conversation_id,
+      agent_id,
+      include_feedback = nil,
+      x_algolia_secure_user_token = nil,
+      request_options = {}
+    )
+      # verify the required parameter 'conversation_id' is set
+      if @api_client.config.client_side_validation && conversation_id.nil?
+        raise ArgumentError, "Parameter `conversation_id` is required when calling `get_conversation`."
+      end
+      # verify the required parameter 'conversation_id' is not empty
+      if @api_client.config.client_side_validation && conversation_id.empty?
+        raise ArgumentError, "Parameter `conversation_id` is required when calling `get_conversation`."
+      end
+      # verify the required parameter 'agent_id' is set
+      if @api_client.config.client_side_validation && agent_id.nil?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `get_conversation`."
+      end
+      # verify the required parameter 'agent_id' is not empty
+      if @api_client.config.client_side_validation && agent_id.empty?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `get_conversation`."
+      end
+
+      path = "/agent-studio/1/agents/{agentId}/conversations/{conversationId}"
+        .sub("{" + "conversationId" + "}", Transport.encode_uri(conversation_id.to_s))
+        .sub("{" + "agentId" + "}", Transport.encode_uri(agent_id.to_s))
+      query_params = {}
+      query_params[:includeFeedback] = include_feedback unless include_feedback.nil?
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      unless x_algolia_secure_user_token.nil?
+        header_params[:"X-Algolia-Secure-User-Token"] = x_algolia_secure_user_token
+      end
+
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.get_conversation",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:GET, path, new_options)
+    end
+
+    # Retrieves the conversation and its messages for the given ID.
+    #
+    # Required API Key ACLs:
+    #   - logs
+    # @param conversation_id [String] The conversationId. (required)
+    # @param agent_id [String] The agentId. (required)
+    # @param include_feedback [Boolean] Include feedback for the conversation. (default to false)
+    # @param x_algolia_secure_user_token [String] The X-Algolia-Secure-User-Token.
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [ConversationFullResponse]
+    def get_conversation(
+      conversation_id,
+      agent_id,
+      include_feedback = nil,
+      x_algolia_secure_user_token = nil,
+      request_options = {}
+    )
+      response = get_conversation_with_http_info(
+        conversation_id,
+        agent_id,
+        include_feedback,
+        x_algolia_secure_user_token,
+        request_options
+      )
+      @api_client.deserialize(
+        response.body,
+        request_options[:debug_return_type] || "AgentStudio::ConversationFullResponse"
+      )
+    end
+
+    # Get Provider.
+    #
+    # Required API Key ACLs:
+    #   - settings
+    # @param provider_id [String] The providerId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def get_provider_with_http_info(provider_id, request_options = {})
+      # verify the required parameter 'provider_id' is set
+      if @api_client.config.client_side_validation && provider_id.nil?
+        raise ArgumentError, "Parameter `provider_id` is required when calling `get_provider`."
+      end
+      # verify the required parameter 'provider_id' is not empty
+      if @api_client.config.client_side_validation && provider_id.empty?
+        raise ArgumentError, "Parameter `provider_id` is required when calling `get_provider`."
+      end
+
+      path = "/agent-studio/1/providers/{providerId}".sub(
+        "{" + "providerId" + "}",
+        Transport.encode_uri(provider_id.to_s)
+      )
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.get_provider",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:GET, path, new_options)
+    end
+
+    # Get Provider.
+    #
+    # Required API Key ACLs:
+    #   - settings
+    # @param provider_id [String] The providerId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [ProviderAuthenticationResponse]
+    def get_provider(provider_id, request_options = {})
+      response = get_provider_with_http_info(provider_id, request_options)
+      @api_client.deserialize(
+        response.body,
+        request_options[:debug_return_type] || "AgentStudio::ProviderAuthenticationResponse"
+      )
+    end
+
+    # Get Secret Key.
+    #
+    # Required API Key ACLs:
+    #   - settings
+    # @param secret_key_id [String] The secretKeyId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def get_secret_key_with_http_info(secret_key_id, request_options = {})
+      # verify the required parameter 'secret_key_id' is set
+      if @api_client.config.client_side_validation && secret_key_id.nil?
+        raise ArgumentError, "Parameter `secret_key_id` is required when calling `get_secret_key`."
+      end
+      # verify the required parameter 'secret_key_id' is not empty
+      if @api_client.config.client_side_validation && secret_key_id.empty?
+        raise ArgumentError, "Parameter `secret_key_id` is required when calling `get_secret_key`."
+      end
+
+      path = "/agent-studio/1/secret-keys/{secretKeyId}".sub(
+        "{" + "secretKeyId" + "}",
+        Transport.encode_uri(secret_key_id.to_s)
+      )
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.get_secret_key",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:GET, path, new_options)
+    end
+
+    # Get Secret Key.
+    #
+    # Required API Key ACLs:
+    #   - settings
+    # @param secret_key_id [String] The secretKeyId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [SecretKeyResponse]
+    def get_secret_key(secret_key_id, request_options = {})
+      response = get_secret_key_with_http_info(secret_key_id, request_options)
+      @api_client.deserialize(response.body, request_options[:debug_return_type] || "AgentStudio::SecretKeyResponse")
+    end
+
+    # Retrieves all memories, conversations and their messages for the given user token.
+    #
+    # Required API Key ACLs:
+    #   - logs
+    # @param user_token [String] The userToken. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def get_user_data_with_http_info(user_token, request_options = {})
+      # verify the required parameter 'user_token' is set
+      if @api_client.config.client_side_validation && user_token.nil?
+        raise ArgumentError, "Parameter `user_token` is required when calling `get_user_data`."
+      end
+      # verify the required parameter 'user_token' is not empty
+      if @api_client.config.client_side_validation && user_token.empty?
+        raise ArgumentError, "Parameter `user_token` is required when calling `get_user_data`."
+      end
+
+      path = "/agent-studio/1/user-data/{userToken}".sub("{" + "userToken" + "}", Transport.encode_uri(user_token.to_s))
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.get_user_data",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:GET, path, new_options)
+    end
+
+    # Retrieves all memories, conversations and their messages for the given user token.
+    #
+    # Required API Key ACLs:
+    #   - logs
+    # @param user_token [String] The userToken. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [UserDataResponse]
+    def get_user_data(user_token, request_options = {})
+      response = get_user_data_with_http_info(user_token, request_options)
+      @api_client.deserialize(response.body, request_options[:debug_return_type] || "AgentStudio::UserDataResponse")
+    end
+
+    # Invalidate cached completions for this agent. Filter with `before` (exclusive).
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param agent_id [String] The agentId. (required)
+    # @param before [String] Delete entries strictly before this date (exclusive, YYYY-MM-DD).
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def invalidate_agent_cache_with_http_info(agent_id, before = nil, request_options = {})
+      # verify the required parameter 'agent_id' is set
+      if @api_client.config.client_side_validation && agent_id.nil?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `invalidate_agent_cache`."
+      end
+      # verify the required parameter 'agent_id' is not empty
+      if @api_client.config.client_side_validation && agent_id.empty?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `invalidate_agent_cache`."
+      end
+
+      path = "/agent-studio/1/agents/{agentId}/cache".sub("{" + "agentId" + "}", Transport.encode_uri(agent_id.to_s))
+      query_params = {}
+      query_params[:before] = before unless before.nil?
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.invalidate_agent_cache",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:DELETE, path, new_options)
+    end
+
+    # Invalidate cached completions for this agent. Filter with `before` (exclusive).
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param agent_id [String] The agentId. (required)
+    # @param before [String] Delete entries strictly before this date (exclusive, YYYY-MM-DD).
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [nil]
+    def invalidate_agent_cache(agent_id, before = nil, request_options = {})
+      invalidate_agent_cache_with_http_info(agent_id, before, request_options)
+      nil
+    end
+
+    # List all allowed domain patterns for this agent.
+    #
+    # Required API Key ACLs:
+    #   - settings
+    # @param agent_id [String] The agentId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def list_agent_allowed_domains_with_http_info(agent_id, request_options = {})
+      # verify the required parameter 'agent_id' is set
+      if @api_client.config.client_side_validation && agent_id.nil?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `list_agent_allowed_domains`."
+      end
+      # verify the required parameter 'agent_id' is not empty
+      if @api_client.config.client_side_validation && agent_id.empty?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `list_agent_allowed_domains`."
+      end
+
+      path = "/agent-studio/1/agents/{agentId}/allowed-domains".sub(
+        "{" + "agentId" + "}",
+        Transport.encode_uri(agent_id.to_s)
+      )
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.list_agent_allowed_domains",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:GET, path, new_options)
+    end
+
+    # List all allowed domain patterns for this agent.
+    #
+    # Required API Key ACLs:
+    #   - settings
+    # @param agent_id [String] The agentId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [AllowedDomainListResponse]
+    def list_agent_allowed_domains(agent_id, request_options = {})
+      response = list_agent_allowed_domains_with_http_info(agent_id, request_options)
+      @api_client.deserialize(
+        response.body,
+        request_options[:debug_return_type] || "AgentStudio::AllowedDomainListResponse"
+      )
+    end
+
+    # Retrieves the conversations for the given agent ID.
+    #
+    # Required API Key ACLs:
+    #   - logs
+    # @param agent_id [String] The agentId. (required)
+    # @param start_date [String] Filter conversations created after this date (format: YYYY-MM-DD).
+    # @param end_date [String] Filter conversations created before this date (format: YYYY-MM-DD).
+    # @param include_feedback [Boolean] Include feedback per conversation.
+    # @param feedback_vote [Integer] Filter by feedback value (requires includeFeedback=true).
+    # @param page [Integer] Page number. (default to 1)
+    # @param limit [Integer] Items per page. (default to 20)
+    # @param x_algolia_secure_user_token [String] The X-Algolia-Secure-User-Token.
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def list_agent_conversations_with_http_info(
+      agent_id,
+      start_date = nil,
+      end_date = nil,
+      include_feedback = nil,
+      feedback_vote = nil,
+      page = nil,
+      limit = nil,
+      x_algolia_secure_user_token = nil,
+      request_options = {}
+    )
+      # verify the required parameter 'agent_id' is set
+      if @api_client.config.client_side_validation && agent_id.nil?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `list_agent_conversations`."
+      end
+      # verify the required parameter 'agent_id' is not empty
+      if @api_client.config.client_side_validation && agent_id.empty?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `list_agent_conversations`."
+      end
+
+      path = "/agent-studio/1/agents/{agentId}/conversations".sub(
+        "{" + "agentId" + "}",
+        Transport.encode_uri(agent_id.to_s)
+      )
+      query_params = {}
+      query_params[:startDate] = start_date unless start_date.nil?
+      query_params[:endDate] = end_date unless end_date.nil?
+      query_params[:includeFeedback] = include_feedback unless include_feedback.nil?
+      query_params[:feedbackVote] = feedback_vote unless feedback_vote.nil?
+      query_params[:page] = page unless page.nil?
+      query_params[:limit] = limit unless limit.nil?
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      unless x_algolia_secure_user_token.nil?
+        header_params[:"X-Algolia-Secure-User-Token"] = x_algolia_secure_user_token
+      end
+
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.list_agent_conversations",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:GET, path, new_options)
+    end
+
+    # Retrieves the conversations for the given agent ID.
+    #
+    # Required API Key ACLs:
+    #   - logs
+    # @param agent_id [String] The agentId. (required)
+    # @param start_date [String] Filter conversations created after this date (format: YYYY-MM-DD).
+    # @param end_date [String] Filter conversations created before this date (format: YYYY-MM-DD).
+    # @param include_feedback [Boolean] Include feedback per conversation.
+    # @param feedback_vote [Integer] Filter by feedback value (requires includeFeedback=true).
+    # @param page [Integer] Page number. (default to 1)
+    # @param limit [Integer] Items per page. (default to 20)
+    # @param x_algolia_secure_user_token [String] The X-Algolia-Secure-User-Token.
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [PaginatedConversationsResponse]
+    def list_agent_conversations(
+      agent_id,
+      start_date = nil,
+      end_date = nil,
+      include_feedback = nil,
+      feedback_vote = nil,
+      page = nil,
+      limit = nil,
+      x_algolia_secure_user_token = nil,
+      request_options = {}
+    )
+      response = list_agent_conversations_with_http_info(
+        agent_id,
+        start_date,
+        end_date,
+        include_feedback,
+        feedback_vote,
+        page,
+        limit,
+        x_algolia_secure_user_token,
+        request_options
+      )
+      @api_client.deserialize(
+        response.body,
+        request_options[:debug_return_type] || "AgentStudio::PaginatedConversationsResponse"
+      )
+    end
+
+    # List all agents with pagination and filtering.
+    #
+    # Required API Key ACLs:
+    #   - settings
+    # @param page [Integer] Page number. (default to 1)
+    # @param limit [Integer] Items per page. (default to 10)
+    # @param provider_id [String] Filter by provider id.
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def list_agents_with_http_info(page = nil, limit = nil, provider_id = nil, request_options = {})
+      path = "/agent-studio/1/agents"
+      query_params = {}
+      query_params[:page] = page unless page.nil?
+      query_params[:limit] = limit unless limit.nil?
+      query_params[:providerId] = provider_id unless provider_id.nil?
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.list_agents",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:GET, path, new_options)
+    end
+
+    # List all agents with pagination and filtering.
+    #
+    # Required API Key ACLs:
+    #   - settings
+    # @param page [Integer] Page number. (default to 1)
+    # @param limit [Integer] Items per page. (default to 10)
+    # @param provider_id [String] Filter by provider id.
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [PaginatedAgentsResponse]
+    def list_agents(page = nil, limit = nil, provider_id = nil, request_options = {})
+      response = list_agents_with_http_info(page, limit, provider_id, request_options)
+      @api_client.deserialize(
+        response.body,
+        request_options[:debug_return_type] || "AgentStudio::PaginatedAgentsResponse"
+      )
+    end
+
+    # Get Provider Models.
+    #
+    # Required API Key ACLs:
+    #   - settings
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def list_models_with_http_info(request_options = {})
+      path = "/agent-studio/1/providers/models"
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.list_models",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:GET, path, new_options)
+    end
+
+    # Get Provider Models.
+    #
+    # Required API Key ACLs:
+    #   - settings
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Hash<String, Array<String>>]
+    def list_models(request_options = {})
+      response = list_models_with_http_info(request_options)
+      @api_client.deserialize(response.body, request_options[:debug_return_type] || "Hash<String, Array<String>>")
+    end
+
+    # Get available models for a specific provider.
+    #
+    # Required API Key ACLs:
+    #   - settings
+    # @param provider_id [String] The providerId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def list_provider_models_with_http_info(provider_id, request_options = {})
+      # verify the required parameter 'provider_id' is set
+      if @api_client.config.client_side_validation && provider_id.nil?
+        raise ArgumentError, "Parameter `provider_id` is required when calling `list_provider_models`."
+      end
+      # verify the required parameter 'provider_id' is not empty
+      if @api_client.config.client_side_validation && provider_id.empty?
+        raise ArgumentError, "Parameter `provider_id` is required when calling `list_provider_models`."
+      end
+
+      path = "/agent-studio/1/providers/{providerId}/models".sub(
+        "{" + "providerId" + "}",
+        Transport.encode_uri(provider_id.to_s)
+      )
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.list_provider_models",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:GET, path, new_options)
+    end
+
+    # Get available models for a specific provider.
+    #
+    # Required API Key ACLs:
+    #   - settings
+    # @param provider_id [String] The providerId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Array<String>]
+    def list_provider_models(provider_id, request_options = {})
+      response = list_provider_models_with_http_info(provider_id, request_options)
+      @api_client.deserialize(response.body, request_options[:debug_return_type] || "Array<AgentStudio::>")
+    end
+
+    # List Providers.
+    #
+    # Required API Key ACLs:
+    #   - settings
+    # @param page [Integer] Page number. (default to 1)
+    # @param limit [Integer] Items per page. (default to 10)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def list_providers_with_http_info(page = nil, limit = nil, request_options = {})
+      path = "/agent-studio/1/providers"
+      query_params = {}
+      query_params[:page] = page unless page.nil?
+      query_params[:limit] = limit unless limit.nil?
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.list_providers",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:GET, path, new_options)
+    end
+
+    # List Providers.
+    #
+    # Required API Key ACLs:
+    #   - settings
+    # @param page [Integer] Page number. (default to 1)
+    # @param limit [Integer] Items per page. (default to 10)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [PaginatedProviderAuthenticationsResponse]
+    def list_providers(page = nil, limit = nil, request_options = {})
+      response = list_providers_with_http_info(page, limit, request_options)
+      @api_client.deserialize(
+        response.body,
+        request_options[:debug_return_type] || "AgentStudio::PaginatedProviderAuthenticationsResponse"
+      )
+    end
+
+    # List Secret Keys.
+    #
+    # Required API Key ACLs:
+    #   - settings
+    # @param page [Integer] Page number. (default to 1)
+    # @param limit [Integer] Items per page. (default to 10)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def list_secret_keys_with_http_info(page = nil, limit = nil, request_options = {})
+      path = "/agent-studio/1/secret-keys"
+      query_params = {}
+      query_params[:page] = page unless page.nil?
+      query_params[:limit] = limit unless limit.nil?
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.list_secret_keys",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:GET, path, new_options)
+    end
+
+    # List Secret Keys.
+    #
+    # Required API Key ACLs:
+    #   - settings
+    # @param page [Integer] Page number. (default to 1)
+    # @param limit [Integer] Items per page. (default to 10)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [PaginatedSecretKeysResponse]
+    def list_secret_keys(page = nil, limit = nil, request_options = {})
+      response = list_secret_keys_with_http_info(page, limit, request_options)
+      @api_client.deserialize(
+        response.body,
+        request_options[:debug_return_type] || "AgentStudio::PaginatedSecretKeysResponse"
+      )
+    end
+
+    # Publish the specified agent.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param agent_id [String] The agentId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def publish_agent_with_http_info(agent_id, request_options = {})
+      # verify the required parameter 'agent_id' is set
+      if @api_client.config.client_side_validation && agent_id.nil?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `publish_agent`."
+      end
+      # verify the required parameter 'agent_id' is not empty
+      if @api_client.config.client_side_validation && agent_id.empty?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `publish_agent`."
+      end
+
+      path = "/agent-studio/1/agents/{agentId}/publish".sub("{" + "agentId" + "}", Transport.encode_uri(agent_id.to_s))
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.publish_agent",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:POST, path, new_options)
+    end
+
+    # Publish the specified agent.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param agent_id [String] The agentId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [AgentWithVersionResponse]
+    def publish_agent(agent_id, request_options = {})
+      response = publish_agent_with_http_info(agent_id, request_options)
+      @api_client.deserialize(
+        response.body,
+        request_options[:debug_return_type] || "AgentStudio::AgentWithVersionResponse"
+      )
+    end
+
+    # Unpublish the specified agent.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param agent_id [String] The agentId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def unpublish_agent_with_http_info(agent_id, request_options = {})
+      # verify the required parameter 'agent_id' is set
+      if @api_client.config.client_side_validation && agent_id.nil?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `unpublish_agent`."
+      end
+      # verify the required parameter 'agent_id' is not empty
+      if @api_client.config.client_side_validation && agent_id.empty?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `unpublish_agent`."
+      end
+
+      path = "/agent-studio/1/agents/{agentId}/unpublish".sub(
+        "{" + "agentId" + "}",
+        Transport.encode_uri(agent_id.to_s)
+      )
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body]
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.unpublish_agent",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:POST, path, new_options)
+    end
+
+    # Unpublish the specified agent.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param agent_id [String] The agentId. (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [AgentWithVersionResponse]
+    def unpublish_agent(agent_id, request_options = {})
+      response = unpublish_agent_with_http_info(agent_id, request_options)
+      @api_client.deserialize(
+        response.body,
+        request_options[:debug_return_type] || "AgentStudio::AgentWithVersionResponse"
+      )
+    end
+
+    # Update the specified agent.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param agent_id [String] The agentId. (required)
+    # @param agent_config_update [AgentConfigUpdate]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def update_agent_with_http_info(agent_id, agent_config_update, request_options = {})
+      # verify the required parameter 'agent_id' is set
+      if @api_client.config.client_side_validation && agent_id.nil?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `update_agent`."
+      end
+      # verify the required parameter 'agent_id' is not empty
+      if @api_client.config.client_side_validation && agent_id.empty?
+        raise ArgumentError, "Parameter `agent_id` is required when calling `update_agent`."
+      end
+      # verify the required parameter 'agent_config_update' is set
+      if @api_client.config.client_side_validation && agent_config_update.nil?
+        raise ArgumentError, "Parameter `agent_config_update` is required when calling `update_agent`."
+      end
+
+      path = "/agent-studio/1/agents/{agentId}".sub("{" + "agentId" + "}", Transport.encode_uri(agent_id.to_s))
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body] || @api_client.object_to_http_body(agent_config_update)
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.update_agent",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:PATCH, path, new_options)
+    end
+
+    # Update the specified agent.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param agent_id [String] The agentId. (required)
+    # @param agent_config_update [AgentConfigUpdate]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [AgentWithVersionResponse]
+    def update_agent(agent_id, agent_config_update, request_options = {})
+      response = update_agent_with_http_info(agent_id, agent_config_update, request_options)
+      @api_client.deserialize(
+        response.body,
+        request_options[:debug_return_type] || "AgentStudio::AgentWithVersionResponse"
+      )
+    end
+
+    # Patch Configuration.
+    #
+    # Required API Key ACLs:
+    #   - logs
+    # @param application_config_patch [ApplicationConfigPatch]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def update_configuration_with_http_info(application_config_patch, request_options = {})
+      # verify the required parameter 'application_config_patch' is set
+      if @api_client.config.client_side_validation && application_config_patch.nil?
+        raise ArgumentError, "Parameter `application_config_patch` is required when calling `update_configuration`."
+      end
+
+      path = "/agent-studio/1/configuration"
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body] || @api_client.object_to_http_body(application_config_patch)
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.update_configuration",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:PATCH, path, new_options)
+    end
+
+    # Patch Configuration.
+    #
+    # Required API Key ACLs:
+    #   - logs
+    # @param application_config_patch [ApplicationConfigPatch]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [ApplicationConfigResponse]
+    def update_configuration(application_config_patch, request_options = {})
+      response = update_configuration_with_http_info(application_config_patch, request_options)
+      @api_client.deserialize(
+        response.body,
+        request_options[:debug_return_type] || "AgentStudio::ApplicationConfigResponse"
+      )
+    end
+
+    # Update Provider.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param provider_id [String] The providerId. (required)
+    # @param provider_authentication_patch [ProviderAuthenticationPatch]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def update_provider_with_http_info(provider_id, provider_authentication_patch, request_options = {})
+      # verify the required parameter 'provider_id' is set
+      if @api_client.config.client_side_validation && provider_id.nil?
+        raise ArgumentError, "Parameter `provider_id` is required when calling `update_provider`."
+      end
+      # verify the required parameter 'provider_id' is not empty
+      if @api_client.config.client_side_validation && provider_id.empty?
+        raise ArgumentError, "Parameter `provider_id` is required when calling `update_provider`."
+      end
+      # verify the required parameter 'provider_authentication_patch' is set
+      if @api_client.config.client_side_validation && provider_authentication_patch.nil?
+        raise ArgumentError, "Parameter `provider_authentication_patch` is required when calling `update_provider`."
+      end
+
+      path = "/agent-studio/1/providers/{providerId}".sub(
+        "{" + "providerId" + "}",
+        Transport.encode_uri(provider_id.to_s)
+      )
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body] || @api_client.object_to_http_body(provider_authentication_patch)
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.update_provider",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:PATCH, path, new_options)
+    end
+
+    # Update Provider.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param provider_id [String] The providerId. (required)
+    # @param provider_authentication_patch [ProviderAuthenticationPatch]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [ProviderAuthenticationResponse]
+    def update_provider(provider_id, provider_authentication_patch, request_options = {})
+      response = update_provider_with_http_info(provider_id, provider_authentication_patch, request_options)
+      @api_client.deserialize(
+        response.body,
+        request_options[:debug_return_type] || "AgentStudio::ProviderAuthenticationResponse"
+      )
+    end
+
+    # Patch Secret Key.
+    #
+    # Required API Key ACLs:
+    #   - admin
+    # @param secret_key_id [String] The secretKeyId. (required)
+    # @param secret_key_patch [SecretKeyPatch]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def update_secret_key_with_http_info(secret_key_id, secret_key_patch, request_options = {})
+      # verify the required parameter 'secret_key_id' is set
+      if @api_client.config.client_side_validation && secret_key_id.nil?
+        raise ArgumentError, "Parameter `secret_key_id` is required when calling `update_secret_key`."
+      end
+      # verify the required parameter 'secret_key_id' is not empty
+      if @api_client.config.client_side_validation && secret_key_id.empty?
+        raise ArgumentError, "Parameter `secret_key_id` is required when calling `update_secret_key`."
+      end
+      # verify the required parameter 'secret_key_patch' is set
+      if @api_client.config.client_side_validation && secret_key_patch.nil?
+        raise ArgumentError, "Parameter `secret_key_patch` is required when calling `update_secret_key`."
+      end
+
+      path = "/agent-studio/1/secret-keys/{secretKeyId}".sub(
+        "{" + "secretKeyId" + "}",
+        Transport.encode_uri(secret_key_id.to_s)
+      )
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body] || @api_client.object_to_http_body(secret_key_patch)
+
+      new_options = request_options.merge(
+        :operation => :"AgentStudioClient.update_secret_key",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:PATCH, path, new_options)
+    end
+
+    # Patch Secret Key.
+    #
+    # Required API Key ACLs:
+    #   - admin
+    # @param secret_key_id [String] The secretKeyId. (required)
+    # @param secret_key_patch [SecretKeyPatch]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [SecretKeyResponse]
+    def update_secret_key(secret_key_id, secret_key_patch, request_options = {})
+      response = update_secret_key_with_http_info(secret_key_id, secret_key_patch, request_options)
+      @api_client.deserialize(response.body, request_options[:debug_return_type] || "AgentStudio::SecretKeyResponse")
+    end
+
+    # Helper: Forges a secured user token (JWT) for Agent Studio authenticated requests.
+    #
+    # @param secret_key [String] The secret key to sign the token with.
+    # @param secret_key_id [String] The key ID to include in the JWT header (kid).
+    # @param user_id [String] The user identifier to include as the subject (sub) claim.
+    # @param expires_in [Integer] The token expiration in seconds from now. Defaults to 86400 (24 hours).
+    # @return [String] The signed JWT token.
+    def forge_secured_user_token(secret_key, secret_key_id, user_id, expires_in = 86400)
+      header = Base64.urlsafe_encode64(
+        "{\"alg\":\"HS256\",\"typ\":\"JWT\",\"kid\":\"" + secret_key_id + "\"}",
+        padding: false
+      )
+      payload = Base64.urlsafe_encode64(
+        "{\"sub\":\"" + user_id + "\",\"exp\":" + (Time.now.to_i + expires_in).to_s + "}",
+        padding: false
+      )
+      signature = Base64.urlsafe_encode64(
+        OpenSSL::HMAC.digest("SHA256", secret_key, header + "." + payload),
+        padding: false
+      )
+
+      header + "." + payload + "." + signature
+    end
+  end
+end