telnyx 5.156.0 → 5.157.0

data/lib/telnyx/models/storage/cloudfs_filesystem_detail_response_wrapper.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Storage
+      # @see Telnyx::Resources::Storage::Cloudfs#retrieve
+      class CloudfsFilesystemDetailResponseWrapper < Telnyx::Internal::Type::BaseModel
+        # @!attribute data
+        #   A CloudFS filesystem as returned by get, update, and delete. `meta_url` omits
+        #   the credential and there is no `meta_token` field — the token is only returned
+        #   by create and rotate-meta-token.
+        #
+        #   @return [Telnyx::Models::Storage::CloudfsFilesystemDetailResponseWrapper::Data, nil]
+        optional :data, -> { Telnyx::Storage::CloudfsFilesystemDetailResponseWrapper::Data }
+
+        # @!method initialize(data: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::Storage::CloudfsFilesystemDetailResponseWrapper} for more
+        #   details.
+        #
+        #   @param data [Telnyx::Models::Storage::CloudfsFilesystemDetailResponseWrapper::Data] A CloudFS filesystem as returned by get, update, and delete. `meta_url` omits th
+
+        # @see Telnyx::Models::Storage::CloudfsFilesystemDetailResponseWrapper#data
+        class Data < Telnyx::Internal::Type::BaseModel
+          # @!attribute id
+          #
+          #   @return [String, nil]
+          optional :id, String
+
+          # @!attribute created_at
+          #
+          #   @return [Time, nil]
+          optional :created_at, Time
+
+          # @!attribute error
+          #   Explanation of the most recent failed lifecycle action. Present only when the
+          #   filesystem is in a `failed` state.
+          #
+          #   @return [String, nil]
+          optional :error, String
+
+          # @!attribute meta_url
+          #   PostgreSQL connection URL for the filesystem's metadata database, without the
+          #   credential. Combine it with your stored metadata token, or issue a new token
+          #   with rotate-meta-token.
+          #
+          #   @return [String, nil]
+          optional :meta_url, String
+
+          # @!attribute name
+          #
+          #   @return [String, nil]
+          optional :name, String
+
+          # @!attribute record_type
+          #
+          #   @return [String, nil]
+          optional :record_type, String
+
+          # @!attribute region
+          #
+          #   @return [String, nil]
+          optional :region, String
+
+          # @!attribute s3_bucket
+          #   Name of the bucket that stores this filesystem's data. Created during
+          #   provisioning.
+          #
+          #   @return [String, nil]
+          optional :s3_bucket, String
+
+          # @!attribute s3_endpoint
+          #   URL of the Telnyx Cloud Storage endpoint backing this filesystem.
+          #
+          #   @return [String, nil]
+          optional :s3_endpoint, String
+
+          # @!attribute status
+          #   Lifecycle status of the filesystem. `ready` means it is fully provisioned and
+          #   usable. `needs_format` means the storage bucket and metadata database were
+          #   provisioned but the filesystem has not yet been formatted — run `juicefs format`
+          #   with the filesystem's `meta_url` before mounting. `failed` means the last
+          #   lifecycle action failed — see the filesystem's `error` message. `deleted`
+          #   appears only in the delete response: deleted filesystems are excluded from list
+          #   results and return a `404` on retrieval.
+          #
+          #   @return [Symbol, Telnyx::Models::Storage::CloudfsFilesystemStatus, nil]
+          optional :status, enum: -> { Telnyx::Storage::CloudfsFilesystemStatus }
+
+          # @!attribute updated_at
+          #
+          #   @return [Time, nil]
+          optional :updated_at, Time
+
+          # @!method initialize(id: nil, created_at: nil, error: nil, meta_url: nil, name: nil, record_type: nil, region: nil, s3_bucket: nil, s3_endpoint: nil, status: nil, updated_at: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::Storage::CloudfsFilesystemDetailResponseWrapper::Data} for more
+          #   details.
+          #
+          #   A CloudFS filesystem as returned by get, update, and delete. `meta_url` omits
+          #   the credential and there is no `meta_token` field — the token is only returned
+          #   by create and rotate-meta-token.
+          #
+          #   @param id [String]
+          #
+          #   @param created_at [Time]
+          #
+          #   @param error [String] Explanation of the most recent failed lifecycle action. Present only when the fi
+          #
+          #   @param meta_url [String] PostgreSQL connection URL for the filesystem's metadata database, without the cr
+          #
+          #   @param name [String]
+          #
+          #   @param record_type [String]
+          #
+          #   @param region [String]
+          #
+          #   @param s3_bucket [String] Name of the bucket that stores this filesystem's data. Created during provisioni
+          #
+          #   @param s3_endpoint [String] URL of the Telnyx Cloud Storage endpoint backing this filesystem.
+          #
+          #   @param status [Symbol, Telnyx::Models::Storage::CloudfsFilesystemStatus] Lifecycle status of the filesystem. `ready` means it is fully provisioned and us
+          #
+          #   @param updated_at [Time]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/storage/cloudfs_filesystem_response_wrapper.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Storage
+      # @see Telnyx::Resources::Storage::Cloudfs#create
+      class CloudfsFilesystemResponseWrapper < Telnyx::Internal::Type::BaseModel
+        # @!attribute data
+        #   A CloudFS filesystem, including its metadata credential. This shape is returned
+        #   only by create and rotate-meta-token.
+        #
+        #   @return [Telnyx::Models::Storage::CloudfsFilesystemResponseWrapper::Data, nil]
+        optional :data, -> { Telnyx::Storage::CloudfsFilesystemResponseWrapper::Data }
+
+        # @!method initialize(data: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::Storage::CloudfsFilesystemResponseWrapper} for more details.
+        #
+        #   @param data [Telnyx::Models::Storage::CloudfsFilesystemResponseWrapper::Data] A CloudFS filesystem, including its metadata credential. This shape is returned
+
+        # @see Telnyx::Models::Storage::CloudfsFilesystemResponseWrapper#data
+        class Data < Telnyx::Internal::Type::BaseModel
+          # @!attribute id
+          #
+          #   @return [String, nil]
+          optional :id, String
+
+          # @!attribute created_at
+          #
+          #   @return [Time, nil]
+          optional :created_at, Time
+
+          # @!attribute meta_token
+          #   Metadata access token, in cleartext. Returned only by create and
+          #   rotate-meta-token and not retrievable afterwards — store it securely.
+          #
+          #   @return [String, nil]
+          optional :meta_token, String
+
+          # @!attribute meta_url
+          #   PostgreSQL connection URL for the filesystem's metadata database. In create and
+          #   rotate-meta-token responses it embeds the metadata token as the password:
+          #   `postgres://<database>:<meta_token>@us-east-1.telnyxcloudfs.com:5432/<database>?sslmode=require`
+          #   (the example below is shown without the credential; the actual response includes
+          #   it). Pass it to `juicefs mount`: the storage configuration is baked in at
+          #   provisioning, so the metadata URL is all a client needs to mount the filesystem.
+          #
+          #   @return [String, nil]
+          optional :meta_url, String
+
+          # @!attribute name
+          #
+          #   @return [String, nil]
+          optional :name, String
+
+          # @!attribute record_type
+          #
+          #   @return [String, nil]
+          optional :record_type, String
+
+          # @!attribute region
+          #
+          #   @return [String, nil]
+          optional :region, String
+
+          # @!attribute s3_bucket
+          #   Name of the bucket that stores this filesystem's data. Created during
+          #   provisioning.
+          #
+          #   @return [String, nil]
+          optional :s3_bucket, String
+
+          # @!attribute s3_endpoint
+          #   URL of the Telnyx Cloud Storage endpoint backing this filesystem.
+          #
+          #   @return [String, nil]
+          optional :s3_endpoint, String
+
+          # @!attribute status
+          #   Lifecycle status of the filesystem. `ready` means it is fully provisioned and
+          #   usable. `needs_format` means the storage bucket and metadata database were
+          #   provisioned but the filesystem has not yet been formatted — run `juicefs format`
+          #   with the filesystem's `meta_url` before mounting. `failed` means the last
+          #   lifecycle action failed — see the filesystem's `error` message. `deleted`
+          #   appears only in the delete response: deleted filesystems are excluded from list
+          #   results and return a `404` on retrieval.
+          #
+          #   @return [Symbol, Telnyx::Models::Storage::CloudfsFilesystemStatus, nil]
+          optional :status, enum: -> { Telnyx::Storage::CloudfsFilesystemStatus }
+
+          # @!attribute updated_at
+          #
+          #   @return [Time, nil]
+          optional :updated_at, Time
+
+          # @!method initialize(id: nil, created_at: nil, meta_token: nil, meta_url: nil, name: nil, record_type: nil, region: nil, s3_bucket: nil, s3_endpoint: nil, status: nil, updated_at: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::Storage::CloudfsFilesystemResponseWrapper::Data} for more
+          #   details.
+          #
+          #   A CloudFS filesystem, including its metadata credential. This shape is returned
+          #   only by create and rotate-meta-token.
+          #
+          #   @param id [String]
+          #
+          #   @param created_at [Time]
+          #
+          #   @param meta_token [String] Metadata access token, in cleartext. Returned only by create and rotate-meta-tok
+          #
+          #   @param meta_url [String] PostgreSQL connection URL for the filesystem's metadata database. In create and
+          #
+          #   @param name [String]
+          #
+          #   @param record_type [String]
+          #
+          #   @param region [String]
+          #
+          #   @param s3_bucket [String] Name of the bucket that stores this filesystem's data. Created during provisioni
+          #
+          #   @param s3_endpoint [String] URL of the Telnyx Cloud Storage endpoint backing this filesystem.
+          #
+          #   @param status [Symbol, Telnyx::Models::Storage::CloudfsFilesystemStatus] Lifecycle status of the filesystem. `ready` means it is fully provisioned and us
+          #
+          #   @param updated_at [Time]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/storage/cloudfs_filesystem_status.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Storage
+      # Lifecycle status of the filesystem. `ready` means it is fully provisioned and
+      # usable. `needs_format` means the storage bucket and metadata database were
+      # provisioned but the filesystem has not yet been formatted — run `juicefs format`
+      # with the filesystem's `meta_url` before mounting. `failed` means the last
+      # lifecycle action failed — see the filesystem's `error` message. `deleted`
+      # appears only in the delete response: deleted filesystems are excluded from list
+      # results and return a `404` on retrieval.
+      module CloudfsFilesystemStatus
+        extend Telnyx::Internal::Type::Enum
+
+        PROVISIONING = :provisioning
+        READY = :ready
+        NEEDS_FORMAT = :needs_format
+        DELETING = :deleting
+        FAILED = :failed
+        DELETED = :deleted
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/telnyx/models/verify_profile.rb

@@ -301,7 +301,7 @@ module Telnyx
         optional :sender_phone_number, String, nil?: true
 
         # @!attribute template_id
-        #   Customer pre-approved authentication template name registered on Meta
+        #   Customer pre-approved authentication template ID registered on Meta
         #
         #   @return [String, nil]
         optional :template_id, String, nil?: true
@@ -336,7 +336,7 @@ module Telnyx
         #
         #   @param sender_phone_number [String, nil] Phone number registered on the customer WABA to send OTPs from
         #
-        #   @param template_id [String, nil] Customer pre-approved authentication template name registered on Meta
+        #   @param template_id [String, nil] Customer pre-approved authentication template ID registered on Meta
         #
         #   @param waba_id [String, nil] Customer Meta WABA ID for Bring-Your-Own-WABA sending
         #

data/lib/telnyx/models/verify_profile_create_params.rb

@@ -254,7 +254,7 @@ module Telnyx
         optional :sender_phone_number, String, nil?: true
 
         # @!attribute template_id
-        #   Customer pre-approved authentication template name registered on Meta
+        #   Customer pre-approved authentication template ID registered on Meta
         #
         #   @return [String, nil]
         optional :template_id, String, nil?: true
@@ -283,7 +283,7 @@ module Telnyx
         #
         #   @param sender_phone_number [String, nil] Phone number registered on the customer WABA to send OTPs from
         #
-        #   @param template_id [String, nil] Customer pre-approved authentication template name registered on Meta
+        #   @param template_id [String, nil] Customer pre-approved authentication template ID registered on Meta
         #
         #   @param waba_id [String, nil] Customer Meta WABA ID for Bring-Your-Own-WABA sending
         #

data/lib/telnyx/models/verify_profile_update_params.rb

@@ -216,7 +216,7 @@ module Telnyx
         optional :sender_phone_number, String, nil?: true
 
         # @!attribute template_id
-        #   Customer pre-approved authentication template name registered on Meta
+        #   Customer pre-approved authentication template ID registered on Meta
         #
         #   @return [String, nil]
         optional :template_id, String, nil?: true
@@ -245,7 +245,7 @@ module Telnyx
         #
         #   @param sender_phone_number [String, nil] Phone number registered on the customer WABA to send OTPs from
         #
-        #   @param template_id [String, nil] Customer pre-approved authentication template name registered on Meta
+        #   @param template_id [String, nil] Customer pre-approved authentication template ID registered on Meta
         #
         #   @param waba_id [String, nil] Customer Meta WABA ID for Bring-Your-Own-WABA sending
         #

data/lib/telnyx/resources/ai/anthropic/v1.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      class Anthropic
+        class V1
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::AI::Anthropic::V1MessagesParams} for more details.
+          #
+          # Send a message to a language model using the Anthropic Messages API format. This
+          # endpoint is compatible with the
+          # [Anthropic Messages API](https://docs.anthropic.com/en/api/messages) and may be
+          # used with the Anthropic JS or Python SDK by setting the base URL to
+          # `https://api.telnyx.com/v2/ai/anthropic`.
+          #
+          # The endpoint translates Anthropic-format requests into Telnyx's inference
+          # internals, then translates the response back to the Anthropic message shape.
+          # Streaming responses use Anthropic SSE event types (`message_start`,
+          # `content_block_start`, `content_block_delta`, `content_block_stop`,
+          # `message_delta`, `message_stop`).
+          #
+          # @overload messages(max_tokens:, messages:, model:, api_key_ref: nil, billing_group_id: nil, fallback_config: nil, max_retries: nil, mcp_servers: nil, metadata: nil, service_tier: nil, stop_sequences: nil, stream: nil, system_: nil, temperature: nil, thinking: nil, timeout: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, request_options: {})
+          #
+          # @param max_tokens [Integer] The maximum number of tokens to generate in the response.
+          #
+          # @param messages [Array<Hash{Symbol=>Object}>] The messages to send to the model, following the [Anthropic Messages API](https:
+          #
+          # @param model [String] The model to use for generating the response, for example `zai-org/GLM-5.2` or a
+          #
+          # @param api_key_ref [String] If you are using an external inference provider, this field allows you to pass a
+          #
+          # @param billing_group_id [String] The billing group ID to associate with this request.
+          #
+          # @param fallback_config [Hash{Symbol=>Object}] Configuration for model fallback behavior when the primary model is unavailable.
+          #
+          # @param max_retries [Integer] Maximum number of retries for the request.
+          #
+          # @param mcp_servers [Array<Hash{Symbol=>Object}>] List of MCP (Model Context Protocol) servers to make available to the model.
+          #
+          # @param metadata [Hash{Symbol=>Object}] An object describing metadata about the request.
+          #
+          # @param service_tier [String] Service tier for the request.
+          #
+          # @param stop_sequences [Array<String>] Custom sequences that will cause the model to stop generating.
+          #
+          # @param stream [Boolean] Whether to stream the response as Anthropic-format Server-Sent Events.
+          #
+          # @param system_ [String, Array<Hash{Symbol=>Object}>] System prompt. Can be a string or an array of content blocks following the Anthr
+          #
+          # @param temperature [Float] Amount of randomness injected into the response. Ranges from 0 to 1.
+          #
+          # @param thinking [Hash{Symbol=>Object}] Extended thinking configuration for models that support it. Set `type` to `enabl
+          #
+          # @param timeout [Float] Request timeout in seconds.
+          #
+          # @param tool_choice [Hash{Symbol=>Object}] Controls how the model uses tools, following the Anthropic API format.
+          #
+          # @param tools [Array<Hash{Symbol=>Object}>] Definitions of tools that the model may use, following the Anthropic API format.
+          #
+          # @param top_k [Integer] Top-k sampling parameter. Only sample from the top K options for each subsequent
+          #
+          # @param top_p [Float] Nucleus sampling parameter. Use temperature or top_p, but not both.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Hash{Symbol=>Object}]
+          #
+          # @see Telnyx::Models::AI::Anthropic::V1MessagesParams
+          def messages(params)
+            parsed, options = Telnyx::AI::Anthropic::V1MessagesParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: "ai/anthropic/v1/messages",
+              body: parsed,
+              model: Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown],
+              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/anthropic.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      class Anthropic
+        # @return [Telnyx::Resources::AI::Anthropic::V1]
+        attr_reader :v1
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+          @v1 = Telnyx::Resources::AI::Anthropic::V1.new(client: client)
+        end
+      end
+    end
+  end
+end

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

@@ -97,7 +97,7 @@ module Telnyx
           #
           # @param tool_ids [Array<String>] Body param: IDs of shared tools to attach to the assistant. New integrations sho
           #
-          # @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>] Body param: Deprecated for new integrations. Inline tool definitions available t
+          # @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>] Body param: Deprecated for new integrations. Inline tool definitions available t
           #
           # @param transcription [Telnyx::Models::AI::TranscriptionSettings] Body param
           #

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>] 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>] 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>] 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>] Deprecated for new integrations. Inline tool definitions available to the assist
         #
         # @param transcription [Telnyx::Models::AI::TranscriptionSettings]
         #

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

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      class Conversations
+        # Manage historical AI assistant conversations
+        class ConversationInsights
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesParams}
+          # for more details.
+          #
+          # Aggregate conversation insights by specified fields
+          #
+          # @overload retrieve_aggregates(created_at: nil, group_by: nil, insight_id: nil, metadata: nil, show: nil, request_options: {})
+          #
+          # @param created_at [String] Filter by creation datetime to scope the aggregation window. Supports range oper
+          #
+          # @param group_by [Array<String>] Fields to group by (can be comma-separated or multiple parameters). Prefix a fie
+          #
+          # @param insight_id [String] Optional insight ID to filter conversation insights. Only insights matching this
+          #
+          # @param metadata [Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesParams::Metadata]
+          #
+          # @param show [Array<String>] Fields to include in the result (can be comma-separated or multiple parameters).
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesResponse]
+          #
+          # @see Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesParams
+          def retrieve_aggregates(params = {})
+            parsed, options =
+              Telnyx::AI::Conversations::ConversationInsightRetrieveAggregatesParams.dump_request(params)
+            query = Telnyx::Internal::Util.encode_query_params(parsed)
+            @client.request(
+              method: :get,
+              path: "ai/conversations/conversation-insights/aggregates",
+              query: query,
+              model: Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesResponse,
+              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/conversations.rb

@@ -17,6 +17,10 @@ module Telnyx
         # @return [Telnyx::Resources::AI::Conversations::Messages]
         attr_reader :messages
 
+        # Manage historical AI assistant conversations
+        # @return [Telnyx::Resources::AI::Conversations::ConversationInsights]
+        attr_reader :conversation_insights
+
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::AI::ConversationCreateParams} for more details.
         #
@@ -237,6 +241,7 @@ module Telnyx
           @insight_groups = Telnyx::Resources::AI::Conversations::InsightGroups.new(client: client)
           @insights = Telnyx::Resources::AI::Conversations::Insights.new(client: client)
           @messages = Telnyx::Resources::AI::Conversations::Messages.new(client: client)
+          @conversation_insights = Telnyx::Resources::AI::Conversations::ConversationInsights.new(client: client)
         end
       end
     end

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

@@ -7,7 +7,7 @@ module Telnyx
       class Tools
         # Create Tool
         #
-        # @overload create(display_name:, type:, client_side_tool: nil, function: nil, handoff: nil, invite: 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, webhook: nil, request_options: {})
         #
         # @param display_name [String]
         # @param type [String]
@@ -15,6 +15,7 @@ module Telnyx
         # @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 webhook [Hash{Symbol=>Object}]
@@ -56,7 +57,7 @@ module Telnyx
 
         # Update Tool
         #
-        # @overload update(tool_id, client_side_tool: nil, display_name: nil, function: nil, handoff: nil, invite: 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, webhook: nil, request_options: {})
         #
         # @param tool_id [String] Unique identifier of the tool.
         #
@@ -70,6 +71,8 @@ module Telnyx
         #
         # @param invite [Hash{Symbol=>Object}]
         #
+        # @param pay [Telnyx::Models::AI::PayToolParams]
+        #
         # @param retrieval [Hash{Symbol=>Object}]
         #
         # @param timeout_ms [Integer]

data/lib/telnyx/resources/ai.rb

@@ -44,6 +44,9 @@ module Telnyx
       # @return [Telnyx::Resources::AI::Tools]
       attr_reader :tools
 
+      # @return [Telnyx::Resources::AI::Anthropic]
+      attr_reader :anthropic
+
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::AIRetrieveConversationHistoriesParams} for more details.
       #
@@ -208,6 +211,7 @@ module Telnyx
         @missions = Telnyx::Resources::AI::Missions.new(client: client)
         @openai = Telnyx::Resources::AI::OpenAI.new(client: client)
         @tools = Telnyx::Resources::AI::Tools.new(client: client)
+        @anthropic = Telnyx::Resources::AI::Anthropic.new(client: client)
       end
     end
   end

data/lib/telnyx/resources/calls.rb

@@ -35,7 +35,7 @@ module Telnyx
       # When the `record` parameter is set to `record-from-answer`, the response will
       # include a `recording_id` field.
       #
-      # @overload dial(connection_id:, from:, to:, answering_machine_detection: nil, answering_machine_detection_config: nil, assistant: nil, audio_url: nil, billing_group_id: nil, bridge_intent: nil, bridge_on_answer: nil, client_state: nil, command_id: nil, conference_config: nil, conversation_relay_config: nil, custom_headers: nil, deepfake_detection: nil, dialogflow_config: nil, enable_dialogflow: nil, from_display_name: nil, link_to: nil, media_encryption: nil, media_name: nil, park_after_unbridge: nil, preferred_codecs: nil, prevent_double_bridge: nil, privacy: nil, record: nil, record_channels: nil, record_custom_file_name: nil, record_format: nil, record_max_length: nil, record_timeout_secs: nil, record_track: nil, record_trim: nil, send_digits_on_answer: nil, send_silence_when_idle: nil, sip_auth_password: nil, sip_auth_username: nil, sip_headers: nil, sip_region: nil, sip_transport_protocol: nil, sound_modifications: nil, stream_auth_token: nil, stream_bidirectional_codec: nil, stream_bidirectional_mode: nil, stream_bidirectional_sampling_rate: nil, stream_bidirectional_target_legs: nil, stream_codec: nil, stream_establish_before_call_originate: nil, stream_track: nil, stream_url: nil, supervise_call_control_id: nil, supervisor_role: nil, time_limit_secs: nil, timeout_secs: nil, transcription: nil, transcription_config: nil, webhook_retries_policies: nil, webhook_url: nil, webhook_url_method: nil, webhook_urls: nil, webhook_urls_method: nil, request_options: {})
+      # @overload dial(connection_id:, from:, to:, answering_machine_detection: nil, answering_machine_detection_config: nil, assistant: nil, audio_url: nil, billing_group_id: nil, bridge_intent: nil, bridge_on_answer: nil, client_state: nil, command_id: nil, conference_config: nil, conversation_relay_config: nil, custom_headers: nil, deepfake_detection: nil, dialogflow_config: nil, enable_dialogflow: nil, from_display_name: nil, link_to: nil, media_encryption: nil, media_name: nil, park_after_unbridge: nil, preferred_codecs: nil, prevent_double_bridge: nil, privacy: nil, record: nil, record_channels: nil, record_custom_file_name: nil, record_format: nil, record_max_length: nil, record_timeout_secs: nil, record_track: nil, record_trim: nil, retry_on_timeout: nil, send_digits_on_answer: nil, send_silence_when_idle: nil, sip_auth_password: nil, sip_auth_username: nil, sip_headers: nil, sip_region: nil, sip_transport_protocol: nil, sound_modifications: nil, stream_auth_token: nil, stream_bidirectional_codec: nil, stream_bidirectional_mode: nil, stream_bidirectional_sampling_rate: nil, stream_bidirectional_target_legs: nil, stream_codec: nil, stream_establish_before_call_originate: nil, stream_track: nil, stream_url: nil, supervise_call_control_id: nil, supervisor_role: nil, time_limit_secs: nil, timeout_secs: nil, transcription: nil, transcription_config: nil, webhook_retries_policies: nil, webhook_url: nil, webhook_url_method: nil, webhook_urls: nil, webhook_urls_method: nil, request_options: {})
       #
       # @param connection_id [String] The ID of the Call Control App (formerly ID of the connection) to be used when d
       #
@@ -105,6 +105,8 @@ module Telnyx
       #
       # @param record_trim [Symbol, Telnyx::Models::CallDialParams::RecordTrim] When set to `trim-silence`, silence will be removed from the beginning and end o
       #
+      # @param retry_on_timeout [Boolean] Whether to keep trying the remaining routing paths (e.g. alternate providers/gat
+      #
       # @param send_digits_on_answer [String] DTMF digits to send automatically after the called party answers. Useful for rea
       #
       # @param send_silence_when_idle [Boolean] Generate silence RTP packets when no transmission available.