telnyx 5.170.0 → 5.171.0

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

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      class Assistants
+        # Configure AI assistant specifications
+        class Deleted
+          # List the organization's soft-deleted assistants in the Recently Deleted list.
+          #
+          # Each entry includes `deleted_at` and `permanently_deleted_at`, the point after
+          # which the assistant is erased automatically and can no longer be restored.
+          #
+          # @overload list(page_number: nil, page_size: nil, request_options: {})
+          #
+          # @param page_number [Integer] Page number to retrieve (1-based).
+          #
+          # @param page_size [Integer] Number of items to return per page.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::AI::Assistants::DeletedAssistant>]
+          #
+          # @see Telnyx::Models::AI::Assistants::DeletedListParams
+          def list(params = {})
+            parsed, options = Telnyx::AI::Assistants::DeletedListParams.dump_request(params)
+            query = Telnyx::Internal::Util.encode_query_params(parsed)
+            @client.request(
+              method: :get,
+              path: "ai/assistants/deleted",
+              query: query.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+              page: Telnyx::Internal::DefaultFlatPagination,
+              model: Telnyx::AI::Assistants::DeletedAssistant,
+              options: options
+            )
+          end
+
+          # Retrieve a soft-deleted assistant from the Recently Deleted list by
+          # `assistant_id`, including its `deleted_at` and `permanently_deleted_at`
+          # timestamps. This is a read-only view; the assistant cannot be modified while it
+          # remains deleted.
+          #
+          # @overload get(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::Assistants::DeletedAssistant]
+          #
+          # @see Telnyx::Models::AI::Assistants::DeletedGetParams
+          def get(assistant_id, params = {})
+            @client.request(
+              method: :get,
+              path: ["ai/assistants/%1$s/deleted", assistant_id],
+              model: Telnyx::AI::Assistants::DeletedAssistant,
+              options: params[:request_options]
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Telnyx::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

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
@@ -107,6 +111,8 @@ module Telnyx
           #
           # @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.
           #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]

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
@@ -97,6 +105,8 @@ module Telnyx
         #
         # @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.
         #
         # @param idempotency_key [String] Header param: Optional opaque, unquoted key for safely retrying the same logical
@@ -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
@@ -221,6 +235,8 @@ module Telnyx
         #
         # @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.
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -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.rb

@@ -123,6 +123,47 @@ module Telnyx
               )
             end
 
+            # Some parameter documentations has been truncated, see
+            # {Telnyx::Models::AI::Memory::Namespaces::ProfilePreviewParams} for more details.
+            #
+            # Try a candidate note on one profile and see how that profile's summary would
+            # read under it, without saving the note and without touching the stored summary.
+            # Composes the same source query the apply path
+            # (`PATCH /ai/memory/namespaces/{namespace}/settings`) would use, so a preview
+            # cannot drift from what saving the note would produce. Reads the candidate alone
+            # -- the namespace's current instructions and the profile's stored summary are
+            # neither read nor replaced. Bounded at 120 seconds: the summary is generated on
+            # the spot rather than read from a stored one. Nothing about the request is
+            # stored.
+            #
+            # @overload preview(profile_id, namespace:, instructions: nil, request_options: {})
+            #
+            # @param profile_id [String] Path param: The profile: your identifier for the user, caller or agent this memo
+            #
+            # @param namespace [String] Path param: The namespace. `default` exists for every organization.
+            #
+            # @param instructions [String, nil] Body param: The candidate note to try. `null`, empty, or whitespace-only preview
+            #
+            # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [Telnyx::Models::AI::Memory::Namespaces::ProfilePreviewResponse]
+            #
+            # @see Telnyx::Models::AI::Memory::Namespaces::ProfilePreviewParams
+            def preview(profile_id, params)
+              parsed, options = Telnyx::AI::Memory::Namespaces::ProfilePreviewParams.dump_request(params)
+              namespace =
+                parsed.delete(:namespace) do
+                  raise ArgumentError.new("missing required path argument #{_1}")
+                end
+              @client.request(
+                method: :post,
+                path: ["ai/memory/namespaces/%1$s/profiles/%2$s/summary/preview", namespace, profile_id],
+                body: parsed,
+                model: Telnyx::Models::AI::Memory::Namespaces::ProfilePreviewResponse,
+                options: options
+              )
+            end
+
             # Ranked memories for a question. Matching runs over the profile's memories and
             # returns them in rank order with a relevance `score`; the score is null where the
             # deployment's reranker is a passthrough, in which case order is the only signal.

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

@@ -4,7 +4,6 @@ module Telnyx
   module Resources
     class AI
       class Memory
-        # Whether a write has finished.
         class Namespaces
           # @return [Telnyx::Resources::AI::Memory::Namespaces::Profiles]
           attr_reader :profiles
@@ -13,6 +12,29 @@ module Telnyx
           # @return [Telnyx::Resources::AI::Memory::Namespaces::Settings]
           attr_reader :settings
 
+          # Create a namespace. An organization can have at most five, `default` among them
+          # — a sixth returns `403`.
+          #
+          # @overload create(name:, request_options: {})
+          #
+          # @param name [String] A name for the new namespace, unique within your organization.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::AI::Memory::NamespaceCreateResponse]
+          #
+          # @see Telnyx::Models::AI::Memory::NamespaceCreateParams
+          def create(params)
+            parsed, options = Telnyx::AI::Memory::NamespaceCreateParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: "ai/memory/namespaces",
+              body: parsed,
+              model: Telnyx::Models::AI::Memory::NamespaceCreateResponse,
+              options: options
+            )
+          end
+
           # Whether a write has finished. Both `ingest` and `remember` return an
           # `operation_id`, and a memory is not recallable until its operation completes —
           # extraction, embedding and consolidation all run first.
@@ -40,6 +62,45 @@ module Telnyx
             )
           end
 
+          # Every namespace in your organization, `default` among them.
+          #
+          # @overload list(request_options: {})
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::AI::Memory::NamespaceListResponse]
+          #
+          # @see Telnyx::Models::AI::Memory::NamespaceListParams
+          def list(params = {})
+            @client.request(
+              method: :get,
+              path: "ai/memory/namespaces",
+              model: Telnyx::Models::AI::Memory::NamespaceListResponse,
+              options: params[:request_options]
+            )
+          end
+
+          # Delete a namespace and every profile and memory in it. `default` cannot be
+          # deleted. This cannot be undone.
+          #
+          # @overload delete(namespace, request_options: {})
+          #
+          # @param namespace [String] The namespace to delete. `default` cannot be deleted.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [nil]
+          #
+          # @see Telnyx::Models::AI::Memory::NamespaceDeleteParams
+          def delete(namespace, params = {})
+            @client.request(
+              method: :delete,
+              path: ["ai/memory/namespaces/%1$s", namespace],
+              model: NilClass,
+              options: params[:request_options]
+            )
+          end
+
           # @api private
           #
           # @param client [Telnyx::Client]

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

@@ -4,7 +4,6 @@ module Telnyx
   module Resources
     class AI
       class Memory
-        # Whether a write has finished.
         # @return [Telnyx::Resources::AI::Memory::Namespaces]
         attr_reader :namespaces
 

data/lib/telnyx/resources/ai/openai/chat.rb

@@ -31,7 +31,7 @@ module Telnyx
           #
           # @param logprobs [Boolean] Whether to return log probabilities of the output tokens or not. If true, return
           #
-          # @param max_tokens [Integer] Maximum number of completion tokens the model should generate.
+          # @param max_tokens [Integer, nil] Maximum number of completion (output) tokens, including reasoning and answer tok
           #
           # @param min_p [Float] This is an alternative to `top_p` that [many prefer](https://github.com/huggingf
           #

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

@@ -161,14 +161,14 @@ module Telnyx
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Object]
+        # @return [nil]
         #
         # @see Telnyx::Models::AI::ToolDeleteParams
         def delete(tool_id, params = {})
           @client.request(
             method: :delete,
             path: ["ai/tools/%1$s", tool_id],
-            model: Telnyx::Internal::Type::Unknown,
+            model: NilClass,
             options: params[:request_options]
           )
         end

data/lib/telnyx/resources/calls/actions.rb

@@ -44,9 +44,33 @@ module Telnyx
         # Answer an incoming call. You must issue this command before executing subsequent
         # commands on an incoming call.
         #
+        # To answer with an AI assistant, include `assistant.id` and any per-call
+        # overrides in the `assistant` object. Telnyx attempts to warm up the assistant
+        # before answering the call, then starts the assistant automatically when the call
+        # is answered. Do not also send `ai_assistant_start` for this flow. The HTTP
+        # success response can arrive before the call is answered; use the `call.answered`
+        # webhook to track the answer. If warm-up fails, Telnyx falls back to starting the
+        # assistant after answering.
+        #
+        # When `assistant.id` is supplied, obtain the conversation ID from
+        # `data.payload.conversation_id` in the
+        # [call.conversation.created](/api-reference/callbacks/call-conversation-created)
+        # webhook and correlate it using `data.payload.call_control_id`. The `answer` HTTP
+        # response does not include `conversation_id`. The created event is emitted during
+        # assistant startup and does not indicate that the assistant is ready to speak.
+        #
+        # Set the assistant voice with `assistant.voice_settings.voice` and speech-to-text
+        # settings with `assistant.transcription`. You can reuse one stored assistant with
+        # different per-call settings. Warm-up prepares assistant configuration and
+        # dependencies; it does not wait for the greeting audio to be ready or guarantee
+        # zero silence after answer. A plain `answer` followed by `ai_assistant_start`
+        # performs assistant startup after the call has already been answered.
+        #
         # **Expected Webhooks:**
         #
         # - `call.answered`
+        # - `call.conversation.created` when the requested assistant conversation is
+        #   created
         # - `call.hold` and `call.unhold` if the call is held/unheld
         # - `call.deepfake_detection.result` if `deepfake_detection` was enabled
         # - `call.deepfake_detection.error` if `deepfake_detection` was enabled and an
@@ -61,7 +85,7 @@ module Telnyx
         #
         # @param call_control_id [String] Unique identifier and token for controlling the call
         #
-        # @param assistant [Telnyx::Models::CallAssistantRequest] AI Assistant configuration. All fields except `id` are optional — the assistant'
+        # @param assistant [Telnyx::Models::CallAssistantRequest] AI Assistant configuration and per-call overrides. All fields except `id` are op
         #
         # @param billing_group_id [String] Use this field to set the Billing Group ID for the call. Must be a valid and exi
         #
@@ -112,7 +136,7 @@ module Telnyx
         #
         # @param stream_url [String] The destination WebSocket address where the stream is going to be delivered.
         #
-        # @param transcription [Boolean] Enable transcription upon call answer. The default value is false.
+        # @param transcription [Boolean] Enable standalone call transcription upon call answer. The default value is fals
         #
         # @param transcription_config [Telnyx::Models::Calls::TranscriptionStartRequest]
         #
@@ -314,6 +338,8 @@ module Telnyx
         #
         # **Expected Webhooks:**
         #
+        # - [`call.conversation.created`](/api-reference/callbacks/call-conversation-created)
+        #   includes `conversation_id` during startup
         # - `call.ai_gather.ended`
         # - `call.conversation.ended`
         # - `call.ai_gather.partial_results` (if `send_partial_results` is set to `true`)
@@ -661,7 +687,7 @@ module Telnyx
         # The UnionPay and Maestro numbers are accepted for processor testing, but Pay
         # currently does not emit a card type for them.
         #
-        # @overload pay(call_control_id, amount: nil, client_state: nil, command_id: nil, connector_name: nil, currency: nil, description: nil, inter_digit_timeout_millis: nil, language: nil, max_attempts: nil, metadata: nil, parameters: nil, payment_method: nil, payment_token: nil, prompts: nil, service_level: nil, timeout_millis: nil, transaction_type: nil, valid_card_types: nil, voice: nil, request_options: {})
+        # @overload pay(call_control_id, amount: nil, client_state: nil, command_id: nil, connector_name: nil, currency: nil, description: nil, inter_digit_timeout_millis: nil, language: nil, max_attempts: nil, metadata: nil, min_postal_code_length: nil, parameters: nil, payment_method: nil, payment_token: nil, postal_code: nil, prompts: nil, service_level: nil, timeout_millis: nil, transaction_type: nil, valid_card_types: nil, voice: nil, request_options: {})
         #
         # @param call_control_id [String] Unique identifier and token for controlling the call
         #
@@ -685,12 +711,16 @@ module Telnyx
         #
         # @param metadata [Hash{Symbol=>Object}] Metadata forwarded to the Pay connector.
         #
+        # @param min_postal_code_length [Integer] Minimum number of digits the caller must enter when collecting a credit-card bil
+        #
         # @param parameters [Hash{Symbol=>Object}] Additional parameters forwarded to the Pay connector.
         #
         # @param payment_method [Symbol, Telnyx::Models::Calls::ActionPayParams::PaymentMethod] Payment method to collect.
         #
         # @param payment_token [String] Existing payment token. When supplied, payment-detail collection is skipped.
         #
+        # @param postal_code [String, Boolean] Controls billing postal code collection for credit-card payments when no `paymen
+        #
         # @param prompts [Telnyx::Models::Calls::ActionPayParams::Prompts] Custom text-to-speech prompts keyed by payment collection step.
         #
         # @param service_level [String] Speech synthesis service level used for payment prompts. Pay defaults to `premiu
@@ -778,7 +808,7 @@ module Telnyx
         #
         # @param call_control_id [String] Unique identifier and token for controlling the call
         #
-        # @param cause [Symbol, Telnyx::Models::Calls::ActionRejectParams::Cause] Cause for call rejection.
+        # @param cause [Symbol, Telnyx::Models::Calls::ActionRejectParams::Cause] Cause for call rejection. The cause sets the SIP response the caller receives: `
         #
         # @param client_state [String] Use this field to add state to every subsequent webhook. It must be a valid Base
         #
@@ -972,6 +1002,8 @@ module Telnyx
         #
         # **Expected Webhooks:**
         #
+        # - [`call.conversation.created`](/api-reference/callbacks/call-conversation-created)
+        #   includes `conversation_id` during startup
         # - `call.conversation.ended`
         # - `call.conversation_insights.generated`
         #
@@ -979,7 +1011,7 @@ module Telnyx
         #
         # @param call_control_id [String] Unique identifier and token for controlling the call
         #
-        # @param assistant [Telnyx::Models::CallAssistantRequest] AI Assistant configuration. All fields except `id` are optional — the assistant'
+        # @param assistant [Telnyx::Models::CallAssistantRequest] AI Assistant configuration and per-call overrides. All fields except `id` are op
         #
         # @param client_state [String] Use this field to add state to every subsequent webhook. It must be a valid Base
         #
@@ -1068,7 +1100,7 @@ module Telnyx
         #
         # @param transcription_engine [Symbol, Telnyx::Models::Calls::ActionStartConversationRelayParams::TranscriptionEngine] Engine to use for speech recognition. Legacy values `A` - `Google`, `B` - `Telny
         #
-        # @param transcription_engine_config [Hash{Symbol=>Object}] Engine-specific transcription settings for Conversation Relay. This accepts the
+        # @param transcription_engine_config [Telnyx::Models::Calls::ConversationRelayTranscriptionEngineConfig] Engine-specific transcription settings for Conversation Relay. This accepts the
         #
         # @param tts_provider [String] Text-to-speech provider. If omitted, Telnyx derives it from `voice` or `provider
         #
@@ -1817,6 +1849,9 @@ module Telnyx
         #   `answering_machine_detection=premium` was requested
         # - `call.machine.premium.greeting.ended` if `answering_machine_detection=premium`
         #   was requested and a beep was detected
+        # - `call.machine.premium.call_screening.detected` if
+        #   `answering_machine_detection=premium_ios_call_screening_detection` was
+        #   requested and an Apple Call Screening tone was detected
         #
         # @overload transfer(call_control_id, to:, answering_machine_detection: nil, answering_machine_detection_config: nil, audio_url: nil, client_state: nil, command_id: nil, custom_headers: nil, diversion: nil, early_media: nil, from: nil, from_display_name: nil, media_encryption: nil, media_name: nil, mute_dtmf: nil, park_after_unbridge: nil, preferred_codecs: nil, privacy: nil, record: nil, record_channels: nil, record_custom_file_name: nil, record_format: nil, record_max_length: nil, record_timeout_secs: nil, record_track: nil, record_trim: nil, route_to_mobile: nil, send_digits_on_answer: nil, sip_auth_password: nil, sip_auth_username: nil, sip_headers: nil, sip_region: nil, sip_transport_protocol: nil, sound_modifications: nil, target_leg_client_state: nil, time_limit_secs: nil, timeout_secs: nil, webhook_retries_policies: nil, webhook_url: nil, webhook_url_method: nil, webhook_urls: nil, webhook_urls_method: nil, request_options: {})
         #