telnyx 5.168.0 → 5.170.0

data/lib/telnyx/models/update_email_template_request.rb

@@ -3,6 +3,12 @@
 module Telnyx
   module Models
     class UpdateEmailTemplateRequest < Telnyx::Internal::Type::BaseModel
+      # @!attribute autoescape
+      #   Per-template HTML autoescaping setting.
+      #
+      #   @return [Boolean, nil]
+      optional :autoescape, Telnyx::Internal::Type::Boolean
+
       # @!attribute html_body
       #   Liquid template HTML body.
       #
@@ -14,6 +20,12 @@ module Telnyx
       #   @return [String, nil]
       optional :name, String
 
+      # @!attribute strict_variables
+      #   Per-template strict variable-validation setting.
+      #
+      #   @return [Boolean, nil]
+      optional :strict_variables, Telnyx::Internal::Type::Boolean
+
       # @!attribute subject
       #   Liquid template subject.
       #
@@ -26,21 +38,62 @@ module Telnyx
       #   @return [String, nil]
       optional :text_body, String, nil?: true
 
+      # @!attribute variable_schema
+      #   Structured variable requirements. Required variables cannot define defaults;
+      #   invalid combinations return 422. Set to `null` to clear the schema.
+      #
+      #   @return [Hash{Symbol=>Telnyx::Models::UpdateEmailTemplateRequest::VariableSchema}, nil]
+      optional :variable_schema,
+               -> { Telnyx::Internal::Type::HashOf[Telnyx::UpdateEmailTemplateRequest::VariableSchema] },
+               nil?: true
+
       # @!attribute variables
       #
       #   @return [Array<String>, nil]
       optional :variables, Telnyx::Internal::Type::ArrayOf[String]
 
-      # @!method initialize(html_body: nil, name: nil, subject: nil, text_body: nil, variables: nil)
+      # @!method initialize(autoescape: nil, html_body: nil, name: nil, strict_variables: nil, subject: nil, text_body: nil, variable_schema: nil, variables: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::UpdateEmailTemplateRequest} for more details.
+      #
+      #   @param autoescape [Boolean] Per-template HTML autoescaping setting.
+      #
       #   @param html_body [String, nil] Liquid template HTML body.
       #
       #   @param name [String]
       #
+      #   @param strict_variables [Boolean] Per-template strict variable-validation setting.
+      #
       #   @param subject [String, nil] Liquid template subject.
       #
       #   @param text_body [String, nil] Liquid template text body.
       #
+      #   @param variable_schema [Hash{Symbol=>Telnyx::Models::UpdateEmailTemplateRequest::VariableSchema}, nil] Structured variable requirements. Required variables cannot define defaults; inv
+      #
       #   @param variables [Array<String>]
+
+      class VariableSchema < Telnyx::Internal::Type::BaseModel
+        # @!attribute required
+        #   Whether the variable must be supplied when strict variable validation is
+        #   enabled.
+        #
+        #   @return [Boolean]
+        required :required, Telnyx::Internal::Type::Boolean
+
+        # @!attribute default
+        #   Default value for an optional variable. Rejected when `required` is `true`.
+        #
+        #   @return [String, nil]
+        optional :default, String
+
+        # @!method initialize(required:, default: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::UpdateEmailTemplateRequest::VariableSchema} for more details.
+        #
+        #   @param required [Boolean] Whether the variable must be supplied when strict variable validation is enabled
+        #
+        #   @param default [String] Default value for an optional variable. Rejected when `required` is `true`.
+      end
     end
   end
 end

data/lib/telnyx/models/voice_clone_create_from_upload_params.rb

@@ -160,8 +160,8 @@ module Telnyx
         class TelnyxUltraClone < Telnyx::Internal::Type::BaseModel
           # @!attribute audio_file
           #   Audio file to clone the voice from. Supported formats: WAV, MP3, FLAC, OGG, M4A.
-          #   For best quality, provide 5–10 seconds of clear, uninterrupted speech. Maximum
-          #   size: 5MB.
+          #   For best quality, provide up to 60 seconds of clear, uninterrupted speech.
+          #   Maximum size: 5MB.
           #
           #   @return [Pathname, StringIO, IO, String, Telnyx::FilePart]
           required :audio_file, Telnyx::Internal::Type::FileInput

data/lib/telnyx/models/wireless_private_wireless_gateway.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::PrivateWirelessGateways#list
+    class WirelessPrivateWirelessGateway < Telnyx::Internal::Type::BaseModel
+      # @!attribute address_mode
+      #   The address mode of the private wireless gateway. With static, each SIM card
+      #   gets a fixed IP address from the gateway's IP range that is preserved across
+      #   sessions. With dynamic, IP addresses are assigned by the network at attach time
+      #   and may change between sessions.
+      #
+      #   @return [Symbol, Telnyx::Models::WirelessPrivateWirelessGateway::AddressMode, nil]
+      optional :address_mode, enum: -> { Telnyx::WirelessPrivateWirelessGateway::AddressMode }
+
+      # @!attribute assigned_resources
+      #   A list of the resources that have been assigned to the Private Wireless Gateway.
+      #
+      #   @return [Array<Telnyx::Models::PwgAssignedResourcesSummary>, nil]
+      optional :assigned_resources, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::PwgAssignedResourcesSummary] }
+
+      # @!attribute name
+      #   The private wireless gateway name.
+      #
+      #   @return [String, nil]
+      optional :name, String
+
+      # @!attribute network_id
+      #   The identification of the related network resource.
+      #
+      #   @return [String, nil]
+      optional :network_id, String
+
+      # @!attribute region_code
+      #   The name of the region where the Private Wireless Gateway is deployed.
+      #
+      #   @return [String, nil]
+      optional :region_code, String
+
+      # @!attribute status
+      #   The current status or failure details of the Private Wireless Gateway.
+      #
+      #   @return [Telnyx::Models::PrivateWirelessGatewayStatus, nil]
+      optional :status, -> { Telnyx::PrivateWirelessGatewayStatus }
+
+      response_only do
+        # @!attribute id
+        #   Identifies the resource.
+        #
+        #   @return [String, nil]
+        optional :id, String
+
+        # @!attribute created_at
+        #   ISO 8601 formatted date-time indicating when the resource was created.
+        #
+        #   @return [String, nil]
+        optional :created_at, String
+
+        # @!attribute ip_range
+        #   IP block used to assign IPs to the SIM cards in the Private Wireless Gateway.
+        #
+        #   @return [String, nil]
+        optional :ip_range, String
+
+        # @!attribute record_type
+        #
+        #   @return [String, nil]
+        optional :record_type, String
+
+        # @!attribute updated_at
+        #   ISO 8601 formatted date-time indicating when the resource was updated.
+        #
+        #   @return [String, nil]
+        optional :updated_at, String
+      end
+
+      # @!method initialize(id: nil, address_mode: nil, assigned_resources: nil, created_at: nil, ip_range: nil, name: nil, network_id: nil, record_type: nil, region_code: nil, status: nil, updated_at: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::WirelessPrivateWirelessGateway} for more details.
+      #
+      #   @param id [String] Identifies the resource.
+      #
+      #   @param address_mode [Symbol, Telnyx::Models::WirelessPrivateWirelessGateway::AddressMode] The address mode of the private wireless gateway. With static, each SIM card get
+      #
+      #   @param assigned_resources [Array<Telnyx::Models::PwgAssignedResourcesSummary>] A list of the resources that have been assigned to the Private Wireless Gateway.
+      #
+      #   @param created_at [String] ISO 8601 formatted date-time indicating when the resource was created.
+      #
+      #   @param ip_range [String] IP block used to assign IPs to the SIM cards in the Private Wireless Gateway.
+      #
+      #   @param name [String] The private wireless gateway name.
+      #
+      #   @param network_id [String] The identification of the related network resource.
+      #
+      #   @param record_type [String]
+      #
+      #   @param region_code [String] The name of the region where the Private Wireless Gateway is deployed.
+      #
+      #   @param status [Telnyx::Models::PrivateWirelessGatewayStatus] The current status or failure details of the Private Wireless Gateway.
+      #
+      #   @param updated_at [String] ISO 8601 formatted date-time indicating when the resource was updated.
+
+      # The address mode of the private wireless gateway. With static, each SIM card
+      # gets a fixed IP address from the gateway's IP range that is preserved across
+      # sessions. With dynamic, IP addresses are assigned by the network at attach time
+      # and may change between sessions.
+      #
+      # @see Telnyx::Models::WirelessPrivateWirelessGateway#address_mode
+      module AddressMode
+        extend Telnyx::Internal::Type::Enum
+
+        STATIC = :static
+        DYNAMIC = :dynamic
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/telnyx/models.rb

@@ -157,6 +157,14 @@ module Telnyx
 
   BookAppointmentToolParams = Telnyx::Models::BookAppointmentToolParams
 
+  BotChallengeCreateParams = Telnyx::Models::BotChallengeCreateParams
+
+  BotSessionListParams = Telnyx::Models::BotSessionListParams
+
+  BotSignupCreateParams = Telnyx::Models::BotSignupCreateParams
+
+  BotSignupResendMagicLinkParams = Telnyx::Models::BotSignupResendMagicLinkParams
+
   BrandedCallingPaginationMeta = Telnyx::Models::BrandedCallingPaginationMeta
 
   BulkMessagingSettingsUpdatePhoneNumbers = Telnyx::Models::BulkMessagingSettingsUpdatePhoneNumbers
@@ -477,6 +485,8 @@ module Telnyx
 
   ConnectionNoiseSuppressionDetails = Telnyx::Models::ConnectionNoiseSuppressionDetails
 
+  ConnectionRetrieveCountParams = Telnyx::Models::ConnectionRetrieveCountParams
+
   ConnectionRetrieveParams = Telnyx::Models::ConnectionRetrieveParams
 
   ConnectionRtcpSettings = Telnyx::Models::ConnectionRtcpSettings
@@ -684,6 +694,8 @@ module Telnyx
 
   EmailDomainRetrieveParams = Telnyx::Models::EmailDomainRetrieveParams
 
+  EmailDomainRotateDkimParams = Telnyx::Models::EmailDomainRotateDkimParams
+
   EmailDomains = Telnyx::Models::EmailDomains
 
   EmailDomainStatus = Telnyx::Models::EmailDomainStatus
@@ -726,6 +738,8 @@ module Telnyx
 
   EmailMessageDeleteScheduleParams = Telnyx::Models::EmailMessageDeleteScheduleParams
 
+  EmailMessageDetailResponse = Telnyx::Models::EmailMessageDetailResponse
+
   EmailMessageListParams = Telnyx::Models::EmailMessageListParams
 
   EmailMessageRetrieveEventsParams = Telnyx::Models::EmailMessageRetrieveEventsParams
@@ -734,6 +748,8 @@ module Telnyx
 
   EmailMessages = Telnyx::Models::EmailMessages
 
+  EmailMessageUpdateScheduleParams = Telnyx::Models::EmailMessageUpdateScheduleParams
+
   EmailTemplate = Telnyx::Models::EmailTemplate
 
   EmailTemplateCreateParams = Telnyx::Models::EmailTemplateCreateParams
@@ -776,6 +792,8 @@ module Telnyx
 
   EmailValidations = Telnyx::Models::EmailValidations
 
+  EmailWebhookRecipient = Telnyx::Models::EmailWebhookRecipient
+
   EncryptedMedia = Telnyx::Models::EncryptedMedia
 
   EnterpriseBrandedCallingParams = Telnyx::Models::EnterpriseBrandedCallingParams
@@ -1024,6 +1042,8 @@ module Telnyx
 
   ListRetrieveByZoneParams = Telnyx::Models::ListRetrieveByZoneParams
 
+  MachinePaymentAccountCreditParams = Telnyx::Models::MachinePaymentAccountCreditParams
+
   ManagedAccount = Telnyx::Models::ManagedAccount
 
   ManagedAccountBalance = Telnyx::Models::ManagedAccountBalance
@@ -1151,6 +1171,8 @@ module Telnyx
 
   MessagingHostedNumberUpdateParams = Telnyx::Models::MessagingHostedNumberUpdateParams
 
+  MessagingInboundMessage = Telnyx::Models::MessagingInboundMessage
+
   MessagingInboundMessagePayload = Telnyx::Models::MessagingInboundMessagePayload
 
   MessagingMessagingProfile = Telnyx::Models::MessagingMessagingProfile
@@ -1268,6 +1290,8 @@ module Telnyx
 
   NetworkUpdateParams = Telnyx::Models::NetworkUpdateParams
 
+  NoiseSuppressionEngineListParams = Telnyx::Models::NoiseSuppressionEngineListParams
+
   NotificationChannel = Telnyx::Models::NotificationChannel
 
   NotificationChannelCreateParams = Telnyx::Models::NotificationChannelCreateParams
@@ -1886,6 +1910,8 @@ module Telnyx
 
   SubNumberOrderUpdateRequirementGroupParams = Telnyx::Models::SubNumberOrderUpdateRequirementGroupParams
 
+  SuccessResponse = Telnyx::Models::SuccessResponse
+
   SuppressedRecipient = Telnyx::Models::SuppressedRecipient
 
   TelephonyCredential = Telnyx::Models::TelephonyCredential
@@ -2235,6 +2261,8 @@ module Telnyx
 
   WirelessError = Telnyx::Models::WirelessError
 
+  WirelessPrivateWirelessGateway = Telnyx::Models::WirelessPrivateWirelessGateway
+
   WirelessRetrieveRegionsParams = Telnyx::Models::WirelessRetrieveRegionsParams
 
   WirelessWirelessBlocklist = Telnyx::Models::WirelessWirelessBlocklist

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

@@ -99,13 +99,13 @@ 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, 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::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
           #
           # @param version_name [String] Body param: Human-readable name for the assistant version.
           #
-          # @param voice_settings [Telnyx::Models::AI::VoiceSettings] Body param
+          # @param voice_settings [Telnyx::Models::AI::InferenceEmbeddingVoiceSettings] Body param
           #
           # @param widget_settings [Telnyx::Models::AI::WidgetSettings] Body param: Configuration settings for the assistant's web widget.
           #

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

@@ -91,11 +91,11 @@ 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, 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::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
         #
-        # @param voice_settings [Telnyx::Models::AI::VoiceSettings] Body param
+        # @param voice_settings [Telnyx::Models::AI::InferenceEmbeddingVoiceSettings] Body param
         #
         # @param widget_settings [Telnyx::Models::AI::WidgetSettings] Body param: Configuration settings for the assistant's web widget.
         #
@@ -213,13 +213,13 @@ 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, 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::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] Deprecated for new integrations. Inline tool definitions available to the assist
         #
         # @param transcription [Telnyx::Models::AI::TranscriptionSettings]
         #
         # @param version_name [String] Human-readable name for the assistant version.
         #
-        # @param voice_settings [Telnyx::Models::AI::VoiceSettings]
+        # @param voice_settings [Telnyx::Models::AI::InferenceEmbeddingVoiceSettings]
         #
         # @param widget_settings [Telnyx::Models::AI::WidgetSettings] Configuration settings for the assistant's web widget.
         #

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

@@ -19,9 +19,9 @@ module Telnyx
         #
         # @param file_url [String] Link to audio file in one of these formats: flac, mp3, mp4, mpeg, mpga, m4a, ogg
         #
-        # @param language [String] The language of the audio to be transcribed. For `deepgram/nova-3`, only English
+        # @param language [String] The language of the audio to be transcribed. `deepgram/nova-3` supports ~49 lang
         #
-        # @param model_config [Hash{Symbol=>Object}] Additional model-specific configuration parameters. Only allowed with `deepgram/
+        # @param model_config [Hash{Symbol=>Object}] Additional model-specific configuration parameters. Only allowed with the `deepg
         #
         # @param response_format [Symbol, Telnyx::Models::AI::AudioTranscribeParams::ResponseFormat] The format of the transcript output. Use `verbose_json` to take advantage of tim
         #

data/lib/telnyx/resources/ai/memory/namespaces/profiles/memories.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      class Memory
+        class Namespaces
+          class Profiles
+            # What a namespace and a profile hold.
+            class Memories
+              # Some parameter documentations has been truncated, see
+              # {Telnyx::Models::AI::Memory::Namespaces::Profiles::MemoryRetrieveParams} for
+              # more details.
+              #
+              # One memory by its id, as `recall` and the listing return it, together with what
+              # it came from. A fact names its `source_id`: read it with
+              # `GET .../sources/{source_id}` to see what was stored. A memory derived from
+              # other memories names them in `derived_from` instead; read each of those to reach
+              # its source.
+              #
+              # @overload retrieve(memory_id, namespace:, profile_id:, request_options: {})
+              #
+              # @param memory_id [String] A memory's id, as `recall` and the listing return it.
+              #
+              # @param namespace [String] The namespace. `default` exists for every organization.
+              #
+              # @param profile_id [String] The profile: your identifier for the user, caller or agent this memory is about.
+              #
+              # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+              #
+              # @return [Telnyx::Models::AI::Memory::Namespaces::Profiles::MemoryRetrieveResponse]
+              #
+              # @see Telnyx::Models::AI::Memory::Namespaces::Profiles::MemoryRetrieveParams
+              def retrieve(memory_id, params)
+                parsed, options = Telnyx::AI::Memory::Namespaces::Profiles::MemoryRetrieveParams.dump_request(params)
+                namespace =
+                  parsed.delete(:namespace) do
+                    raise ArgumentError.new("missing required path argument #{_1}")
+                  end
+                profile_id =
+                  parsed.delete(:profile_id) do
+                    raise ArgumentError.new("missing required path argument #{_1}")
+                  end
+                @client.request(
+                  method: :get,
+                  path: [
+                    "ai/memory/namespaces/%1$s/profiles/%2$s/memories/%3$s",
+                    namespace,
+                    profile_id,
+                    memory_id
+                  ],
+                  model: Telnyx::Models::AI::Memory::Namespaces::Profiles::MemoryRetrieveResponse,
+                  options: options
+                )
+              end
+
+              # Some parameter documentations has been truncated, see
+              # {Telnyx::Models::AI::Memory::Namespaces::Profiles::MemoryListParams} for more
+              # details.
+              #
+              # Everything stored under one profile, unranked -- ask `recall` for the memories
+              # that answer a question. A profile that holds nothing is an empty page rather
+              # than a 404: profiles exist by being written to. Each memory names the
+              # `source_id` it was extracted from, or null for a memory derived from other
+              # memories -- which can read almost the same as the fact it restates. A
+              # `source_id` narrows the listing to the memories extracted from that source, and
+              # a `session_id` to those extracted from the session, which is the same thing
+              # named another way; pass one or the other. Neither is everything the source led
+              # to: a memory derived from several sources belongs to no single one and appears
+              # only in the unfiltered listing. A memory written while the listing is paged
+              # shifts the pages after it, so an entry can be repeated or missed at a page
+              # boundary.
+              #
+              # @overload list(profile_id, namespace:, page_number: nil, page_size: nil, session_id: nil, source_id: nil, request_options: {})
+              #
+              # @param profile_id [String] Path param
+              #
+              # @param namespace [String] Path param
+              #
+              # @param page_number [Integer] Query param: The page to return, counting from 1. Bounded in depth: (page[number
+              #
+              # @param page_size [Integer] Query param: How many results a page holds.
+              #
+              # @param session_id [String, nil] Query param: An ingested session, by the `session_id` it was ingested with. Narr
+              #
+              # @param source_id [String, nil] Query param: Narrows the listing to the memories extracted from one source, a re
+              #
+              # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+              #
+              # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::AI::Memory::Namespaces::Profiles::MemoryListResponse>]
+              #
+              # @see Telnyx::Models::AI::Memory::Namespaces::Profiles::MemoryListParams
+              def list(profile_id, params)
+                parsed, options = Telnyx::AI::Memory::Namespaces::Profiles::MemoryListParams.dump_request(params)
+                query = Telnyx::Internal::Util.encode_query_params(parsed)
+                namespace =
+                  parsed.delete(:namespace) do
+                    raise ArgumentError.new("missing required path argument #{_1}")
+                  end
+                @client.request(
+                  method: :get,
+                  path: ["ai/memory/namespaces/%1$s/profiles/%2$s/memories", namespace, profile_id],
+                  query: query.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+                  page: Telnyx::Internal::DefaultFlatPagination,
+                  model: Telnyx::Models::AI::Memory::Namespaces::Profiles::MemoryListResponse,
+                  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/memory/namespaces/profiles/sources.rb

@@ -0,0 +1,163 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      class Memory
+        class Namespaces
+          class Profiles
+            # What a profile stored, and what its memories came from.
+            class Sources
+              # Some parameter documentations has been truncated, see
+              # {Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveParams} for
+              # more details.
+              #
+              # One source and its content, as it was stored: an ingested session's payload or a
+              # remembered fact. A source whose ingest is still queued answers 404 until it has
+              # been stored.
+              #
+              # @overload retrieve(source_id, namespace:, profile_id:, request_options: {})
+              #
+              # @param source_id [String] Identifies one source within its profile: an ingested session, or one remembered
+              #
+              # @param namespace [String] The namespace. `default` exists for every organization.
+              #
+              # @param profile_id [String] The profile: your identifier for the user, caller or agent this memory is about.
+              #
+              # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+              #
+              # @return [Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse]
+              #
+              # @see Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveParams
+              def retrieve(source_id, params)
+                parsed, options = Telnyx::AI::Memory::Namespaces::Profiles::SourceRetrieveParams.dump_request(params)
+                namespace =
+                  parsed.delete(:namespace) do
+                    raise ArgumentError.new("missing required path argument #{_1}")
+                  end
+                profile_id =
+                  parsed.delete(:profile_id) do
+                    raise ArgumentError.new("missing required path argument #{_1}")
+                  end
+                @client.request(
+                  method: :get,
+                  path: [
+                    "ai/memory/namespaces/%1$s/profiles/%2$s/sources/%3$s",
+                    namespace,
+                    profile_id,
+                    source_id
+                  ],
+                  model: Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse,
+                  options: options
+                )
+              end
+
+              # Some parameter documentations has been truncated, see
+              # {Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceListParams} for more
+              # details.
+              #
+              # Everything a profile has stored and extracts memories from: each ingested
+              # session, and each remembered fact, which has no session. Content is not listed;
+              # read one source for it. A source whose ingest is still queued is not here yet.
+              # Re-ingesting a session moves it to the front, so a listing paged while sessions
+              # are written can repeat or miss one at a page boundary. A `session_id` narrows
+              # the listing to the source that session was stored as: one source or none, and
+              # none -- an empty page, not a 404 -- for a session never ingested, still queued,
+              # or another profile's.
+              #
+              # @overload list(profile_id, namespace:, page_number: nil, page_size: nil, session_id: nil, request_options: {})
+              #
+              # @param profile_id [String] Path param
+              #
+              # @param namespace [String] Path param
+              #
+              # @param page_number [Integer] Query param: The page to return, counting from 1. Bounded in depth: (page[number
+              #
+              # @param page_size [Integer] Query param: How many results a page holds.
+              #
+              # @param session_id [String, nil] Query param: An ingested session, by the `session_id` it was ingested with. Narr
+              #
+              # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+              #
+              # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::AI::Collections::Source>]
+              #
+              # @see Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceListParams
+              def list(profile_id, params)
+                parsed, options = Telnyx::AI::Memory::Namespaces::Profiles::SourceListParams.dump_request(params)
+                query = Telnyx::Internal::Util.encode_query_params(parsed)
+                namespace =
+                  parsed.delete(:namespace) do
+                    raise ArgumentError.new("missing required path argument #{_1}")
+                  end
+                @client.request(
+                  method: :get,
+                  path: ["ai/memory/namespaces/%1$s/profiles/%2$s/sources", namespace, profile_id],
+                  query: query.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+                  page: Telnyx::Internal::DefaultFlatPagination,
+                  model: Telnyx::AI::Collections::Source,
+                  options: options
+                )
+              end
+
+              # Some parameter documentations has been truncated, see
+              # {Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceDeleteParams} for more
+              # details.
+              #
+              # Deletes one source -- an ingested session or a remembered fact -- together with
+              # the memories derived from it. A memory derived from this source and others is
+              # deleted too, and derived again from what remains in the background. It answers
+              # only once the source is gone. A source that is not there -- never stored,
+              # another profile's, or already deleted -- answers 404, so on a `502` or a `504`
+              # repeat the identical request and read a 404 as done. An ingest of the same
+              # session that is still queued is not cancelled, and stores the session again when
+              # it runs. Nothing here can be undone.
+              #
+              # @overload delete(source_id, namespace:, profile_id:, request_options: {})
+              #
+              # @param source_id [String] Identifies one source within its profile: an ingested session, or one remembered
+              #
+              # @param namespace [String] The namespace. `default` exists for every organization.
+              #
+              # @param profile_id [String] The profile: your identifier for the user, caller or agent this memory is about.
+              #
+              # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+              #
+              # @return [Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceDeleteResponse]
+              #
+              # @see Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceDeleteParams
+              def delete(source_id, params)
+                parsed, options = Telnyx::AI::Memory::Namespaces::Profiles::SourceDeleteParams.dump_request(params)
+                namespace =
+                  parsed.delete(:namespace) do
+                    raise ArgumentError.new("missing required path argument #{_1}")
+                  end
+                profile_id =
+                  parsed.delete(:profile_id) do
+                    raise ArgumentError.new("missing required path argument #{_1}")
+                  end
+                @client.request(
+                  method: :delete,
+                  path: [
+                    "ai/memory/namespaces/%1$s/profiles/%2$s/sources/%3$s",
+                    namespace,
+                    profile_id,
+                    source_id
+                  ],
+                  model: Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceDeleteResponse,
+                  options: options
+                )
+              end
+
+              # @api private
+              #
+              # @param client [Telnyx::Client]
+              def initialize(client:)
+                @client = client
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end