telnyx 5.171.0 → 5.174.0

data/lib/telnyx/models.rb

@@ -105,6 +105,8 @@ module Telnyx
 
   ArtifactCompletedWebhookEvent = Telnyx::Models::ArtifactCompletedWebhookEvent
 
+  ArtifactDownloadRetrieveParams = Telnyx::Models::ArtifactDownloadRetrieveParams
+
   ArtifactFailedWebhookEvent = Telnyx::Models::ArtifactFailedWebhookEvent
 
   AttachmentRequest = Telnyx::Models::AttachmentRequest
@@ -169,6 +171,18 @@ module Telnyx
 
   BrandedCallingPaginationMeta = Telnyx::Models::BrandedCallingPaginationMeta
 
+  BrowserSessionCreateParams = Telnyx::Models::BrowserSessionCreateParams
+
+  BrowserSessionDeleteParams = Telnyx::Models::BrowserSessionDeleteParams
+
+  BrowserSessionListParams = Telnyx::Models::BrowserSessionListParams
+
+  BrowserSessionRetrieveArtifactParams = Telnyx::Models::BrowserSessionRetrieveArtifactParams
+
+  BrowserSessionRetrieveParams = Telnyx::Models::BrowserSessionRetrieveParams
+
+  BrowserSessions = Telnyx::Models::BrowserSessions
+
   BulkMessagingSettingsUpdatePhoneNumbers = Telnyx::Models::BulkMessagingSettingsUpdatePhoneNumbers
 
   BulkSimCardActionDetailed = Telnyx::Models::BulkSimCardActionDetailed
@@ -192,6 +206,8 @@ module Telnyx
 
   CallAIGatherPartialResultsWebhookEvent = Telnyx::Models::CallAIGatherPartialResultsWebhookEvent
 
+  CallAnalyzedWebhookEvent = Telnyx::Models::CallAnalyzedWebhookEvent
+
   CallAnswered = Telnyx::Models::CallAnswered
 
   CallAnsweredWebhookEvent = Telnyx::Models::CallAnsweredWebhookEvent
@@ -408,6 +424,8 @@ module Telnyx
 
   Compute = Telnyx::Models::Compute
 
+  ComputeRetrieveParams = Telnyx::Models::ComputeRetrieveParams
+
   Conference = Telnyx::Models::Conference
 
   ConferenceCreated = Telnyx::Models::ConferenceCreated
@@ -574,6 +592,8 @@ module Telnyx
 
   DetailRecordListParams = Telnyx::Models::DetailRecordListParams
 
+  DialMetricListParams = Telnyx::Models::DialMetricListParams
+
   DialogflowConfig = Telnyx::Models::DialogflowConfig
 
   DialogflowConnectionCreateParams = Telnyx::Models::DialogflowConnectionCreateParams
@@ -672,6 +692,8 @@ module Telnyx
 
   DynamicEmergencyEndpointRetrieveParams = Telnyx::Models::DynamicEmergencyEndpointRetrieveParams
 
+  Email = Telnyx::Models::Email
+
   EmailAddressInput = Telnyx::Models::EmailAddressInput
 
   EmailBlock = Telnyx::Models::EmailBlock
@@ -920,6 +942,8 @@ module Telnyx
 
   GcsConfigurationData = Telnyx::Models::GcsConfigurationData
 
+  GenericPayConnectorConfig = Telnyx::Models::GenericPayConnectorConfig
+
   GlobalIP = Telnyx::Models::GlobalIP
 
   GlobalIPAllowedPortListParams = Telnyx::Models::GlobalIPAllowedPortListParams
@@ -1114,8 +1138,6 @@ module Telnyx
 
   MeetingSessionRetrieveParams = Telnyx::Models::MeetingSessionRetrieveParams
 
-  MeetingSessionRetrieveRecordingsParams = Telnyx::Models::MeetingSessionRetrieveRecordingsParams
-
   MeetingSessionRetrieveTranscriptParams = Telnyx::Models::MeetingSessionRetrieveTranscriptParams
 
   MeetingSessions = Telnyx::Models::MeetingSessions
@@ -1246,6 +1268,8 @@ module Telnyx
 
   MinimaxVoiceSettings = Telnyx::Models::MinimaxVoiceSettings
 
+  Mm7Metadata = Telnyx::Models::Mm7Metadata
+
   MobileNetworkOperatorListParams = Telnyx::Models::MobileNetworkOperatorListParams
 
   MobilePhoneNumber = Telnyx::Models::MobilePhoneNumber
@@ -1284,6 +1308,8 @@ module Telnyx
 
   MonthDetail = Telnyx::Models::MonthDetail
 
+  NetappsCursorPaginationMeta = Telnyx::Models::NetappsCursorPaginationMeta
+
   NetappsLocation = Telnyx::Models::NetappsLocation
 
   NetappsLocation17904fcfbc = Telnyx::Models::NetappsLocation17904fcfbc
@@ -1306,6 +1332,16 @@ module Telnyx
 
   NetworkRetrieveParams = Telnyx::Models::NetworkRetrieveParams
 
+  NetworkRoute = Telnyx::Models::NetworkRoute
+
+  NetworkRouteCreateParams = Telnyx::Models::NetworkRouteCreateParams
+
+  NetworkRouteDeleteParams = Telnyx::Models::NetworkRouteDeleteParams
+
+  NetworkRouteListParams = Telnyx::Models::NetworkRouteListParams
+
+  NetworkRouteRetrieveParams = Telnyx::Models::NetworkRouteRetrieveParams
+
   Networks = Telnyx::Models::Networks
 
   NetworkUpdateParams = Telnyx::Models::NetworkUpdateParams
@@ -1409,6 +1445,8 @@ module Telnyx
 
   NumberReservations = Telnyx::Models::NumberReservations
 
+  NumbersError73c9788e53 = Telnyx::Models::NumbersError73c9788e53
+
   NumbersFeatureCreateParams = Telnyx::Models::NumbersFeatureCreateParams
 
   NumbersPhoneNumberDetailed = Telnyx::Models::NumbersPhoneNumberDetailed
@@ -1491,6 +1529,20 @@ module Telnyx
 
   PaginationMetaOAuth = Telnyx::Models::PaginationMetaOAuth
 
+  PayConnector = Telnyx::Models::PayConnector
+
+  PayConnectorCreateParams = Telnyx::Models::PayConnectorCreateParams
+
+  PayConnectorDeleteParams = Telnyx::Models::PayConnectorDeleteParams
+
+  PayConnectorListParams = Telnyx::Models::PayConnectorListParams
+
+  PayConnectorResponse = Telnyx::Models::PayConnectorResponse
+
+  PayConnectorRetrieveParams = Telnyx::Models::PayConnectorRetrieveParams
+
+  PayConnectorUpdateParams = Telnyx::Models::PayConnectorUpdateParams
+
   Payment = Telnyx::Models::Payment
 
   PaymentCreateStoredPaymentTransactionParams = Telnyx::Models::PaymentCreateStoredPaymentTransactionParams
@@ -1680,8 +1732,6 @@ module Telnyx
 
   Record = Telnyx::Models::Record
 
-  RecordingAvailableWebhookEvent = Telnyx::Models::RecordingAvailableWebhookEvent
-
   RecordingDeleteParams = Telnyx::Models::RecordingDeleteParams
 
   RecordingListParams = Telnyx::Models::RecordingListParams
@@ -1798,6 +1848,8 @@ module Telnyx
 
   ServicePlan = Telnyx::Models::ServicePlan
 
+  Session = Telnyx::Models::Session
+
   SessionAnalysis = Telnyx::Models::SessionAnalysis
 
   SessionAnalysisRetrieveParams = Telnyx::Models::SessionAnalysisRetrieveParams
@@ -1902,6 +1954,8 @@ module Telnyx
 
   SpendLimit = Telnyx::Models::SpendLimit
 
+  SpendLimitBlock = Telnyx::Models::SpendLimitBlock
+
   SpendLimitCreateParams = Telnyx::Models::SpendLimitCreateParams
 
   SpendLimitDeleteParams = Telnyx::Models::SpendLimitDeleteParams
@@ -1959,6 +2013,18 @@ module Telnyx
 
   SuppressedRecipient = Telnyx::Models::SuppressedRecipient
 
+  TailscaleSubnetRouter = Telnyx::Models::TailscaleSubnetRouter
+
+  TailscaleSubnetRouterCreateParams = Telnyx::Models::TailscaleSubnetRouterCreateParams
+
+  TailscaleSubnetRouterDeleteParams = Telnyx::Models::TailscaleSubnetRouterDeleteParams
+
+  TailscaleSubnetRouterListParams = Telnyx::Models::TailscaleSubnetRouterListParams
+
+  TailscaleSubnetRouterRetrieveParams = Telnyx::Models::TailscaleSubnetRouterRetrieveParams
+
+  TailscaleSubnetRouterUpdateParams = Telnyx::Models::TailscaleSubnetRouterUpdateParams
+
   TelephonyCredential = Telnyx::Models::TelephonyCredential
 
   TelephonyCredentialCreateParams = Telnyx::Models::TelephonyCredentialCreateParams
@@ -2031,6 +2097,20 @@ module Telnyx
 
   TransportProtocol = Telnyx::Models::TransportProtocol
 
+  Tunnel = Telnyx::Models::Tunnel
+
+  TunnelCreateParams = Telnyx::Models::TunnelCreateParams
+
+  TunnelDeleteParams = Telnyx::Models::TunnelDeleteParams
+
+  TunnelListParams = Telnyx::Models::TunnelListParams
+
+  TunnelRetrieveParams = Telnyx::Models::TunnelRetrieveParams
+
+  Tunnels = Telnyx::Models::Tunnels
+
+  TunnelWithToken = Telnyx::Models::TunnelWithToken
+
   UacConnection = Telnyx::Models::UacConnection
 
   UacConnectionCreateParams = Telnyx::Models::UacConnectionCreateParams
@@ -2091,6 +2171,8 @@ module Telnyx
 
   UserTagListParams = Telnyx::Models::UserTagListParams
 
+  VariableSchemaEntry = Telnyx::Models::VariableSchemaEntry
+
   Verification = Telnyx::Models::Verification
 
   VerificationRetrieveParams = Telnyx::Models::VerificationRetrieveParams

data/lib/telnyx/resources/addresses.rb

@@ -35,6 +35,18 @@ module Telnyx
       # services that require a physical address such as emergency calling and
       # regulatory compliance.
       #
+      # By default, the new record is validated for emergency use at creation time. If
+      # the address fails validation, no record is created and the request is rejected
+      # with a 422 response; the `errors` array includes a suggested value for each
+      # offending field when one is available.
+      #
+      # Set `validate_address` to `false` to skip validation at creation, for example
+      # when the address was already validated with the Validate an address action. The
+      # record is then created without emergency validation: if it is not valid it will
+      # not be able to be used for emergency services (such as a phone number's
+      # emergency address), and because address records cannot be updated, a new record
+      # has to be created to correct it.
+      #
       # @overload create(business_name:, country_code:, first_name:, last_name:, locality:, street_address:, address_book: nil, administrative_area: nil, borough: nil, customer_reference: nil, extended_address: nil, neighborhood: nil, phone_number: nil, postal_code: nil, validate_address: nil, request_options: {})
       #
       # @param business_name [String] The business name associated with the address. An address must have either a fir

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

@@ -103,7 +103,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::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, 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>] Body param: Deprecated for new integrations. Inline tool definitions available t
+          # @param tools [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, 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::Vision, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] Body param: Deprecated for new integrations. Inline tool definitions available t
           #
           # @param transcription [Telnyx::Models::AI::TranscriptionSettings] Body param
           #
@@ -136,7 +136,10 @@ module Telnyx
           end
 
           # Retrieves all versions of a specific assistant with complete configuration and
-          # metadata
+          # metadata. An assistant keeps at most 10 versions, including the main version.
+          # When an update takes it past that limit, the oldest versions are permanently
+          # deleted. The main version and any version referenced by a traffic distribution
+          # rule are never deleted this way.
           #
           # @overload list(assistant_id, request_options: {})
           #

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

@@ -99,7 +99,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::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, 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>] Body param: Deprecated for new integrations. Inline tool definitions available t
+        # @param tools [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, 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::Vision, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] Body param: Deprecated for new integrations. Inline tool definitions available t
         #
         # @param transcription [Telnyx::Models::AI::TranscriptionSettings] Body param
         #
@@ -165,7 +165,10 @@ module Telnyx
         #
         # Updates the specified AI assistant's attributes and returns the updated
         # assistant. The request can also control how the change is promoted across
-        # assistant versions.
+        # assistant versions. Every update saves a new version, and an assistant keeps at
+        # most 10 versions: once it has more, the oldest versions are permanently deleted,
+        # except the main version and any version referenced by a traffic distribution
+        # rule.
         #
         # @overload update(assistant_id, a2a_agents: nil, avatar_settings: nil, conversation_flow: nil, delegation_settings: nil, description: nil, dynamic_variables: nil, dynamic_variables_webhook_timeout_ms: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, external_llm: nil, fallback_config: nil, greeting: nil, insight_settings: nil, instructions: nil, integrations: nil, interruption_settings: nil, llm_api_key_ref: nil, mcp_servers: nil, messaging_settings: nil, model: nil, name: nil, observability_settings: nil, post_conversation_settings: nil, privacy_settings: nil, promote_to_main: nil, tags: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, version_name: nil, voice_settings: nil, websocket_settings: nil, widget_settings: nil, request_options: {})
         #
@@ -173,7 +176,7 @@ module Telnyx
         #
         # @param a2a_agents [Array<Telnyx::Models::AI::AssistantA2AAgent>] A2A agents this assistant can delegate to. Tools are not stored here: at the sta
         #
-        # @param avatar_settings [Telnyx::Models::AI::AvatarSettingsRequest, nil] **Beta:** Configuration for the Telnyx open-source avatar provider. The launch c
+        # @param avatar_settings [Telnyx::Models::AI::AvatarSettingsRequest, nil] **Beta:** Configuration for the Telnyx open-source avatar provider. Use a stock
         #
         # @param conversation_flow [Telnyx::Models::AI::ConversationFlowReq] Conversation flow as supplied by API clients (create / update).
         #
@@ -227,7 +230,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::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, 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 tools [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, 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::Vision, 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/avatars.rb

@@ -0,0 +1,155 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      # Create and manage real-time AI avatars
+      class Avatars
+        # Uploads an image, validates its file type, size, safe decoding, and resolution,
+        # stores it in Telnyx-managed private storage, and creates an avatar owned by the
+        # authenticated organization. Creating an avatar does not update an AI Assistant;
+        # use the returned ID separately wherever the avatar is consumed. The avatar image
+        # is stored independently from the rendering model and background, which are
+        # selected where the avatar is consumed. Supported image types are JPEG, PNG, and
+        # WebP. Images may be up to 10 MiB, must be between 256 and 8192 pixels on each
+        # side, and may contain at most 40 megapixels. A per-organization custom-avatar
+        # quota applies; the create request returns an error when the quota is reached.
+        # For best results, use a 16:9 landscape image, preferably 1920 by 1080 pixels and
+        # at least 1280 by 720 pixels. Show one centered, front-facing person from the
+        # shoulders up, keep the full head and hair visible with space around it, and use
+        # a sharp, evenly lit image with unobstructed eyes and mouth. Use a transparent
+        # PNG or WebP when the avatar will be combined with a selectable background. These
+        # composition recommendations are not enforced in the first release; the first
+        # release does not validate the number of faces, pose, or image content.
+        #
+        # @overload create(image_file:, name:, request_options: {})
+        #
+        # @param image_file [Pathname, StringIO, IO, String, Telnyx::FilePart] JPEG, PNG, or WebP image file. The maximum file size is 10 MiB.
+        #
+        # @param name [String] Customer-facing name of the custom avatar.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AI::AvatarResponse]
+        #
+        # @see Telnyx::Models::AI::AvatarCreateParams
+        def create(params)
+          parsed, options = Telnyx::AI::AvatarCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "ai/avatars",
+            headers: {"content-type" => "multipart/form-data"},
+            body: parsed,
+            model: Telnyx::AI::AvatarResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AI::AvatarRetrieveParams} for more details.
+        #
+        # Returns a Telnyx stock avatar or a custom avatar owned by the authenticated
+        # organization. A custom avatar belonging to another organization is returned as
+        # not found.
+        #
+        # @overload retrieve(avatar_id, request_options: {})
+        #
+        # @param avatar_id [String] Stable identifier returned by the Avatars API. Discover available stock IDs with
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AI::AvatarResponse]
+        #
+        # @see Telnyx::Models::AI::AvatarRetrieveParams
+        def retrieve(avatar_id, params = {})
+          @client.request(
+            method: :get,
+            path: ["ai/avatars/%1$s", avatar_id],
+            model: Telnyx::AI::AvatarResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AI::AvatarUpdateParams} for more details.
+        #
+        # Updates the customer-facing name of a custom avatar owned by the authenticated
+        # organization. Stock avatars cannot be modified. To replace the image, create a
+        # new custom avatar so existing references keep their original content.
+        #
+        # @overload update(avatar_id, name:, request_options: {})
+        #
+        # @param avatar_id [String] Stable identifier returned by the Avatars API. Discover available stock IDs with
+        #
+        # @param name [String] New customer-facing name of the custom avatar.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AI::AvatarResponse]
+        #
+        # @see Telnyx::Models::AI::AvatarUpdateParams
+        def update(avatar_id, params)
+          parsed, options = Telnyx::AI::AvatarUpdateParams.dump_request(params)
+          @client.request(
+            method: :patch,
+            path: ["ai/avatars/%1$s", avatar_id],
+            body: parsed,
+            model: Telnyx::AI::AvatarResponse,
+            options: options
+          )
+        end
+
+        # Returns a paginated list of the Telnyx stock avatars and custom avatars
+        # available to the authenticated organization. Custom avatars owned by other
+        # organizations are never returned. The `image_url` value is suitable for
+        # displaying a thumbnail and may be refreshed by listing or retrieving the avatar
+        # again. `suggested_voice_id` recommends a compatible Telnyx voice for stock
+        # avatars and is an empty string for custom avatars; it does not change an AI
+        # Assistant's voice automatically.
+        #
+        # @overload list(filter_avatar_type: nil, filter_id: nil, filter_name: nil, page_number: nil, page_size: nil, request_options: {})
+        #
+        # @param filter_avatar_type [Symbol, Telnyx::Models::AI::AvatarType] Return only stock or custom avatars.
+        #
+        # @param filter_id [String] Return the avatar with this exact ID.
+        #
+        # @param filter_name [String] Return avatars whose names contain this value, using case-insensitive matching.
+        #
+        # @param page_number [Integer] Page number to retrieve, starting at 1.
+        #
+        # @param page_size [Integer] Number of avatars to return per page.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::AI::Avatar>]
+        #
+        # @see Telnyx::Models::AI::AvatarListParams
+        def list(params = {})
+          parsed, options = Telnyx::AI::AvatarListParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: "ai/avatars",
+            query: query.transform_keys(
+              filter_avatar_type: "filter[avatar_type]",
+              filter_id: "filter[id]",
+              filter_name: "filter[name]",
+              page_number: "page[number]",
+              page_size: "page[size]"
+            ),
+            page: Telnyx::Internal::DefaultFlatPagination,
+            model: Telnyx::AI::Avatar,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/ai/tests/schedules/v1/cron_jobs.rb

@@ -0,0 +1,179 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      class Tests
+        class Schedules
+          class V1
+            # Test agents, evaluator scenarios, metrics, and run results for the AI test
+            # framework.
+            class CronJobs
+              # Returns the specified scheduled test job.
+              #
+              # @overload retrieve(id, request_options: {})
+              #
+              # @param id [Integer] Numeric ID of the scheduled test job.
+              #
+              # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+              #
+              # @return [Telnyx::Models::AI::Tests::Schedules::V1::ScheduledTestJob]
+              #
+              # @see Telnyx::Models::AI::Tests::Schedules::V1::CronJobRetrieveParams
+              def retrieve(id, params = {})
+                @client.request(
+                  method: :get,
+                  path: ["ai/tests/schedules/v1/cron-jobs/%1$s", id],
+                  model: Telnyx::AI::Tests::Schedules::V1::ScheduledTestJob,
+                  options: params[:request_options]
+                )
+              end
+
+              # Updates the specified scheduled test job.
+              #
+              # @overload update(id, agent: nil, crontab_expression: nil, execution_mode: nil, frequency: nil, is_active: nil, name: nil, notify_on: nil, personalities: nil, run_as_text: nil, scenarios: nil, tags: nil, timezone: nil, request_options: {})
+              #
+              # @param id [Integer] Numeric ID of the scheduled test job.
+              #
+              # @param agent [Integer, nil]
+              #
+              # @param crontab_expression [String] Cron expression controlling when the job runs.
+              #
+              # @param execution_mode [String] Execution mode for the test runs, such as voice, text, or sip.
+              #
+              # @param frequency [Integer]
+              #
+              # @param is_active [Boolean]
+              #
+              # @param name [String]
+              #
+              # @param notify_on [Symbol, Telnyx::Models::AI::Tests::Schedules::V1::CronJobUpdateParams::NotifyOn]
+              #
+              # @param personalities [Array<Integer>]
+              #
+              # @param run_as_text [Boolean]
+              #
+              # @param scenarios [Array<Integer>]
+              #
+              # @param tags [Array<String>]
+              #
+              # @param timezone [String]
+              #
+              # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+              #
+              # @return [Telnyx::Models::AI::Tests::Schedules::V1::ScheduledTestJob]
+              #
+              # @see Telnyx::Models::AI::Tests::Schedules::V1::CronJobUpdateParams
+              def update(id, params = {})
+                parsed, options = Telnyx::AI::Tests::Schedules::V1::CronJobUpdateParams.dump_request(params)
+                @client.request(
+                  method: :patch,
+                  path: ["ai/tests/schedules/v1/cron-jobs/%1$s", id],
+                  body: parsed,
+                  model: Telnyx::AI::Tests::Schedules::V1::ScheduledTestJob,
+                  options: options
+                )
+              end
+
+              # Deletes the specified scheduled test job.
+              #
+              # @overload delete(id, request_options: {})
+              #
+              # @param id [Integer] Numeric ID of the scheduled test job.
+              #
+              # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+              #
+              # @return [Object]
+              #
+              # @see Telnyx::Models::AI::Tests::Schedules::V1::CronJobDeleteParams
+              def delete(id, params = {})
+                @client.request(
+                  method: :delete,
+                  path: ["ai/tests/schedules/v1/cron-jobs/%1$s", id],
+                  model: Telnyx::Internal::Type::Unknown,
+                  options: params[:request_options]
+                )
+              end
+
+              # Creates a scheduled test job that runs the selected scenarios on a cron
+              # expression.
+              #
+              # @overload cron_jobs(crontab_expression:, agent: nil, execution_mode: nil, frequency: nil, is_active: nil, name: nil, notify_on: nil, personalities: nil, run_as_text: nil, scenarios: nil, tags: nil, timezone: nil, request_options: {})
+              #
+              # @param crontab_expression [String] Cron expression controlling when the job runs.
+              #
+              # @param agent [Integer]
+              #
+              # @param execution_mode [String] Execution mode for the test runs, such as voice, text, or sip.
+              #
+              # @param frequency [Integer]
+              #
+              # @param is_active [Boolean]
+              #
+              # @param name [String]
+              #
+              # @param notify_on [Symbol, Telnyx::Models::AI::Tests::Schedules::V1::CronJobCronJobsParams::NotifyOn]
+              #
+              # @param personalities [Array<Integer>]
+              #
+              # @param run_as_text [Boolean]
+              #
+              # @param scenarios [Array<Integer>]
+              #
+              # @param tags [Array<String>]
+              #
+              # @param timezone [String]
+              #
+              # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+              #
+              # @return [Telnyx::Models::AI::Tests::Schedules::V1::ScheduledTestJob]
+              #
+              # @see Telnyx::Models::AI::Tests::Schedules::V1::CronJobCronJobsParams
+              def cron_jobs(params)
+                parsed, options = Telnyx::AI::Tests::Schedules::V1::CronJobCronJobsParams.dump_request(params)
+                @client.request(
+                  method: :post,
+                  path: "ai/tests/schedules/v1/cron-jobs",
+                  body: parsed,
+                  model: Telnyx::AI::Tests::Schedules::V1::ScheduledTestJob,
+                  options: options
+                )
+              end
+
+              # Returns the scheduled test jobs in your organization, optionally filtered by
+              # test agent. A scheduled job runs selected scenarios on a cron expression.
+              #
+              # @overload retrieve_cron_jobs(agent_id: nil, request_options: {})
+              #
+              # @param agent_id [Integer] Filter jobs belonging to the specified test agent.
+              #
+              # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+              #
+              # @return [Array<Telnyx::Models::AI::Tests::Schedules::V1::ScheduledTestJob>]
+              #
+              # @see Telnyx::Models::AI::Tests::Schedules::V1::CronJobRetrieveCronJobsParams
+              def retrieve_cron_jobs(params = {})
+                parsed, options = Telnyx::AI::Tests::Schedules::V1::CronJobRetrieveCronJobsParams.dump_request(params)
+                query = Telnyx::Internal::Util.encode_query_params(parsed)
+                @client.request(
+                  method: :get,
+                  path: "ai/tests/schedules/v1/cron-jobs",
+                  query: query,
+                  model: Telnyx::Internal::Type::ArrayOf[Telnyx::AI::Tests::Schedules::V1::ScheduledTestJob],
+                  options: options
+                )
+              end
+
+              # @api private
+              #
+              # @param client [Telnyx::Client]
+              def initialize(client:)
+                @client = client
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/ai/tests/schedules/v1.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      class Tests
+        class Schedules
+          class V1
+            # Test agents, evaluator scenarios, metrics, and run results for the AI test
+            # framework.
+            # @return [Telnyx::Resources::AI::Tests::Schedules::V1::CronJobs]
+            attr_reader :cron_jobs
+
+            # @api private
+            #
+            # @param client [Telnyx::Client]
+            def initialize(client:)
+              @client = client
+              @cron_jobs = Telnyx::Resources::AI::Tests::Schedules::V1::CronJobs.new(client: client)
+            end
+          end
+        end
+      end
+    end
+  end
+end