telnyx 5.162.0 → 5.164.0

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

@@ -9,6 +9,9 @@ module Telnyx
         # @return [Telnyx::Resources::AI::Embeddings::Buckets]
         attr_reader :buckets
 
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AI::EmbeddingCreateParams} for more details.
+        #
         # Perform embedding on a Telnyx Storage Bucket using the a embedding model. The
         # current supported file types are:
         #
@@ -39,17 +42,19 @@ module Telnyx
         # values will be returned by the `/v2/ai/embeddings/similarity-search` endpoint in
         # the `loader_metadata` field.
         #
-        # @overload create(bucket_name:, document_chunk_overlap_size: nil, document_chunk_size: nil, embedding_model: nil, loader: nil, request_options: {})
+        # @overload create(bucket_name:, document_chunk_overlap_size: nil, document_chunk_size: nil, embedding_model: nil, loader: nil, idempotency_key: nil, request_options: {})
         #
-        # @param bucket_name [String]
+        # @param bucket_name [String] Body param
         #
-        # @param document_chunk_overlap_size [Integer]
+        # @param document_chunk_overlap_size [Integer] Body param
         #
-        # @param document_chunk_size [Integer]
+        # @param document_chunk_size [Integer] Body param
         #
-        # @param embedding_model [Symbol, Telnyx::Models::AI::EmbeddingCreateParams::EmbeddingModel] Supported models to vectorize and embed documents.
+        # @param embedding_model [Symbol, Telnyx::Models::AI::EmbeddingCreateParams::EmbeddingModel] Body param: Supported models to vectorize and embed documents.
         #
-        # @param loader [Symbol, Telnyx::Models::AI::EmbeddingCreateParams::Loader] Supported types of custom document loaders for embeddings.
+        # @param loader [Symbol, Telnyx::Models::AI::EmbeddingCreateParams::Loader] Body param: Supported types of custom document loaders for embeddings.
+        #
+        # @param idempotency_key [String] Header param: Optional opaque, unquoted key for safely retrying the same logical
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -58,10 +63,12 @@ module Telnyx
         # @see Telnyx::Models::AI::EmbeddingCreateParams
         def create(params)
           parsed, options = Telnyx::AI::EmbeddingCreateParams.dump_request(params)
+          header_params = {idempotency_key: "idempotency-key"}
           @client.request(
             method: :post,
             path: "ai/embeddings",
-            body: parsed,
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
             model: Telnyx::AI::EmbeddingResponse,
             options: options
           )
@@ -154,6 +161,9 @@ module Telnyx
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AI::EmbeddingURLParams} for more details.
+        #
         # Embed website content from a specified URL, including child pages up to 5 levels
         # deep within the same domain. The process crawls and loads content from the main
         # URL and its linked pages into a Telnyx Cloud Storage bucket. As soon as each
@@ -162,11 +172,13 @@ module Telnyx
         # [similarity search](https://developers.telnyx.com/api-reference/embeddings/search-for-documents)
         # and [clustering](https://developers.telnyx.com/docs/inference/clusters).
         #
-        # @overload url(bucket_name:, url:, request_options: {})
+        # @overload url(bucket_name:, url:, idempotency_key: nil, request_options: {})
+        #
+        # @param bucket_name [String] Body param: Name of the bucket to store the embeddings. This bucket must already
         #
-        # @param bucket_name [String] Name of the bucket to store the embeddings. This bucket must already exist.
+        # @param url [String] Body param: The URL of the webpage to embed
         #
-        # @param url [String] The URL of the webpage to embed
+        # @param idempotency_key [String] Header param: Optional opaque, unquoted key for safely retrying the same logical
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -175,10 +187,12 @@ module Telnyx
         # @see Telnyx::Models::AI::EmbeddingURLParams
         def url(params)
           parsed, options = Telnyx::AI::EmbeddingURLParams.dump_request(params)
+          header_params = {idempotency_key: "idempotency-key"}
           @client.request(
             method: :post,
             path: "ai/embeddings/url",
-            body: parsed,
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
             model: Telnyx::AI::EmbeddingResponse,
             options: options
           )

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

@@ -6,7 +6,8 @@ module Telnyx
       class FineTuning
         # Customize LLMs for your unique needs
         class Jobs
-          # Create a new fine tuning job.
+          # Creates a new fine-tuning job that trains a model on the provided dataset, and
+          # returns the created job.
           #
           # @overload create(model:, training_file:, hyperparameters: nil, suffix: nil, request_options: {})
           #
@@ -34,7 +35,8 @@ module Telnyx
             )
           end
 
-          # Retrieve a fine tuning job by `job_id`.
+          # Returns the details of a single fine-tuning job by its job_id, including its
+          # current status.
           #
           # @overload retrieve(job_id, request_options: {})
           #
@@ -72,7 +74,7 @@ module Telnyx
             )
           end
 
-          # Cancel a fine tuning job.
+          # Cancels the specified in-progress fine-tuning job and returns the updated job.
           #
           # @overload cancel(job_id, request_options: {})
           #

data/lib/telnyx/resources/ai/integrations/connections.rb

@@ -5,7 +5,7 @@ module Telnyx
     class AI
       class Integrations
         class Connections
-          # Get user setup integrations
+          # Returns the details of a single integration connection by its ID.
           #
           # @overload retrieve(user_connection_id, request_options: {})
           #
@@ -25,7 +25,8 @@ module Telnyx
             )
           end
 
-          # List user setup integrations
+          # Returns the list of integration connections you have set up, linking your
+          # account to third-party services.
           #
           # @overload list(request_options: {})
           #

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

@@ -7,7 +7,8 @@ module Telnyx
         # @return [Telnyx::Resources::AI::Integrations::Connections]
         attr_reader :connections
 
-        # Retrieve integration details
+        # Returns the details of a single available integration, including its
+        # configuration details.
         #
         # @overload retrieve(integration_id, request_options: {})
         #
@@ -27,7 +28,8 @@ module Telnyx
           )
         end
 
-        # List all available integrations.
+        # Returns the list of third-party integrations available to connect to your AI
+        # assistants and workflows.
         #
         # @overload list(request_options: {})
         #

data/lib/telnyx/resources/ai/knowledge/collections.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      class Knowledge
+        # Create and manage logical collections of your Telnyx data, tune retrieval
+        # settings, manage sources, and run collection-scoped semantic search.
+        class Collections
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::AI::Knowledge::CollectionRetrieveDocumentsParams} for more
+          # details.
+          #
+          # Runs search over the documents in a collection, ranked by relevance to `query`.
+          # Searches currently run `vector` retrieval (semantic similarity). The
+          # collection's `retrieval_type` setting is the forward-compatible selector:
+          # `hybrid` (vector similarity fused with keyword matching) can be set but cannot
+          # be searched yet, and `keyword` (lexical BM25 matching) is not accepted yet --
+          # setting it returns 422 `unsupported_retrieval_type`. A per-request
+          # `retrieval_type` is accepted but ignored; `meta.retrieval_type` echoes the mode
+          # that actually ran. When `query` is omitted, returns a plain catalog listing of
+          # the collection's documents.
+          #
+          # **How it works:**
+          #
+          # 1. The `query` text is embedded into a 1024-dimensional vector using the
+          #    multilingual-e5-large model.
+          # 2. The embedding is compared against the collection's indexed document chunks
+          #    using semantic similarity. When `hybrid` and `keyword` execution ship, those
+          #    scores will be fused with, or replaced by, lexical BM25 matching.
+          # 3. Results are ranked by `score` (descending) and paginated via `page[number]` /
+          #    `page[size]`.
+          #
+          # **Authentication:** Requires a Telnyx API key via `Authorization: Bearer <key>`.
+          # Results are automatically scoped to your organization and cannot be overridden.
+          #
+          # **Filtering:** Use `filter[field][operator]=value` query parameters to narrow
+          # results before search. Supported operators: `eq` (default), `in`, `gte`, `gt`,
+          # `lte`, `lt`, `contains`. Metadata fields resolve to `metadata.<field>`.
+          #
+          # **Examples:**
+          #
+          # - `GET /v2/ai/knowledge/collections/my-collection/documents?query=billing+issue&top_k=10`
+          # - `GET /v2/ai/knowledge/collections/my-collection/documents?query=refund&sources=voice,message`
+          # - `GET /v2/ai/knowledge/collections/my-collection/documents?query=outage&filter[record_created_at][gte]=2026-01-01T00:00:00Z`
+          #
+          # @overload retrieve_documents(slug, filter: nil, page_number: nil, page_size: nil, query: nil, retrieval_type: nil, sources: nil, top_k: nil, request_options: {})
+          #
+          # @param slug [String] The collection's slug (unique within your organization).
+          #
+          # @param filter [Hash{Symbol=>Object}] Field filters applied before ranking, using `filter[field][operator]=value`. Sup
+          #
+          # @param page_number [Integer] Page number to return (1-based). Defaults to 1.
+          #
+          # @param page_size [Integer] Number of results per page. Defaults to 20.
+          #
+          # @param query [String] Natural-language search query. When provided, the text is matched against the co
+          #
+          # @param retrieval_type [Symbol, Telnyx::Models::AI::Knowledge::CollectionRetrieveDocumentsParams::RetrievalType] Reserved; not yet functional. A value supplied here is accepted but ignored — it
+          #
+          # @param sources [String] Comma-separated list of source types to restrict the search to. When omitted, al
+          #
+          # @param top_k [Integer] Maximum number of ranked results to consider. When omitted, the collection's con
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::AI::Knowledge::CollectionRetrieveDocumentsResponse]
+          #
+          # @see Telnyx::Models::AI::Knowledge::CollectionRetrieveDocumentsParams
+          def retrieve_documents(slug, params = {})
+            parsed, options = Telnyx::AI::Knowledge::CollectionRetrieveDocumentsParams.dump_request(params)
+            query = Telnyx::Internal::Util.encode_query_params(parsed)
+            @client.request(
+              method: :get,
+              path: ["ai/knowledge/collections/%1$s/documents", slug],
+              query: query.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+              model: Telnyx::Models::AI::Knowledge::CollectionRetrieveDocumentsResponse,
+              options: options
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Telnyx::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      class Knowledge
+        # Create and manage logical collections of your Telnyx data, tune retrieval
+        # settings, manage sources, and run collection-scoped semantic search.
+        # @return [Telnyx::Resources::AI::Knowledge::Collections]
+        attr_reader :collections
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+          @collections = Telnyx::Resources::AI::Knowledge::Collections.new(client: client)
+        end
+      end
+    end
+  end
+end

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

@@ -4,15 +4,26 @@ module Telnyx
   module Resources
     class AI
       class McpServers
-        # Create a new MCP server.
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AI::McpServerCreateParams} for more details.
         #
-        # @overload create(name:, type:, url:, allowed_tools: nil, api_key_ref: nil, request_options: {})
+        # Creates a new MCP server configuration on your account and returns the created
+        # server.
+        #
+        # @overload create(name:, type:, url:, allowed_tools: nil, api_key_ref: nil, idempotency_key: nil, request_options: {})
+        #
+        # @param name [String] Body param
+        #
+        # @param type [String] Body param
+        #
+        # @param url [String] Body param
+        #
+        # @param allowed_tools [Array<String>, nil] Body param
+        #
+        # @param api_key_ref [String, nil] Body param
+        #
+        # @param idempotency_key [String] Header param: Optional opaque, unquoted key for safely retrying the same logical
         #
-        # @param name [String]
-        # @param type [String]
-        # @param url [String]
-        # @param allowed_tools [Array<String>, nil]
-        # @param api_key_ref [String, nil]
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Models::AI::McpServer]
@@ -20,10 +31,12 @@ module Telnyx
         # @see Telnyx::Models::AI::McpServerCreateParams
         def create(params)
           parsed, options = Telnyx::AI::McpServerCreateParams.dump_request(params)
+          header_params = {idempotency_key: "idempotency-key"}
           @client.request(
             method: :post,
             path: "ai/mcp_servers",
-            body: parsed,
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
             model: Telnyx::AI::McpServer,
             options: options
           )
@@ -49,7 +62,7 @@ module Telnyx
           )
         end
 
-        # Update an existing MCP server.
+        # Updates the specified MCP server's configuration and returns the updated server.
         #
         # @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: {})
         #
@@ -85,7 +98,8 @@ module Telnyx
           )
         end
 
-        # Retrieve a list of MCP servers.
+        # Returns a paginated list of the MCP servers configured on your account, with
+        # optional filtering by type or URL.
         #
         # @overload list(page_number: nil, page_size: nil, type: nil, url: nil, request_options: {})
         #
@@ -115,7 +129,7 @@ module Telnyx
           )
         end
 
-        # Delete a specific MCP server.
+        # Permanently deletes the specified MCP server configuration from your account.
         #
         # @overload delete(mcp_server_id, request_options: {})
         #

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

@@ -25,7 +25,8 @@ module Telnyx
             )
           end
 
-          # Delete a knowledge base from a mission
+          # Detaches the specified knowledge base from the mission so its content is no
+          # longer available to agents in subsequent runs.
           #
           # @overload delete_knowledge_base(knowledge_base_id, mission_id:, request_options: {})
           #
@@ -52,7 +53,8 @@ module Telnyx
             )
           end
 
-          # Get a specific knowledge base by ID
+          # Returns the details of a single knowledge base attached to the specified
+          # mission.
           #
           # @overload get_knowledge_base(knowledge_base_id, mission_id:, request_options: {})
           #
@@ -79,7 +81,8 @@ module Telnyx
             )
           end
 
-          # List all knowledge bases for a mission
+          # Returns the knowledge bases attached to the specified mission. Knowledge bases
+          # provide reference content agents can draw on during runs.
           #
           # @overload list_knowledge_bases(mission_id, request_options: {})
           #
@@ -99,7 +102,7 @@ module Telnyx
             )
           end
 
-          # Update a knowledge base definition
+          # Replaces the definition of the specified knowledge base on this mission.
           #
           # @overload update_knowledge_base(knowledge_base_id, mission_id:, request_options: {})
           #

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

@@ -5,7 +5,8 @@ module Telnyx
     class AI
       class Missions
         class McpServers
-          # Create a new MCP server for a mission
+          # Adds an MCP server to the specified mission, making the server's tools available
+          # to agents during runs of this mission.
           #
           # @overload create_mcp_server(mission_id, request_options: {})
           #
@@ -25,7 +26,8 @@ module Telnyx
             )
           end
 
-          # Delete an MCP server from a mission
+          # Removes the specified MCP server from the mission, revoking agent access to its
+          # tools in subsequent runs.
           #
           # @overload delete_mcp_server(mcp_server_id, mission_id:, request_options: {})
           #
@@ -52,7 +54,8 @@ module Telnyx
             )
           end
 
-          # Get a specific MCP server by ID
+          # Returns the configuration of a single MCP server attached to the specified
+          # mission.
           #
           # @overload get_mcp_server(mcp_server_id, mission_id:, request_options: {})
           #
@@ -79,7 +82,8 @@ module Telnyx
             )
           end
 
-          # List all MCP servers for a mission
+          # Returns the MCP servers configured on the specified mission. MCP servers expose
+          # external tools and data sources agents can use during runs.
           #
           # @overload list_mcp_servers(mission_id, request_options: {})
           #
@@ -99,7 +103,7 @@ module Telnyx
             )
           end
 
-          # Update an MCP server definition
+          # Replaces the configuration of the specified MCP server on this mission.
           #
           # @overload update_mcp_server(mcp_server_id, mission_id:, request_options: {})
           #

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

@@ -6,7 +6,9 @@ module Telnyx
       class Missions
         class Runs
           class Events
-            # List events for a run (paginated)
+            # Returns a paginated list of events logged for the specified run, filterable by
+            # event type, plan step, and agent, so you can reconstruct exactly what happened
+            # during execution.
             #
             # @overload list(run_id, mission_id:, agent_id: nil, page_number: nil, page_size: nil, step_id: nil, type: nil, request_options: {})
             #
@@ -46,7 +48,8 @@ module Telnyx
               )
             end
 
-            # Get details of a specific event
+            # Returns the details of a single event logged for the specified run, including
+            # its type and payload.
             #
             # @overload get_event_details(event_id, mission_id:, run_id:, request_options: {})
             #
@@ -79,7 +82,8 @@ module Telnyx
               )
             end
 
-            # Log an event for a run
+            # Logs a new event against the specified run and returns the created event. Events
+            # form the run's audit trail and can reference a plan step or agent.
             #
             # @overload log(run_id, mission_id:, summary:, type:, agent_id: nil, idempotency_key: nil, payload: nil, step_id: nil, request_options: {})
             #

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

@@ -6,7 +6,9 @@ module Telnyx
       class Missions
         class Runs
           class Plan
-            # Create the initial plan for a run
+            # Creates the initial plan for the specified run from the provided steps and
+            # returns the created plan steps. Progress is subsequently reported by updating
+            # individual steps.
             #
             # @overload create(run_id, mission_id:, steps:, request_options: {})
             #
@@ -36,7 +38,9 @@ module Telnyx
               )
             end
 
-            # Get the plan (all steps) for a run
+            # Returns the plan for the specified run, including all plan steps and their
+            # statuses, so you can see how the mission was decomposed and how far execution
+            # has progressed.
             #
             # @overload retrieve(run_id, mission_id:, request_options: {})
             #
@@ -93,7 +97,8 @@ module Telnyx
               )
             end
 
-            # Get details of a specific plan step
+            # Returns the details of a single plan step within a run's plan, including its
+            # status.
             #
             # @overload get_step_details(step_id, mission_id:, run_id:, request_options: {})
             #
@@ -126,7 +131,8 @@ module Telnyx
               )
             end
 
-            # Update the status of a plan step
+            # Updates the status of a single plan step and returns the updated step. Typically
+            # called by the executing agent as it works through the plan.
             #
             # @overload update_step(step_id, mission_id:, run_id:, metadata: nil, status: nil, request_options: {})
             #

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

@@ -6,7 +6,8 @@ module Telnyx
       class Missions
         class Runs
           class TelnyxAgents
-            # List all Telnyx agents linked to a run
+            # Returns the Telnyx agents currently linked to the specified run. Linked agents
+            # participate in executing the run's plan.
             #
             # @overload list(run_id, mission_id:, request_options: {})
             #
@@ -63,7 +64,8 @@ module Telnyx
               )
             end
 
-            # Unlink a Telnyx agent from a run
+            # Unlinks the specified Telnyx agent from the run so it no longer participates in
+            # execution. The run itself and its history are unaffected.
             #
             # @overload unlink(telnyx_agent_id, mission_id:, run_id:, request_options: {})
             #

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

@@ -14,7 +14,8 @@ module Telnyx
           # @return [Telnyx::Resources::AI::Missions::Runs::TelnyxAgents]
           attr_reader :telnyx_agents
 
-          # Start a new run for a mission
+          # Starts a new run of the specified mission and returns the created run object.
+          # Track its progress through the run detail, plan, and events endpoints.
           #
           # @overload create(mission_id, input: nil, metadata: nil, request_options: {})
           #
@@ -40,7 +41,8 @@ module Telnyx
             )
           end
 
-          # Get details of a specific run
+          # Returns the full details of a single run, including its current status. Use this
+          # to poll an in-flight run or inspect the outcome of a completed one.
           #
           # @overload retrieve(run_id, mission_id:, request_options: {})
           #
@@ -67,7 +69,9 @@ module Telnyx
             )
           end
 
-          # Update run status and/or result
+          # Updates a run's status and/or result and returns the updated run object.
+          # Typically used by executing agents to report progress or record the final
+          # outcome.
           #
           # @overload update(run_id, mission_id:, error: nil, metadata: nil, result_payload: nil, result_summary: nil, status: nil, request_options: {})
           #
@@ -105,7 +109,8 @@ module Telnyx
             )
           end
 
-          # List all runs for a specific mission
+          # Returns a paginated list of runs for the specified mission, optionally filtered
+          # by run status, so you can track the mission's execution history over time.
           #
           # @overload list(mission_id, page_number: nil, page_size: nil, status: nil, request_options: {})
           #
@@ -135,7 +140,8 @@ module Telnyx
             )
           end
 
-          # Cancel a running or paused run
+          # Cancels a running or paused run and returns the updated run object. A cancelled
+          # run stops executing; start a new run to execute the mission again.
           #
           # @overload cancel_run(run_id, mission_id:, request_options: {})
           #
@@ -162,7 +168,9 @@ module Telnyx
             )
           end
 
-          # List recent runs across all missions
+          # Returns a paginated list of recent runs across every mission in your
+          # organization, optionally filtered by run status. Useful for monitoring overall
+          # mission activity without querying each mission individually.
           #
           # @overload list_runs(page_number: nil, page_size: nil, status: nil, request_options: {})
           #
@@ -190,7 +198,8 @@ module Telnyx
             )
           end
 
-          # Pause a running run
+          # Pauses a currently running run and returns the updated run object. Execution
+          # halts until the run is resumed.
           #
           # @overload pause_run(run_id, mission_id:, request_options: {})
           #
@@ -217,7 +226,8 @@ module Telnyx
             )
           end
 
-          # Resume a paused run
+          # Resumes a previously paused run and returns the updated run object, letting
+          # execution continue from where it was paused.
           #
           # @overload resume_run(run_id, mission_id:, request_options: {})
           #

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

@@ -5,7 +5,8 @@ module Telnyx
     class AI
       class Missions
         class Tools
-          # Create a new tool for a mission
+          # Adds a new tool to the specified mission, defining an action agents can invoke
+          # during runs of this mission.
           #
           # @overload create_tool(mission_id, request_options: {})
           #
@@ -25,7 +26,8 @@ module Telnyx
             )
           end
 
-          # Delete a tool from a mission
+          # Removes the specified tool from the mission so agents can no longer invoke it in
+          # subsequent runs.
           #
           # @overload delete_tool(tool_id, mission_id:, request_options: {})
           #
@@ -52,7 +54,7 @@ module Telnyx
             )
           end
 
-          # Get a specific tool by ID
+          # Returns the definition of a single tool configured on the specified mission.
           #
           # @overload get_tool(tool_id, mission_id:, request_options: {})
           #
@@ -79,7 +81,8 @@ module Telnyx
             )
           end
 
-          # List all tools for a mission
+          # Returns the tools configured on the specified mission. Tools define the actions
+          # agents may invoke while executing the mission's runs.
           #
           # @overload list_tools(mission_id, request_options: {})
           #
@@ -99,7 +102,7 @@ module Telnyx
             )
           end
 
-          # Update a tool definition
+          # Replaces the definition of the specified tool on this mission.
           #
           # @overload update_tool(tool_id, mission_id:, request_options: {})
           #