telnyx 5.126.0 → 5.128.0

data/lib/telnyx/resources/ai/assistants/tools.rb

@@ -10,8 +10,10 @@ module Telnyx
           #
           # @overload add(tool_id, assistant_id:, request_options: {})
           #
-          # @param tool_id [String]
-          # @param assistant_id [String]
+          # @param tool_id [String] Unique identifier of the tool.
+          #
+          # @param assistant_id [String] Unique identifier of the assistant.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Object]
@@ -35,8 +37,10 @@ module Telnyx
           #
           # @overload remove(tool_id, assistant_id:, request_options: {})
           #
-          # @param tool_id [String]
-          # @param assistant_id [String]
+          # @param tool_id [String] Unique identifier of the tool.
+          #
+          # @param assistant_id [String] Unique identifier of the assistant.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Object]
@@ -60,9 +64,9 @@ module Telnyx
           #
           # @overload test_(tool_id, assistant_id:, arguments: nil, dynamic_variables: nil, request_options: {})
           #
-          # @param tool_id [String] Path param
+          # @param tool_id [String] Path param: Unique identifier of the tool.
           #
-          # @param assistant_id [String] Path param
+          # @param assistant_id [String] Path param: Unique identifier of the assistant.
           #
           # @param arguments [Hash{Symbol=>Object}] Body param: Key-value arguments to use for the webhook test
           #

data/lib/telnyx/resources/ai/assistants/versions.rb

@@ -10,11 +10,11 @@ module Telnyx
           #
           # @overload retrieve(version_id, assistant_id:, include_mcp_servers: nil, request_options: {})
           #
-          # @param version_id [String] Path param
+          # @param version_id [String] Path param: Unique identifier of the version.
           #
-          # @param assistant_id [String] Path param
+          # @param assistant_id [String] Path param: Unique identifier of the assistant.
           #
-          # @param include_mcp_servers [Boolean] Query param
+          # @param include_mcp_servers [Boolean] Query param: Whether to include MCP servers in the response.
           #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -45,9 +45,9 @@ module Telnyx
           #
           # @overload update(version_id, assistant_id:, conversation_flow: nil, description: nil, dynamic_variables: nil, dynamic_variables_webhook_timeout_ms: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, external_llm: nil, fallback_config: nil, greeting: nil, insight_settings: nil, instructions: nil, integrations: nil, interruption_settings: nil, llm_api_key_ref: nil, mcp_servers: nil, messaging_settings: nil, model: nil, name: nil, observability_settings: nil, post_conversation_settings: nil, privacy_settings: nil, tags: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, version_name: nil, voice_settings: nil, widget_settings: nil, request_options: {})
           #
-          # @param version_id [String] Path param
+          # @param version_id [String] Path param: Unique identifier of the version.
           #
-          # @param assistant_id [String] Path param
+          # @param assistant_id [String] Path param: Unique identifier of the assistant.
           #
           # @param conversation_flow [Telnyx::Models::AI::Assistants::UpdateAssistant::ConversationFlow] Body param: Conversation flow as supplied by API clients (create / update).
           #
@@ -61,9 +61,9 @@ module Telnyx
           #
           # @param enabled_features [Array<Symbol, Telnyx::Models::AI::EnabledFeatures>] Body param
           #
-          # @param external_llm [Telnyx::Models::AI::ExternalLlmReq] Body param
+          # @param external_llm [Telnyx::Models::AI::Assistants::UpdateAssistant::ExternalLlm] Body param
           #
-          # @param fallback_config [Telnyx::Models::AI::FallbackConfigReq] Body param
+          # @param fallback_config [Telnyx::Models::AI::Assistants::UpdateAssistant::FallbackConfig] Body param
           #
           # @param greeting [String] Body param: Text that the assistant will use to start the conversation. This may
           #
@@ -71,13 +71,13 @@ module Telnyx
           #
           # @param instructions [String] Body param: System instructions for the assistant. These may be templated with [
           #
-          # @param integrations [Array<Telnyx::Models::AI::AssistantIntegration>] Body param: Connected integrations attached to the assistant. The catalog of ava
+          # @param integrations [Array<Telnyx::Models::AI::Assistants::UpdateAssistant::Integration>] Body param: Connected integrations attached to the assistant. The catalog of ava
           #
-          # @param interruption_settings [Telnyx::Models::AI::InferenceEmbeddingInterruptionSettings] Body param: Settings for interruptions and how the assistant decides the user ha
+          # @param interruption_settings [Telnyx::Models::AI::Assistants::UpdateAssistant::InterruptionSettings] Body param: Settings for interruptions and how the assistant decides the user ha
           #
           # @param llm_api_key_ref [String] Body param: This is only needed when using third-party inference providers selec
           #
-          # @param mcp_servers [Array<Telnyx::Models::AI::AssistantMcpServer>] Body param: MCP servers attached to the assistant. Create MCP servers with `/ai/
+          # @param mcp_servers [Array<Telnyx::Models::AI::Assistants::UpdateAssistant::McpServer>] Body param: MCP servers attached to the assistant. Create MCP servers with `/ai/
           #
           # @param messaging_settings [Telnyx::Models::AI::MessagingSettings] Body param
           #
@@ -87,7 +87,7 @@ module Telnyx
           #
           # @param observability_settings [Telnyx::Models::AI::ObservabilityReq] Body param
           #
-          # @param post_conversation_settings [Telnyx::Models::AI::PostConversationSettingsReq] Body param: Configuration for post-conversation processing. When enabled, the as
+          # @param post_conversation_settings [Telnyx::Models::AI::Assistants::UpdateAssistant::PostConversationSettings] Body param: Configuration for post-conversation processing. When enabled, the as
           #
           # @param privacy_settings [Telnyx::Models::AI::PrivacySettings] Body param
           #
@@ -132,7 +132,8 @@ module Telnyx
           #
           # @overload list(assistant_id, request_options: {})
           #
-          # @param assistant_id [String]
+          # @param assistant_id [String] Unique identifier of the assistant.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Telnyx::Models::AI::AssistantsList]
@@ -152,8 +153,10 @@ module Telnyx
           #
           # @overload delete(version_id, assistant_id:, request_options: {})
           #
-          # @param version_id [String]
-          # @param assistant_id [String]
+          # @param version_id [String] Unique identifier of the version.
+          #
+          # @param assistant_id [String] Unique identifier of the assistant.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [nil]
@@ -179,8 +182,10 @@ module Telnyx
           #
           # @overload promote(version_id, assistant_id:, request_options: {})
           #
-          # @param version_id [String]
-          # @param assistant_id [String]
+          # @param version_id [String] Unique identifier of the version.
+          #
+          # @param assistant_id [String] Unique identifier of the assistant.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Telnyx::Models::AI::InferenceEmbedding]

data/lib/telnyx/resources/ai/assistants.rb

@@ -29,6 +29,10 @@ module Telnyx
         # @return [Telnyx::Resources::AI::Assistants::Tags]
         attr_reader :tags
 
+        # Configure AI assistant specifications
+        # @return [Telnyx::Resources::AI::Assistants::Instructions]
+        attr_reader :instructions
+
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::AI::AssistantCreateParams} for more details.
         #
@@ -52,21 +56,21 @@ module Telnyx
         #
         # @param enabled_features [Array<Symbol, Telnyx::Models::AI::EnabledFeatures>]
         #
-        # @param external_llm [Telnyx::Models::AI::ExternalLlmReq]
+        # @param external_llm [Telnyx::Models::AI::AssistantCreateParams::ExternalLlm]
         #
-        # @param fallback_config [Telnyx::Models::AI::FallbackConfigReq]
+        # @param fallback_config [Telnyx::Models::AI::AssistantCreateParams::FallbackConfig]
         #
         # @param greeting [String] Text that the assistant will use to start the conversation. This may be template
         #
         # @param insight_settings [Telnyx::Models::AI::InsightSettings]
         #
-        # @param integrations [Array<Telnyx::Models::AI::AssistantIntegration>] Connected integrations attached to the assistant. The catalog of available integ
+        # @param integrations [Array<Telnyx::Models::AI::AssistantCreateParams::Integration>] Connected integrations attached to the assistant. The catalog of available integ
         #
-        # @param interruption_settings [Telnyx::Models::AI::InferenceEmbeddingInterruptionSettings] Settings for interruptions and how the assistant decides the user has finished s
+        # @param interruption_settings [Telnyx::Models::AI::AssistantCreateParams::InterruptionSettings] Settings for interruptions and how the assistant decides the user has finished s
         #
         # @param llm_api_key_ref [String] This is only needed when using third-party inference providers selected by `mode
         #
-        # @param mcp_servers [Array<Telnyx::Models::AI::AssistantMcpServer>] MCP servers attached to the assistant. Create MCP servers with `/ai/mcp_servers`
+        # @param mcp_servers [Array<Telnyx::Models::AI::AssistantCreateParams::McpServer>] MCP servers attached to the assistant. Create MCP servers with `/ai/mcp_servers`
         #
         # @param messaging_settings [Telnyx::Models::AI::MessagingSettings]
         #
@@ -74,7 +78,7 @@ module Telnyx
         #
         # @param observability_settings [Telnyx::Models::AI::ObservabilityReq]
         #
-        # @param post_conversation_settings [Telnyx::Models::AI::PostConversationSettingsReq] Configuration for post-conversation processing. When enabled, the assistant rece
+        # @param post_conversation_settings [Telnyx::Models::AI::AssistantCreateParams::PostConversationSettings] Configuration for post-conversation processing. When enabled, the assistant rece
         #
         # @param privacy_settings [Telnyx::Models::AI::PrivacySettings]
         #
@@ -112,11 +116,16 @@ module Telnyx
         #
         # @overload retrieve(assistant_id, call_control_id: nil, fetch_dynamic_variables_from_webhook: nil, from: nil, to: nil, request_options: {})
         #
-        # @param assistant_id [String]
-        # @param call_control_id [String]
-        # @param fetch_dynamic_variables_from_webhook [Boolean]
-        # @param from [String]
-        # @param to [String]
+        # @param assistant_id [String] Unique identifier of the assistant.
+        #
+        # @param call_control_id [String] Filter results by call control id.
+        #
+        # @param fetch_dynamic_variables_from_webhook [Boolean] Whether to fetch dynamic variables from the configured webhook.
+        #
+        # @param from [String] Start of the filter range.
+        #
+        # @param to [String] End of the filter range.
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Models::AI::InferenceEmbedding]
@@ -141,7 +150,7 @@ module Telnyx
         #
         # @overload update(assistant_id, conversation_flow: nil, description: nil, dynamic_variables: nil, dynamic_variables_webhook_timeout_ms: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, external_llm: nil, fallback_config: nil, greeting: nil, insight_settings: nil, instructions: nil, integrations: nil, interruption_settings: nil, llm_api_key_ref: nil, mcp_servers: nil, messaging_settings: nil, model: nil, name: nil, observability_settings: nil, post_conversation_settings: nil, privacy_settings: nil, promote_to_main: nil, tags: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, version_name: nil, voice_settings: nil, widget_settings: nil, request_options: {})
         #
-        # @param assistant_id [String]
+        # @param assistant_id [String] Unique identifier of the assistant.
         #
         # @param conversation_flow [Telnyx::Models::AI::AssistantUpdateParams::ConversationFlow] Conversation flow as supplied by API clients (create / update).
         #
@@ -155,9 +164,9 @@ module Telnyx
         #
         # @param enabled_features [Array<Symbol, Telnyx::Models::AI::EnabledFeatures>]
         #
-        # @param external_llm [Telnyx::Models::AI::ExternalLlmReq]
+        # @param external_llm [Telnyx::Models::AI::AssistantUpdateParams::ExternalLlm]
         #
-        # @param fallback_config [Telnyx::Models::AI::FallbackConfigReq]
+        # @param fallback_config [Telnyx::Models::AI::AssistantUpdateParams::FallbackConfig]
         #
         # @param greeting [String] Text that the assistant will use to start the conversation. This may be template
         #
@@ -165,13 +174,13 @@ module Telnyx
         #
         # @param instructions [String] System instructions for the assistant. These may be templated with [dynamic vari
         #
-        # @param integrations [Array<Telnyx::Models::AI::AssistantIntegration>] Connected integrations attached to the assistant. The catalog of available integ
+        # @param integrations [Array<Telnyx::Models::AI::AssistantUpdateParams::Integration>] Connected integrations attached to the assistant. The catalog of available integ
         #
-        # @param interruption_settings [Telnyx::Models::AI::InferenceEmbeddingInterruptionSettings] Settings for interruptions and how the assistant decides the user has finished s
+        # @param interruption_settings [Telnyx::Models::AI::AssistantUpdateParams::InterruptionSettings] Settings for interruptions and how the assistant decides the user has finished s
         #
         # @param llm_api_key_ref [String] This is only needed when using third-party inference providers selected by `mode
         #
-        # @param mcp_servers [Array<Telnyx::Models::AI::AssistantMcpServer>] MCP servers attached to the assistant. Create MCP servers with `/ai/mcp_servers`
+        # @param mcp_servers [Array<Telnyx::Models::AI::AssistantUpdateParams::McpServer>] MCP servers attached to the assistant. Create MCP servers with `/ai/mcp_servers`
         #
         # @param messaging_settings [Telnyx::Models::AI::MessagingSettings]
         #
@@ -181,7 +190,7 @@ module Telnyx
         #
         # @param observability_settings [Telnyx::Models::AI::ObservabilityReq]
         #
-        # @param post_conversation_settings [Telnyx::Models::AI::PostConversationSettingsReq] Configuration for post-conversation processing. When enabled, the assistant rece
+        # @param post_conversation_settings [Telnyx::Models::AI::AssistantUpdateParams::PostConversationSettings] Configuration for post-conversation processing. When enabled, the assistant rece
         #
         # @param privacy_settings [Telnyx::Models::AI::PrivacySettings]
         #
@@ -241,7 +250,8 @@ module Telnyx
         #
         # @overload delete(assistant_id, request_options: {})
         #
-        # @param assistant_id [String]
+        # @param assistant_id [String] Unique identifier of the assistant.
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Models::AI::AssistantDeleteResponse]
@@ -267,7 +277,7 @@ module Telnyx
         #
         # @overload chat(assistant_id, content:, conversation_id:, name: nil, request_options: {})
         #
-        # @param assistant_id [String]
+        # @param assistant_id [String] Unique identifier of the assistant.
         #
         # @param content [String] The message content sent by the client to the assistant
         #
@@ -295,7 +305,8 @@ module Telnyx
         #
         # @overload clone_(assistant_id, request_options: {})
         #
-        # @param assistant_id [String]
+        # @param assistant_id [String] Unique identifier of the assistant.
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Models::AI::InferenceEmbedding]
@@ -314,7 +325,8 @@ module Telnyx
         #
         # @overload get_texml(assistant_id, request_options: {})
         #
-        # @param assistant_id [String]
+        # @param assistant_id [String] Unique identifier of the assistant.
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [String]
@@ -374,12 +386,18 @@ module Telnyx
         #
         # @overload send_sms(assistant_id, from:, to:, conversation_metadata: nil, should_create_conversation: nil, text: nil, request_options: {})
         #
-        # @param assistant_id [String]
+        # @param assistant_id [String] Unique identifier of the assistant.
+        #
         # @param from [String]
+        #
         # @param to [String]
+        #
         # @param conversation_metadata [Hash{Symbol=>String, Integer, Boolean}]
+        #
         # @param should_create_conversation [Boolean]
+        #
         # @param text [String]
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Models::AI::AssistantSendSMSResponse]
@@ -407,6 +425,7 @@ module Telnyx
           @tools = Telnyx::Resources::AI::Assistants::Tools.new(client: client)
           @versions = Telnyx::Resources::AI::Assistants::Versions.new(client: client)
           @tags = Telnyx::Resources::AI::Assistants::Tags.new(client: client)
+          @instructions = Telnyx::Resources::AI::Assistants::Instructions.new(client: client)
         end
       end
     end

data/lib/telnyx/resources/ai/clusters.rb

@@ -12,7 +12,7 @@ module Telnyx
         #
         # @overload retrieve(task_id, show_subclusters: nil, top_n_nodes: nil, request_options: {})
         #
-        # @param task_id [String]
+        # @param task_id [String] Unique identifier of the task.
         #
         # @param show_subclusters [Boolean] Whether or not to include subclusters and their nodes in the response.
         #
@@ -63,7 +63,8 @@ module Telnyx
         #
         # @overload delete(task_id, request_options: {})
         #
-        # @param task_id [String]
+        # @param task_id [String] Unique identifier of the task.
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [nil]
@@ -117,8 +118,10 @@ module Telnyx
         #
         # @overload fetch_graph(task_id, cluster_id: nil, request_options: {})
         #
-        # @param task_id [String]
-        # @param cluster_id [Integer]
+        # @param task_id [String] Unique identifier of the task.
+        #
+        # @param cluster_id [Integer] Filter results by cluster id.
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [StringIO]

data/lib/telnyx/resources/ai/conversations/messages.rb

@@ -11,7 +11,7 @@ module Telnyx
           #
           # @overload list(conversation_id, page_number: nil, page_size: nil, request_options: {})
           #
-          # @param conversation_id [String]
+          # @param conversation_id [String] Unique identifier of the conversation.
           #
           # @param page_number [Integer] The page number to retrieve.
           #

data/lib/telnyx/resources/ai/conversations.rb

@@ -213,7 +213,8 @@ module Telnyx
         #
         # @overload retrieve_conversations_insights(conversation_id, request_options: {})
         #
-        # @param conversation_id [String]
+        # @param conversation_id [String] Unique identifier of the conversation.
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Models::AI::ConversationRetrieveConversationsInsightsResponse]

data/lib/telnyx/resources/ai/embeddings/buckets.rb

@@ -11,7 +11,8 @@ module Telnyx
           #
           # @overload retrieve(bucket_name, request_options: {})
           #
-          # @param bucket_name [String]
+          # @param bucket_name [String] Name of the bucket.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Telnyx::Models::AI::Embeddings::BucketRetrieveResponse]
@@ -49,7 +50,8 @@ module Telnyx
           #
           # @overload delete(bucket_name, request_options: {})
           #
-          # @param bucket_name [String]
+          # @param bucket_name [String] Name of the bucket.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [nil]

data/lib/telnyx/resources/ai/embeddings.rb

@@ -78,7 +78,8 @@ module Telnyx
         #
         # @overload retrieve(task_id, request_options: {})
         #
-        # @param task_id [String]
+        # @param task_id [String] Unique identifier of the task.
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Models::AI::EmbeddingRetrieveResponse]

data/lib/telnyx/resources/ai/fine_tuning/jobs.rb

@@ -38,7 +38,8 @@ module Telnyx
           #
           # @overload retrieve(job_id, request_options: {})
           #
-          # @param job_id [String]
+          # @param job_id [String] Unique identifier of the job.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Telnyx::Models::AI::FineTuning::FineTuningJob]
@@ -75,7 +76,8 @@ module Telnyx
           #
           # @overload cancel(job_id, request_options: {})
           #
-          # @param job_id [String]
+          # @param job_id [String] Unique identifier of the job.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Telnyx::Models::AI::FineTuning::FineTuningJob]

data/lib/telnyx/resources/ai/mcp_servers.rb

@@ -33,7 +33,8 @@ module Telnyx
         #
         # @overload retrieve(mcp_server_id, request_options: {})
         #
-        # @param mcp_server_id [String]
+        # @param mcp_server_id [String] Unique identifier of the mcp server.
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Models::AI::McpServerRetrieveResponse]
@@ -52,14 +53,22 @@ module Telnyx
         #
         # @overload update(mcp_server_id, id: nil, allowed_tools: nil, api_key_ref: nil, created_at: nil, name: nil, type: nil, url: nil, request_options: {})
         #
-        # @param mcp_server_id [String]
+        # @param mcp_server_id [String] Unique identifier of the mcp server.
+        #
         # @param id [String]
+        #
         # @param allowed_tools [Array<String>, nil]
+        #
         # @param api_key_ref [String, nil]
+        #
         # @param created_at [Time]
+        #
         # @param name [String]
+        #
         # @param type [String]
+        #
         # @param url [String]
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Models::AI::McpServerUpdateResponse]
@@ -80,10 +89,14 @@ module Telnyx
         #
         # @overload list(page_number: nil, page_size: nil, type: nil, url: nil, request_options: {})
         #
-        # @param page_number [Integer]
-        # @param page_size [Integer]
-        # @param type [String]
-        # @param url [String]
+        # @param page_number [Integer] Page number to retrieve (1-based).
+        #
+        # @param page_size [Integer] Number of items to return per page.
+        #
+        # @param type [String] Filter results by type.
+        #
+        # @param url [String] Filter results by url.
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Internal::DefaultFlatPaginationTopLevelArray<Telnyx::Models::AI::McpServerListResponse>]
@@ -106,7 +119,8 @@ module Telnyx
         #
         # @overload delete(mcp_server_id, request_options: {})
         #
-        # @param mcp_server_id [String]
+        # @param mcp_server_id [String] Unique identifier of the mcp server.
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [nil]

data/lib/telnyx/resources/ai/missions/knowledge_bases.rb

@@ -9,7 +9,8 @@ module Telnyx
           #
           # @overload create_knowledge_base(mission_id, request_options: {})
           #
-          # @param mission_id [String]
+          # @param mission_id [String] Unique identifier of the mission.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Object]
@@ -28,8 +29,10 @@ module Telnyx
           #
           # @overload delete_knowledge_base(knowledge_base_id, mission_id:, request_options: {})
           #
-          # @param knowledge_base_id [String]
-          # @param mission_id [String]
+          # @param knowledge_base_id [String] Unique identifier of the knowledge base.
+          #
+          # @param mission_id [String] Unique identifier of the mission.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [nil]
@@ -53,8 +56,10 @@ module Telnyx
           #
           # @overload get_knowledge_base(knowledge_base_id, mission_id:, request_options: {})
           #
-          # @param knowledge_base_id [String]
-          # @param mission_id [String]
+          # @param knowledge_base_id [String] Unique identifier of the knowledge base.
+          #
+          # @param mission_id [String] Unique identifier of the mission.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Object]
@@ -78,7 +83,8 @@ module Telnyx
           #
           # @overload list_knowledge_bases(mission_id, request_options: {})
           #
-          # @param mission_id [String]
+          # @param mission_id [String] Unique identifier of the mission.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Object]
@@ -97,8 +103,10 @@ module Telnyx
           #
           # @overload update_knowledge_base(knowledge_base_id, mission_id:, request_options: {})
           #
-          # @param knowledge_base_id [String]
-          # @param mission_id [String]
+          # @param knowledge_base_id [String] Unique identifier of the knowledge base.
+          #
+          # @param mission_id [String] Unique identifier of the mission.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Object]

data/lib/telnyx/resources/ai/missions/mcp_servers.rb

@@ -9,7 +9,8 @@ module Telnyx
           #
           # @overload create_mcp_server(mission_id, request_options: {})
           #
-          # @param mission_id [String]
+          # @param mission_id [String] Unique identifier of the mission.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Object]
@@ -28,8 +29,10 @@ module Telnyx
           #
           # @overload delete_mcp_server(mcp_server_id, mission_id:, request_options: {})
           #
-          # @param mcp_server_id [String]
-          # @param mission_id [String]
+          # @param mcp_server_id [String] Unique identifier of the mcp server.
+          #
+          # @param mission_id [String] Unique identifier of the mission.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [nil]
@@ -53,8 +56,10 @@ module Telnyx
           #
           # @overload get_mcp_server(mcp_server_id, mission_id:, request_options: {})
           #
-          # @param mcp_server_id [String]
-          # @param mission_id [String]
+          # @param mcp_server_id [String] Unique identifier of the mcp server.
+          #
+          # @param mission_id [String] Unique identifier of the mission.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Object]
@@ -78,7 +83,8 @@ module Telnyx
           #
           # @overload list_mcp_servers(mission_id, request_options: {})
           #
-          # @param mission_id [String]
+          # @param mission_id [String] Unique identifier of the mission.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Object]
@@ -97,8 +103,10 @@ module Telnyx
           #
           # @overload update_mcp_server(mcp_server_id, mission_id:, request_options: {})
           #
-          # @param mcp_server_id [String]
-          # @param mission_id [String]
+          # @param mcp_server_id [String] Unique identifier of the mcp server.
+          #
+          # @param mission_id [String] Unique identifier of the mission.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Object]

data/lib/telnyx/resources/ai/missions/runs/events.rb

@@ -10,19 +10,19 @@ module Telnyx
             #
             # @overload list(run_id, mission_id:, agent_id: nil, page_number: nil, page_size: nil, step_id: nil, type: nil, request_options: {})
             #
-            # @param run_id [String] Path param
+            # @param run_id [String] Path param: Unique identifier of the run.
             #
-            # @param mission_id [String] Path param
+            # @param mission_id [String] Path param: Unique identifier of the mission.
             #
-            # @param agent_id [String] Query param
+            # @param agent_id [String] Query param: Filter results by agent id.
             #
             # @param page_number [Integer] Query param: Page number (1-based)
             #
             # @param page_size [Integer] Query param: Number of items per page
             #
-            # @param step_id [String] Query param
+            # @param step_id [String] Query param: Filter results by step id.
             #
-            # @param type [String] Query param
+            # @param type [String] Query param: Filter results by type.
             #
             # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -50,9 +50,12 @@ module Telnyx
             #
             # @overload get_event_details(event_id, mission_id:, run_id:, request_options: {})
             #
-            # @param event_id [String]
-            # @param mission_id [String]
-            # @param run_id [String]
+            # @param event_id [String] Unique identifier of the event.
+            #
+            # @param mission_id [String] Unique identifier of the mission.
+            #
+            # @param run_id [String] Unique identifier of the run.
+            #
             # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
             #
             # @return [Telnyx::Models::AI::Missions::Runs::EventGetEventDetailsResponse]
@@ -80,9 +83,9 @@ module Telnyx
             #
             # @overload log(run_id, mission_id:, summary:, type:, agent_id: nil, idempotency_key: nil, payload: nil, step_id: nil, request_options: {})
             #
-            # @param run_id [String] Path param
+            # @param run_id [String] Path param: Unique identifier of the run.
             #
-            # @param mission_id [String] Path param
+            # @param mission_id [String] Path param: Unique identifier of the mission.
             #
             # @param summary [String] Body param
             #