telnyx 5.159.0 → 5.161.0

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

@@ -88,7 +88,7 @@ module Telnyx
         #
         # @param tool_ids [Array<String>] IDs of shared tools to attach to the assistant. New integrations should prefer `
         #
-        # @param tools [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay>] Deprecated for new integrations. Inline tool definitions available to the assist
+        # @param tools [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] Deprecated for new integrations. Inline tool definitions available to the assist
         #
         # @param transcription [Telnyx::Models::AI::TranscriptionSettings]
         #
@@ -202,7 +202,7 @@ module Telnyx
         #
         # @param tool_ids [Array<String>] IDs of shared tools to attach to the assistant. New integrations should prefer `
         #
-        # @param tools [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay>] Deprecated for new integrations. Inline tool definitions available to the assist
+        # @param tools [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] Deprecated for new integrations. Inline tool definitions available to the assist
         #
         # @param transcription [Telnyx::Models::AI::TranscriptionSettings]
         #

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

@@ -8,7 +8,7 @@ module Telnyx
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::AI::ClusterRetrieveParams} for more details.
         #
-        # Fetch a cluster
+        # Fetch the results of a clustering task, including the discovered clusters.
         #
         # @overload retrieve(task_id, show_subclusters: nil, top_n_nodes: nil, request_options: {})
         #
@@ -35,7 +35,7 @@ module Telnyx
           )
         end
 
-        # List all clusters
+        # Retrieve a paginated list of clustering tasks and their statuses.
         #
         # @overload list(page_number: nil, page_size: nil, request_options: {})
         #
@@ -59,7 +59,7 @@ module Telnyx
           )
         end
 
-        # Delete a cluster
+        # Delete a clustering task and its computed results.
         #
         # @overload delete(task_id, request_options: {})
         #
@@ -114,7 +114,7 @@ module Telnyx
           )
         end
 
-        # Fetch a cluster visualization
+        # Fetch a visualization image of the clusters computed by a clustering task.
         #
         # @overload fetch_graph(task_id, cluster_id: nil, request_options: {})
         #

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

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      class Collections
+        # Create and manage logical collections of your Telnyx data, tune retrieval
+        # settings, manage sources, and run collection-scoped semantic search.
+        class Settings
+          # Replaces the collection's retrieval settings.
+          #
+          # @overload create(uuid, retrieval: nil, request_options: {})
+          #
+          # @param uuid [String] The collection's unique identifier.
+          #
+          # @param retrieval [Telnyx::Models::AI::Collections::RetrievalSettings] How documents are retrieved when searching the collection.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::AI::Collections::SettingsEnvelope]
+          #
+          # @see Telnyx::Models::AI::Collections::SettingCreateParams
+          def create(uuid, params = {})
+            parsed, options = Telnyx::AI::Collections::SettingCreateParams.dump_request(params)
+            @client.request(
+              method: :put,
+              path: ["ai/collections/%1$s/settings", uuid],
+              body: parsed,
+              model: Telnyx::AI::Collections::SettingsEnvelope,
+              options: options
+            )
+          end
+
+          # Returns the retrieval settings for a collection.
+          #
+          # @overload list(uuid, request_options: {})
+          #
+          # @param uuid [String] The collection's unique identifier.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::AI::Collections::SettingsEnvelope]
+          #
+          # @see Telnyx::Models::AI::Collections::SettingListParams
+          def list(uuid, params = {})
+            @client.request(
+              method: :get,
+              path: ["ai/collections/%1$s/settings", uuid],
+              model: Telnyx::AI::Collections::SettingsEnvelope,
+              options: params[:request_options]
+            )
+          end
+
+          # Partially updates the collection's retrieval settings.
+          #
+          # @overload patch_all(uuid, retrieval: nil, request_options: {})
+          #
+          # @param uuid [String] The collection's unique identifier.
+          #
+          # @param retrieval [Telnyx::Models::AI::Collections::RetrievalSettings] How documents are retrieved when searching the collection.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::AI::Collections::SettingsEnvelope]
+          #
+          # @see Telnyx::Models::AI::Collections::SettingPatchAllParams
+          def patch_all(uuid, params = {})
+            parsed, options = Telnyx::AI::Collections::SettingPatchAllParams.dump_request(params)
+            @client.request(
+              method: :patch,
+              path: ["ai/collections/%1$s/settings", uuid],
+              body: parsed,
+              model: Telnyx::AI::Collections::SettingsEnvelope,
+              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/collections/sources.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      class Collections
+        # Create and manage logical collections of your Telnyx data, tune retrieval
+        # settings, manage sources, and run collection-scoped semantic search.
+        class Sources
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::AI::Collections::SourceCreateParams} for more details.
+          #
+          # Attaches a new source to a collection.
+          #
+          # @overload create(uuid, source_type:, bucket_id: nil, request_options: {})
+          #
+          # @param uuid [String] The collection's unique identifier.
+          #
+          # @param source_type [Symbol, Telnyx::Models::AI::Collections::SourceType] The type of Telnyx data attached as a source. `bucket` requires an additional `b
+          #
+          # @param bucket_id [String] The Telnyx Storage bucket name. Required when `source_type` is `bucket`; ignored
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::AI::Collections::SourceCreateResponse]
+          #
+          # @see Telnyx::Models::AI::Collections::SourceCreateParams
+          def create(uuid, params)
+            parsed, options = Telnyx::AI::Collections::SourceCreateParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: ["ai/collections/%1$s/sources", uuid],
+              body: parsed,
+              model: Telnyx::Models::AI::Collections::SourceCreateResponse,
+              options: options
+            )
+          end
+
+          # Returns the sources attached to a collection.
+          #
+          # @overload list(uuid, request_options: {})
+          #
+          # @param uuid [String] The collection's unique identifier.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::AI::Collections::SourceListResponse]
+          #
+          # @see Telnyx::Models::AI::Collections::SourceListParams
+          def list(uuid, params = {})
+            @client.request(
+              method: :get,
+              path: ["ai/collections/%1$s/sources", uuid],
+              model: Telnyx::Models::AI::Collections::SourceListResponse,
+              options: params[:request_options]
+            )
+          end
+
+          # Removes a single source from a collection.
+          #
+          # @overload delete(source_id, uuid:, request_options: {})
+          #
+          # @param source_id [String] The identifier of the source to remove.
+          #
+          # @param uuid [String] The collection's unique identifier.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [nil]
+          #
+          # @see Telnyx::Models::AI::Collections::SourceDeleteParams
+          def delete(source_id, params)
+            parsed, options = Telnyx::AI::Collections::SourceDeleteParams.dump_request(params)
+            uuid =
+              parsed.delete(:uuid) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+            @client.request(
+              method: :delete,
+              path: ["ai/collections/%1$s/sources/%2$s", uuid, source_id],
+              model: NilClass,
+              options: options
+            )
+          end
+
+          # Replaces the collection's entire source set. The response `meta` reports which
+          # sources were added, retained, and removed.
+          #
+          # @overload replace(uuid, sources:, request_options: {})
+          #
+          # @param uuid [String] The collection's unique identifier.
+          #
+          # @param sources [Array<Telnyx::Models::AI::Collections::SourceRequest>]
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::AI::Collections::SourceReplaceResponse]
+          #
+          # @see Telnyx::Models::AI::Collections::SourceReplaceParams
+          def replace(uuid, params)
+            parsed, options = Telnyx::AI::Collections::SourceReplaceParams.dump_request(params)
+            @client.request(
+              method: :put,
+              path: ["ai/collections/%1$s/sources", uuid],
+              body: parsed,
+              model: Telnyx::Models::AI::Collections::SourceReplaceResponse,
+              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/collections.rb

@@ -0,0 +1,244 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      # Create and manage logical collections of your Telnyx data, tune retrieval
+      # settings, manage sources, and run collection-scoped semantic search.
+      class Collections
+        # Create and manage logical collections of your Telnyx data, tune retrieval
+        # settings, manage sources, and run collection-scoped semantic search.
+        # @return [Telnyx::Resources::AI::Collections::Settings]
+        attr_reader :settings
+
+        # Create and manage logical collections of your Telnyx data, tune retrieval
+        # settings, manage sources, and run collection-scoped semantic search.
+        # @return [Telnyx::Resources::AI::Collections::Sources]
+        attr_reader :sources
+
+        # Creates a new collection scoped to your organization. Optionally attach sources
+        # and retrieval settings at creation time. If `slug` is omitted, one is derived
+        # from `name` and must be unique within your organization.
+        #
+        # @overload create(name:, description: nil, settings: nil, slug: nil, sources: nil, request_options: {})
+        #
+        # @param name [String] Human-readable collection name.
+        #
+        # @param description [String] Optional description.
+        #
+        # @param settings [Telnyx::Models::AI::Collections::RetrievalSettingsWrapper] Optional retrieval settings.
+        #
+        # @param slug [String] Optional slug (unique per organization). Derived from `name` when omitted.
+        #
+        # @param sources [Array<Telnyx::Models::AI::Collections::SourceRequest>] Optional sources to attach at creation time.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AI::CollectionEnvelope]
+        #
+        # @see Telnyx::Models::AI::CollectionCreateParams
+        def create(params)
+          parsed, options = Telnyx::AI::CollectionCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "ai/collections",
+            body: parsed,
+            model: Telnyx::AI::CollectionEnvelope,
+            options: options
+          )
+        end
+
+        # Fetches a single collection by its `slug`.
+        #
+        # @overload retrieve(slug, request_options: {})
+        #
+        # @param slug [String] The collection's slug (unique within your organization).
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AI::CollectionEnvelope]
+        #
+        # @see Telnyx::Models::AI::CollectionRetrieveParams
+        def retrieve(slug, params = {})
+          @client.request(
+            method: :get,
+            path: ["ai/collections/slug/%1$s", slug],
+            model: Telnyx::AI::CollectionEnvelope,
+            options: params[:request_options]
+          )
+        end
+
+        # Updates a collection's metadata (`name` and/or `description`). Sources and
+        # settings are managed through their own sub-resources.
+        #
+        # @overload update(uuid, description: nil, name: nil, request_options: {})
+        #
+        # @param uuid [String] The collection's unique identifier.
+        #
+        # @param description [String]
+        #
+        # @param name [String]
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AI::CollectionEnvelope]
+        #
+        # @see Telnyx::Models::AI::CollectionUpdateParams
+        def update(uuid, params = {})
+          parsed, options = Telnyx::AI::CollectionUpdateParams.dump_request(params)
+          @client.request(
+            method: :patch,
+            path: ["ai/collections/%1$s", uuid],
+            body: parsed,
+            model: Telnyx::AI::CollectionEnvelope,
+            options: options
+          )
+        end
+
+        # Returns a paginated list of collections in your organization.
+        #
+        # @overload list(page_number: nil, page_size: nil, request_options: {})
+        #
+        # @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 request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::AI::Collection>]
+        #
+        # @see Telnyx::Models::AI::CollectionListParams
+        def list(params = {})
+          parsed, options = Telnyx::AI::CollectionListParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: "ai/collections",
+            query: query.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+            page: Telnyx::Internal::DefaultFlatPagination,
+            model: Telnyx::AI::Collection,
+            options: options
+          )
+        end
+
+        # Soft-deletes a collection. Its `slug` is freed and may be reused by a new
+        # collection.
+        #
+        # @overload delete(uuid, request_options: {})
+        #
+        # @param uuid [String] The collection's unique identifier.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [nil]
+        #
+        # @see Telnyx::Models::AI::CollectionDeleteParams
+        def delete(uuid, params = {})
+          @client.request(
+            method: :delete,
+            path: ["ai/collections/%1$s", uuid],
+            model: NilClass,
+            options: params[:request_options]
+          )
+        end
+
+        # Fetches a single collection by its `uuid`.
+        #
+        # @overload retrieve_by_id(uuid, request_options: {})
+        #
+        # @param uuid [String] The collection's unique identifier.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AI::CollectionEnvelope]
+        #
+        # @see Telnyx::Models::AI::CollectionRetrieveByIDParams
+        def retrieve_by_id(uuid, params = {})
+          @client.request(
+            method: :get,
+            path: ["ai/collections/%1$s", uuid],
+            model: Telnyx::AI::CollectionEnvelope,
+            options: params[:request_options]
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AI::CollectionRetrieveDocumentsParams} for more details.
+        #
+        # Runs search over the documents in a collection, ranked by relevance to `query`.
+        # The collection's `retrieval_type` setting selects the strategy: `vector`
+        # (semantic similarity), `hybrid` (vector similarity fused with keyword matching),
+        # or `keyword` (lexical BM25 matching). When `query` is omitted, returns a plain
+        # catalog listing of the collection's documents.
+        #
+        # **How it works:**
+        #
+        # 1. For `vector` and `hybrid`, the `query` text is embedded into a
+        #    1024-dimensional vector using the multilingual-e5-large model.
+        # 2. For `vector`, the embedding is compared against the collection's indexed
+        #    document chunks using semantic similarity; for `hybrid`, those similarity
+        #    scores are fused with keyword-match scores; for `keyword`, only lexical BM25
+        #    matching is applied.
+        # 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/collections/my-collection/documents?query=billing+issue&top_k=10`
+        # - `GET /v2/ai/collections/my-collection/documents?query=refund&sources=voice,message`
+        # - `GET /v2/ai/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::CollectionRetrieveDocumentsParams::RetrievalType] Override the collection's configured retrieval strategy for this request. Echoed
+        #
+        # @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::CollectionRetrieveDocumentsResponse]
+        #
+        # @see Telnyx::Models::AI::CollectionRetrieveDocumentsParams
+        def retrieve_documents(slug, params = {})
+          parsed, options = Telnyx::AI::CollectionRetrieveDocumentsParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: ["ai/collections/%1$s/documents", slug],
+            query: query.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+            model: Telnyx::Models::AI::CollectionRetrieveDocumentsResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+          @settings = Telnyx::Resources::AI::Collections::Settings.new(client: client)
+          @sources = Telnyx::Resources::AI::Collections::Sources.new(client: client)
+        end
+      end
+    end
+  end
+end

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

@@ -5,20 +5,32 @@ module Telnyx
     class AI
       # Configure AI assistant specifications
       class Tools
-        # Create Tool
+        # Create a new custom AI tool that can be attached to AI assistants.
         #
-        # @overload create(display_name:, type:, client_side_tool: nil, function: nil, handoff: nil, invite: nil, pay: nil, retrieval: nil, timeout_ms: nil, webhook: nil, request_options: {})
+        # @overload create(display_name:, type:, client_side_tool: nil, function: nil, handoff: nil, invite: nil, pay: nil, retrieval: nil, timeout_ms: nil, update_dynamic_variables: nil, webhook: nil, request_options: {})
         #
         # @param display_name [String]
+        #
         # @param type [String]
+        #
         # @param client_side_tool [Hash{Symbol=>Object}]
+        #
         # @param function [Hash{Symbol=>Object}]
+        #
         # @param handoff [Hash{Symbol=>Object}]
+        #
         # @param invite [Hash{Symbol=>Object}]
+        #
         # @param pay [Telnyx::Models::AI::PayToolParams]
+        #
         # @param retrieval [Hash{Symbol=>Object}]
+        #
         # @param timeout_ms [Integer]
+        #
+        # @param update_dynamic_variables [Telnyx::Models::AI::UpdateDynamicVariablesToolParams] Configuration for an update_dynamic_variables tool.
+        #
         # @param webhook [Hash{Symbol=>Object}]
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Models::AI::SharedToolResponse]
@@ -35,7 +47,7 @@ module Telnyx
           )
         end
 
-        # Get Tool
+        # Retrieve the details of a specific AI tool.
         #
         # @overload retrieve(tool_id, request_options: {})
         #
@@ -55,9 +67,9 @@ module Telnyx
           )
         end
 
-        # Update Tool
+        # Update the configuration of an existing AI tool.
         #
-        # @overload update(tool_id, client_side_tool: nil, display_name: nil, function: nil, handoff: nil, invite: nil, pay: nil, retrieval: nil, timeout_ms: nil, type: nil, webhook: nil, request_options: {})
+        # @overload update(tool_id, client_side_tool: nil, display_name: nil, function: nil, handoff: nil, invite: nil, pay: nil, retrieval: nil, timeout_ms: nil, type: nil, update_dynamic_variables: nil, webhook: nil, request_options: {})
         #
         # @param tool_id [String] Unique identifier of the tool.
         #
@@ -79,6 +91,8 @@ module Telnyx
         #
         # @param type [String]
         #
+        # @param update_dynamic_variables [Telnyx::Models::AI::UpdateDynamicVariablesToolParams] Configuration for an update_dynamic_variables tool.
+        #
         # @param webhook [Hash{Symbol=>Object}]
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -97,7 +111,7 @@ module Telnyx
           )
         end
 
-        # List Tools
+        # Retrieve a list of the custom AI tools configured on your account.
         #
         # @overload list(filter_name: nil, filter_type: nil, page_number: nil, page_size: nil, request_options: {})
         #
@@ -132,7 +146,7 @@ module Telnyx
           )
         end
 
-        # Delete Tool
+        # Delete a custom AI tool.
         #
         # @overload delete(tool_id, request_options: {})
         #

data/lib/telnyx/resources/ai.rb

@@ -17,6 +17,11 @@ module Telnyx
       # @return [Telnyx::Resources::AI::Clusters]
       attr_reader :clusters
 
+      # Create and manage logical collections of your Telnyx data, tune retrieval
+      # settings, manage sources, and run collection-scoped semantic search.
+      # @return [Telnyx::Resources::AI::Collections]
+      attr_reader :collections
+
       # Manage historical AI assistant conversations
       # @return [Telnyx::Resources::AI::Conversations]
       attr_reader :conversations
@@ -94,13 +99,11 @@ module Telnyx
       #
       # **Examples:**
       #
-      # ```
-      # GET /v2/ai/conversation_histories?q=billing+issue&page[size]=10
-      # GET /v2/ai/conversation_histories?q=setup+guide&region=USA&min_score=0.5
-      # GET /v2/ai/conversation_histories?q=refund&filter[record_created_at][gte]=2026-01-01T00:00:00Z
-      # GET /v2/ai/conversation_histories?q=outage&filter[region][in]=USA,DEU
-      # GET /v2/ai/conversation_histories?q=hold+time&filter[language]=en
-      # ```
+      # - `GET /v2/ai/conversation_histories?q=billing+issue&page[size]=10`
+      # - `GET /v2/ai/conversation_histories?q=setup+guide&region=USA&min_score=0.5`
+      # - `GET /v2/ai/conversation_histories?q=refund&filter[record_created_at][gte]=2026-01-01T00:00:00Z`
+      # - `GET /v2/ai/conversation_histories?q=outage&filter[region][in]=USA,DEU`
+      # - `GET /v2/ai/conversation_histories?q=hold+time&filter[language]=en`
       #
       # @overload retrieve_conversation_histories(q:, filter_ingested_at_gte: nil, filter_ingested_at_lte: nil, filter_record_created_at_gte: nil, filter_record_created_at_lte: nil, filter_record_id: nil, filter_region_in: nil, filter_retention: nil, filter_user_id: nil, min_score: nil, page_number: nil, page_size: nil, region: nil, request_options: {})
       #
@@ -203,6 +206,7 @@ module Telnyx
         @audio = Telnyx::Resources::AI::Audio.new(client: client)
         @chat = Telnyx::Resources::AI::Chat.new(client: client)
         @clusters = Telnyx::Resources::AI::Clusters.new(client: client)
+        @collections = Telnyx::Resources::AI::Collections.new(client: client)
         @conversations = Telnyx::Resources::AI::Conversations.new(client: client)
         @embeddings = Telnyx::Resources::AI::Embeddings.new(client: client)
         @fine_tuning = Telnyx::Resources::AI::FineTuning.new(client: client)

data/lib/telnyx/resources/available_phone_number_blocks.rb

@@ -7,7 +7,9 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::AvailablePhoneNumberBlockListParams} for more details.
       #
-      # List available phone number blocks
+      # Searches the Telnyx inventory for available contiguous phone-number blocks.
+      # Results can be filtered by locality, country, national destination code, and
+      # number type.
       #
       # @overload list(filter: nil, request_options: {})
       #

data/lib/telnyx/resources/available_phone_numbers.rb

@@ -7,7 +7,10 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::AvailablePhoneNumberListParams} for more details.
       #
-      # List available phone numbers
+      # Searches the Telnyx inventory for available phone numbers. Filters support
+      # number patterns, location, number type, features, reservability, and other
+      # inventory constraints; the response includes matching numbers and search
+      # metadata.
       #
       # @overload list(filter: nil, request_options: {})
       #

data/lib/telnyx/resources/balance.rb

@@ -4,7 +4,8 @@ module Telnyx
   module Resources
     # Billing operations
     class Balance
-      # Get user balance details
+      # Retrieve the current balance, available credit, and credit limit for your
+      # account.
       #
       # @overload retrieve(request_options: {})
       #