telnyx 5.169.0 → 5.171.0

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

@@ -43,7 +43,7 @@ module Telnyx
           # Updates the configuration of a specific assistant version. Can not update main
           # version
           #
-          # @overload update(version_id, assistant_id:, a2a_agents: nil, conversation_flow: 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, tags: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, version_name: nil, voice_settings: nil, widget_settings: nil, request_options: {})
+          # @overload update(version_id, 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, 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: {})
           #
           # @param version_id [String] Path param: Unique identifier of the version.
           #
@@ -51,8 +51,12 @@ module Telnyx
           #
           # @param a2a_agents [Array<Telnyx::Models::AI::AssistantA2AAgent>] Body param: A2A agents this assistant can delegate to. Tools are not stored here
           #
+          # @param avatar_settings [Telnyx::Models::AI::AvatarSettingsRequest, nil] Body param: **Beta:** Configuration for the Telnyx open-source avatar provider.
+          #
           # @param conversation_flow [Telnyx::Models::AI::ConversationFlowReq] Body param: Conversation flow as supplied by API clients (create / update).
           #
+          # @param delegation_settings [Telnyx::Models::AI::DelegationSettings] Body param: Splits the conversation between a frontend model that talks to the c
+          #
           # @param description [String] Body param
           #
           # @param dynamic_variables [Hash{Symbol=>Object}] Body param: Map of dynamic variables and their default values
@@ -105,7 +109,9 @@ module Telnyx
           #
           # @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 websocket_settings [Telnyx::Models::AI::WebsocketSettings] Body param: Streams conversation and telephony events to a WebSocket server you
           #
           # @param widget_settings [Telnyx::Models::AI::WidgetSettings] Body param: Configuration settings for the assistant's web widget.
           #

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

@@ -33,13 +33,17 @@ module Telnyx
         # @return [Telnyx::Resources::AI::Assistants::Instructions]
         attr_reader :instructions
 
+        # Configure AI assistant specifications
+        # @return [Telnyx::Resources::AI::Assistants::Deleted]
+        attr_reader :deleted
+
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::AI::AssistantCreateParams} for more details.
         #
         # Creates a new AI assistant from the provided configuration, including its model,
         # instructions, and attached tools, and returns the created assistant.
         #
-        # @overload create(instructions:, name:, a2a_agents: nil, conversation_flow: 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, integrations: nil, interruption_settings: nil, llm_api_key_ref: nil, mcp_servers: nil, messaging_settings: nil, model: nil, observability_settings: nil, post_conversation_settings: nil, privacy_settings: nil, tags: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, voice_settings: nil, widget_settings: nil, idempotency_key: nil, request_options: {})
+        # @overload create(instructions:, name:, 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, integrations: nil, interruption_settings: nil, llm_api_key_ref: nil, mcp_servers: nil, messaging_settings: nil, model: nil, observability_settings: nil, post_conversation_settings: nil, privacy_settings: nil, tags: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, voice_settings: nil, websocket_settings: nil, widget_settings: nil, idempotency_key: nil, request_options: {})
         #
         # @param instructions [String] Body param: System instructions for the assistant. These may be templated with [
         #
@@ -47,8 +51,12 @@ module Telnyx
         #
         # @param a2a_agents [Array<Telnyx::Models::AI::AssistantA2AAgent>] Body param: A2A agents this assistant can delegate to. Tools are not stored here
         #
+        # @param avatar_settings [Telnyx::Models::AI::AvatarSettingsRequest, nil] Body param: **Beta:** Configuration for the Telnyx open-source avatar provider.
+        #
         # @param conversation_flow [Telnyx::Models::AI::ConversationFlowReq] Body param: Conversation flow as supplied by API clients (create / update).
         #
+        # @param delegation_settings [Telnyx::Models::AI::DelegationSettings] Body param: Splits the conversation between a frontend model that talks to the c
+        #
         # @param description [String] Body param
         #
         # @param dynamic_variables [Hash{Symbol=>Object}] Body param: Map of dynamic variables and their default values
@@ -95,7 +103,9 @@ module Telnyx
         #
         # @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 websocket_settings [Telnyx::Models::AI::WebsocketSettings] Body param: Streams conversation and telephony events to a WebSocket server you
         #
         # @param widget_settings [Telnyx::Models::AI::WidgetSettings] Body param: Configuration settings for the assistant's web widget.
         #
@@ -157,14 +167,18 @@ module Telnyx
         # assistant. The request can also control how the change is promoted across
         # assistant versions.
         #
-        # @overload update(assistant_id, a2a_agents: nil, conversation_flow: 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, widget_settings: nil, request_options: {})
+        # @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: {})
         #
         # @param assistant_id [String] Unique identifier of the assistant.
         #
         # @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 conversation_flow [Telnyx::Models::AI::ConversationFlowReq] Conversation flow as supplied by API clients (create / update).
         #
+        # @param delegation_settings [Telnyx::Models::AI::DelegationSettings] Splits the conversation between a frontend model that talks to the caller and a
+        #
         # @param description [String]
         #
         # @param dynamic_variables [Hash{Symbol=>Object}] Map of dynamic variables and their default values
@@ -219,7 +233,9 @@ module Telnyx
         #
         # @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 websocket_settings [Telnyx::Models::AI::WebsocketSettings] Streams conversation and telephony events to a WebSocket server you host, and ac
         #
         # @param widget_settings [Telnyx::Models::AI::WidgetSettings] Configuration settings for the assistant's web widget.
         #
@@ -257,23 +273,45 @@ module Telnyx
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AI::AssistantDeleteParams} for more details.
+        #
         # Delete an AI Assistant by `assistant_id`.
         #
-        # @overload delete(assistant_id, request_options: {})
+        # By default this performs a soft delete: the assistant moves to the Recently
+        # Deleted list and stays restorable for 30 days, after which it is permanently
+        # deleted automatically. The assistant's versions and TeXML application are
+        # preserved during the retention window.
+        #
+        # Pass `hard_delete=true` to skip the retention window and permanently delete the
+        # assistant immediately. A hard delete erases the assistant and all of its
+        # versions, and deletes its TeXML application unless phone numbers are still
+        # assigned to it. It does not delete conversations, recordings, shared tools the
+        # assistant referenced, or knowledge-base embeddings.
+        #
+        # Deletion fails with `400` if other assistants reference this one through a
+        # handoff tool or a conversation-flow edge — remove those references first.
+        #
+        # @overload delete(assistant_id, hard_delete: nil, request_options: {})
         #
         # @param assistant_id [String] Unique identifier of the assistant.
         #
+        # @param hard_delete [Boolean] Permanently delete the assistant immediately instead of soft-deleting it to the
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Models::AI::AssistantDeleteResponse]
         #
         # @see Telnyx::Models::AI::AssistantDeleteParams
         def delete(assistant_id, params = {})
+          parsed, options = Telnyx::AI::AssistantDeleteParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed)
           @client.request(
             method: :delete,
             path: ["ai/assistants/%1$s", assistant_id],
+            query: query,
             model: Telnyx::Models::AI::AssistantDeleteResponse,
-            options: params[:request_options]
+            options: options
           )
         end
 
@@ -399,6 +437,30 @@ module Telnyx
           )
         end
 
+        # Restore a soft-deleted assistant from the Recently Deleted list.
+        #
+        # The assistant becomes fully active again with its versions and TeXML application
+        # as they were at deletion time. Restoring does not re-enable numbers or
+        # connections that were released separately after the deletion.
+        #
+        # @overload restore(assistant_id, request_options: {})
+        #
+        # @param assistant_id [String] Unique identifier of the assistant.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AI::InferenceEmbedding]
+        #
+        # @see Telnyx::Models::AI::AssistantRestoreParams
+        def restore(assistant_id, params = {})
+          @client.request(
+            method: :post,
+            path: ["ai/assistants/%1$s/restore", assistant_id],
+            model: Telnyx::AI::InferenceEmbedding,
+            options: params[:request_options]
+          )
+        end
+
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::AI::AssistantSendSMSParams} for more details.
         #
@@ -448,6 +510,57 @@ module Telnyx
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AI::AssistantWhatsappParams} for more details.
+        #
+        # Start a WhatsApp conversation with a customer from the business side. This
+        # endpoint:
+        #
+        # 1. Validates that `from` is a WhatsApp number on your account whose messaging
+        #    profile has this assistant configured
+        # 2. Creates a new `whatsapp_chat` conversation with the provided metadata
+        # 3. Asks the assistant to pick one of its approved WhatsApp templates and fill
+        #    its variables from `content`
+        # 4. Sends the template from `from` to `to`
+        # 5. Returns the conversation ID and the message ID
+        #
+        # When the customer replies, the reply is routed to the same conversation and the
+        # assistant answers within the 24-hour customer service window. The assistant
+        # needs a `whatsapp_template` tool with at least one approved template, data
+        # retention enabled and PII redaction disabled.
+        #
+        # @overload whatsapp(assistant_id, content:, from:, to:, conversation_metadata: nil, idempotency_key: nil, request_options: {})
+        #
+        # @param assistant_id [String] Path param: Unique identifier of the assistant. Must be the assistant configured
+        #
+        # @param content [String] Body param: Instruction for the assistant, including the values for the template
+        #
+        # @param from [String] Body param: WhatsApp number on your account to send from, in E.164 format. Its m
+        #
+        # @param to [String] Body param: Customer to message, as an E.164 phone number or a WhatsApp business
+        #
+        # @param conversation_metadata [Hash{Symbol=>String, Integer, Boolean}] Body param: Metadata stored on the conversation. Keys starting with `telnyx_` an
+        #
+        # @param idempotency_key [String] Header param: Optional opaque, unquoted key for safely retrying the same logical
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AI::AssistantWhatsappResponse]
+        #
+        # @see Telnyx::Models::AI::AssistantWhatsappParams
+        def whatsapp(assistant_id, params)
+          parsed, options = Telnyx::AI::AssistantWhatsappParams.dump_request(params)
+          header_params = {idempotency_key: "idempotency-key"}
+          @client.request(
+            method: :post,
+            path: ["ai/assistants/%1$s/chat/whatsapp", assistant_id],
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
+            model: Telnyx::Models::AI::AssistantWhatsappResponse,
+            options: options
+          )
+        end
+
         # @api private
         #
         # @param client [Telnyx::Client]
@@ -460,6 +573,7 @@ module Telnyx
           @versions = Telnyx::Resources::AI::Assistants::Versions.new(client: client)
           @tags = Telnyx::Resources::AI::Assistants::Tags.new(client: client)
           @instructions = Telnyx::Resources::AI::Assistants::Instructions.new(client: client)
+          @deleted = Telnyx::Resources::AI::Assistants::Deleted.new(client: client)
         end
       end
     end

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

@@ -109,7 +109,7 @@ module Telnyx
         # can filter on any field in the metadata JSON object. For example, to filter by a
         # custom field `metadata->custom_field`, use `metadata->custom_field=eq.value`.
         #
-        # @overload list(id: nil, created_at: nil, last_message_at: nil, limit: nil, metadata_assistant_id: nil, metadata_call_control_id: nil, metadata_telnyx_agent_target: nil, metadata_telnyx_conversation_channel: nil, metadata_telnyx_end_user_target: nil, name: nil, or_: nil, order: nil, request_options: {})
+        # @overload list(id: nil, created_at: nil, last_message_at: nil, limit: nil, metadata_assistant_id: nil, metadata_assistant_version_id: nil, metadata_call_control_id: nil, metadata_telnyx_agent_target: nil, metadata_telnyx_conversation_channel: nil, metadata_telnyx_end_user_target: nil, name: nil, or_: nil, order: nil, request_options: {})
         #
         # @param id [String] Filter by conversation ID (e.g. id=eq.123)
         #
@@ -121,6 +121,8 @@ module Telnyx
         #
         # @param metadata_assistant_id [String] Filter by assistant ID (e.g., `metadata->assistant_id=eq.assistant-123`)
         #
+        # @param metadata_assistant_version_id [String] Filter by assistant version ID (e.g., `metadata->assistant_version_id=eq.2025081
+        #
         # @param metadata_call_control_id [String] Filter by call control ID (e.g., `metadata->call_control_id=eq.v3:123`)
         #
         # @param metadata_telnyx_agent_target [String] Filter by the phone number, SIP URI, or other identifier for the agent (e.g., `m
@@ -148,6 +150,7 @@ module Telnyx
             path: "ai/conversations",
             query: query.transform_keys(
               metadata_assistant_id: "metadata->assistant_id",
+              metadata_assistant_version_id: "metadata->assistant_version_id",
               metadata_call_control_id: "metadata->call_control_id",
               metadata_telnyx_agent_target: "metadata->telnyx_agent_target",
               metadata_telnyx_conversation_channel: "metadata->telnyx_conversation_channel",

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