telnyx 5.170.0 → 5.171.0

data/rbi/telnyx/resources/ai/assistants.rbi

@@ -33,6 +33,10 @@ module Telnyx
         sig { returns(Telnyx::Resources::AI::Assistants::Instructions) }
         attr_reader :instructions
 
+        # Configure AI assistant specifications
+        sig { returns(Telnyx::Resources::AI::Assistants::Deleted) }
+        attr_reader :deleted
+
         # Creates a new AI assistant from the provided configuration, including its model,
         # instructions, and attached tools, and returns the created assistant.
         sig do
@@ -40,7 +44,10 @@ module Telnyx
             instructions: String,
             name: String,
             a2a_agents: T::Array[Telnyx::AI::AssistantA2AAgent::OrHash],
+            avatar_settings:
+              T.nilable(Telnyx::AI::AvatarSettingsRequest::OrHash),
             conversation_flow: Telnyx::AI::ConversationFlowReq::OrHash,
+            delegation_settings: Telnyx::AI::DelegationSettings::OrHash,
             description: String,
             dynamic_variables: T::Hash[Symbol, T.anything],
             dynamic_variables_webhook_timeout_ms: Integer,
@@ -85,6 +92,7 @@ module Telnyx
               ],
             transcription: Telnyx::AI::TranscriptionSettings::OrHash,
             voice_settings: Telnyx::AI::InferenceEmbeddingVoiceSettings::OrHash,
+            websocket_settings: Telnyx::AI::WebsocketSettings::OrHash,
             widget_settings: Telnyx::AI::WidgetSettings::OrHash,
             idempotency_key: String,
             request_options: Telnyx::RequestOptions::OrHash
@@ -105,12 +113,24 @@ module Telnyx
           # card fetches combined. An agent whose card cannot be fetched costs the assistant
           # that capability for the conversation; it does not fail the call.
           a2a_agents: nil,
+          # Body param: **Beta:** Configuration for the Telnyx open-source avatar provider.
+          # The launch catalog supports six avatars and office, studio, or reception
+          # backgrounds.
+          avatar_settings: nil,
           # Body param: Conversation flow as supplied by API clients (create / update).
           #
           # A directed graph of `FlowNodeReq` connected by `FlowEdge`s. Validation enforces
           # unique node/edge IDs, that `start_node_id` references a real node, and that
           # every edge's endpoints reference real nodes.
           conversation_flow: nil,
+          # Body param: Splits the conversation between a frontend model that talks to the
+          # caller and a backend model that does the work. On the GPT-Live route the
+          # frontend model cannot call tools at all — when it needs something done it raises
+          # a delegation and waits. On the chat completion route the frontend keeps a single
+          # `delegate` tool that returns immediately, so the conversation carries on while
+          # the backend works. Either way the backend's answer is spoken as commentary or
+          # kept as silent context, depending on `speak_results`. Beta feature.
+          delegation_settings: nil,
           # Body param
           description: nil,
           # Body param: Map of dynamic variables and their default values
@@ -202,6 +222,12 @@ module Telnyx
           transcription: nil,
           # Body param
           voice_settings: nil,
+          # Body param: Streams conversation and telephony events to a WebSocket server you
+          # host, and accepts messages injected back into the conversation. Telnyx opens the
+          # connection as a client, once per conversation. Delivery is best effort
+          # throughout: while the connection is down events are dropped rather than queued,
+          # and no socket failure is ever allowed to affect the call. Beta feature.
+          websocket_settings: nil,
           # Body param: Configuration settings for the assistant's web widget.
           widget_settings: nil,
           # Header param: Optional opaque, unquoted key for safely retrying the same logical
@@ -250,7 +276,10 @@ module Telnyx
           params(
             assistant_id: String,
             a2a_agents: T::Array[Telnyx::AI::AssistantA2AAgent::OrHash],
+            avatar_settings:
+              T.nilable(Telnyx::AI::AvatarSettingsRequest::OrHash),
             conversation_flow: Telnyx::AI::ConversationFlowReq::OrHash,
+            delegation_settings: Telnyx::AI::DelegationSettings::OrHash,
             description: String,
             dynamic_variables: T::Hash[Symbol, T.anything],
             dynamic_variables_webhook_timeout_ms: Integer,
@@ -299,6 +328,7 @@ module Telnyx
             transcription: Telnyx::AI::TranscriptionSettings::OrHash,
             version_name: String,
             voice_settings: Telnyx::AI::InferenceEmbeddingVoiceSettings::OrHash,
+            websocket_settings: Telnyx::AI::WebsocketSettings::OrHash,
             widget_settings: Telnyx::AI::WidgetSettings::OrHash,
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(Telnyx::AI::InferenceEmbedding)
@@ -316,12 +346,23 @@ module Telnyx
           # capability for the conversation; it does not fail the call. Omit this field to
           # leave the assistant's agents unchanged; send an empty array to remove them all.
           a2a_agents: nil,
+          # **Beta:** Configuration for the Telnyx open-source avatar provider. The launch
+          # catalog supports six avatars and office, studio, or reception backgrounds.
+          avatar_settings: nil,
           # Conversation flow as supplied by API clients (create / update).
           #
           # A directed graph of `FlowNodeReq` connected by `FlowEdge`s. Validation enforces
           # unique node/edge IDs, that `start_node_id` references a real node, and that
           # every edge's endpoints reference real nodes.
           conversation_flow: nil,
+          # Splits the conversation between a frontend model that talks to the caller and a
+          # backend model that does the work. On the GPT-Live route the frontend model
+          # cannot call tools at all — when it needs something done it raises a delegation
+          # and waits. On the chat completion route the frontend keeps a single `delegate`
+          # tool that returns immediately, so the conversation carries on while the backend
+          # works. Either way the backend's answer is spoken as commentary or kept as silent
+          # context, depending on `speak_results`. Beta feature.
+          delegation_settings: nil,
           description: nil,
           # Map of dynamic variables and their default values
           dynamic_variables: nil,
@@ -421,6 +462,12 @@ module Telnyx
           # Human-readable name for the assistant version.
           version_name: nil,
           voice_settings: nil,
+          # Streams conversation and telephony events to a WebSocket server you host, and
+          # accepts messages injected back into the conversation. Telnyx opens the
+          # connection as a client, once per conversation. Delivery is best effort
+          # throughout: while the connection is down events are dropped rather than queued,
+          # and no socket failure is ever allowed to affect the call. Beta feature.
+          websocket_settings: nil,
           # Configuration settings for the assistant's web widget.
           widget_settings: nil,
           request_options: {}
@@ -437,15 +484,33 @@ module Telnyx
         end
 
         # Delete an AI Assistant by `assistant_id`.
+        #
+        # 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.
         sig do
           params(
             assistant_id: String,
+            hard_delete: T::Boolean,
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(Telnyx::Models::AI::AssistantDeleteResponse)
         end
         def delete(
           # Unique identifier of the assistant.
           assistant_id,
+          # Permanently delete the assistant immediately instead of soft-deleting it to the
+          # Recently Deleted list, where it stays restorable for 30 days.
+          hard_delete: nil,
           request_options: {}
         )
         end
@@ -560,6 +625,24 @@ 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.
+        sig do
+          params(
+            assistant_id: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::AI::InferenceEmbedding)
+        end
+        def restore(
+          # Unique identifier of the assistant.
+          assistant_id,
+          request_options: {}
+        )
+        end
+
         # Send an SMS message for an assistant. This endpoint:
         #
         # 1. Validates the assistant exists and has messaging profile configured
@@ -613,6 +696,65 @@ module Telnyx
         )
         end
 
+        # 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.
+        sig do
+          params(
+            assistant_id: String,
+            content: String,
+            from: String,
+            to: String,
+            conversation_metadata:
+              T::Hash[
+                Symbol,
+                Telnyx::AI::AssistantWhatsappParams::ConversationMetadata::Variants
+              ],
+            idempotency_key: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::Models::AI::AssistantWhatsappResponse)
+        end
+        def whatsapp(
+          # Path param: Unique identifier of the assistant. Must be the assistant configured
+          # on the messaging profile of the `from` number.
+          assistant_id,
+          # Body param: Instruction for the assistant, including the values for the template
+          # variables, e.g. `Send the login verification code 482913 to the customer.`
+          content:,
+          # Body param: WhatsApp number on your account to send from, in E.164 format. Its
+          # messaging profile must have this assistant configured.
+          from:,
+          # Body param: Customer to message, as an E.164 phone number or a WhatsApp
+          # business-scoped user ID (BSUID).
+          to:,
+          # Body param: Metadata stored on the conversation. Keys starting with `telnyx_`
+          # and the `assistant_id` key are reserved.
+          conversation_metadata: nil,
+          # Header param: Optional opaque, unquoted key for safely retrying the same logical
+          # request. Keys must contain 1 to 255 letters, numbers, hyphens, or underscores.
+          # Generate a unique UUID v4 for each operation and reuse it only when retrying
+          # that operation with the same request. Invalid headers—including duplicate,
+          # empty, malformed, or overlong values—return 400 with error code 10015. A request
+          # already in progress with the same key returns 409; reusing the key with a
+          # different request returns 422. Only successful responses are replayed, for up to
+          # 24 hours. Do not include sensitive data in the key.
+          idempotency_key: nil,
+          request_options: {}
+        )
+        end
+
         # @api private
         sig { params(client: Telnyx::Client).returns(T.attached_class) }
         def self.new(client:)

data/rbi/telnyx/resources/ai/conversations.rbi

@@ -97,6 +97,7 @@ module Telnyx
             last_message_at: String,
             limit: Integer,
             metadata_assistant_id: String,
+            metadata_assistant_version_id: String,
             metadata_call_control_id: String,
             metadata_telnyx_agent_target: String,
             metadata_telnyx_conversation_channel: String,
@@ -118,6 +119,12 @@ module Telnyx
           limit: nil,
           # Filter by assistant ID (e.g., `metadata->assistant_id=eq.assistant-123`)
           metadata_assistant_id: nil,
+          # Filter by assistant version ID (e.g.,
+          # `metadata->assistant_version_id=eq.20250812T114318034399`). The version that
+          # handled the conversation is stored in metadata when the conversation starts;
+          # conversations created before this field was tracked, or that never resolved a
+          # version, have no `assistant_version_id` and do not match this filter.
+          metadata_assistant_version_id: nil,
           # Filter by call control ID (e.g., `metadata->call_control_id=eq.v3:123`)
           metadata_call_control_id: nil,
           # Filter by the phone number, SIP URI, or other identifier for the agent (e.g.,

data/rbi/telnyx/resources/ai/memory/namespaces/profiles.rbi

@@ -106,6 +106,41 @@ module Telnyx
             )
             end
 
+            # 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.
+            sig do
+              params(
+                profile_id: String,
+                namespace: String,
+                instructions: T.nilable(String),
+                request_options: Telnyx::RequestOptions::OrHash
+              ).returns(
+                Telnyx::Models::AI::Memory::Namespaces::ProfilePreviewResponse
+              )
+            end
+            def preview(
+              # Path param: The profile: your identifier for the user, caller or agent this
+              # memory is about.
+              profile_id,
+              # Path param: The namespace. `default` exists for every organization.
+              namespace:,
+              # Body param: The candidate note to try. `null`, empty, or whitespace-only
+              # previews the neutral default -- the summary a profile returns to when
+              # instructions are cleared. Capped at 2000 characters, the same cap
+              # `PATCH /settings` applies on save; a longer note is refused with `422` before
+              # anything is generated.
+              instructions: nil,
+              request_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/rbi/telnyx/resources/ai/memory/namespaces.rbi

@@ -4,7 +4,6 @@ module Telnyx
   module Resources
     class AI
       class Memory
-        # Whether a write has finished.
         class Namespaces
           sig { returns(Telnyx::Resources::AI::Memory::Namespaces::Profiles) }
           attr_reader :profiles
@@ -13,6 +12,21 @@ module Telnyx
           sig { returns(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`.
+          sig do
+            params(
+              name: String,
+              request_options: Telnyx::RequestOptions::OrHash
+            ).returns(Telnyx::Models::AI::Memory::NamespaceCreateResponse)
+          end
+          def create(
+            # A name for the new namespace, unique within your organization.
+            name:,
+            request_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.
@@ -26,6 +40,30 @@ module Telnyx
           def retrieve(operation_id, namespace:, request_options: {})
           end
 
+          # Every namespace in your organization, `default` among them.
+          sig do
+            params(request_options: Telnyx::RequestOptions::OrHash).returns(
+              Telnyx::Models::AI::Memory::NamespaceListResponse
+            )
+          end
+          def list(request_options: {})
+          end
+
+          # Delete a namespace and every profile and memory in it. `default` cannot be
+          # deleted. This cannot be undone.
+          sig do
+            params(
+              namespace: String,
+              request_options: Telnyx::RequestOptions::OrHash
+            ).void
+          end
+          def delete(
+            # The namespace to delete. `default` cannot be deleted.
+            namespace,
+            request_options: {}
+          )
+          end
+
           # @api private
           sig { params(client: Telnyx::Client).returns(T.attached_class) }
           def self.new(client:)

data/rbi/telnyx/resources/ai/memory.rbi

@@ -4,7 +4,6 @@ module Telnyx
   module Resources
     class AI
       class Memory
-        # Whether a write has finished.
         sig { returns(Telnyx::Resources::AI::Memory::Namespaces) }
         attr_reader :namespaces
 

data/rbi/telnyx/resources/ai/openai/chat.rbi

@@ -20,7 +20,7 @@ module Telnyx
               frequency_penalty: Float,
               length_penalty: Float,
               logprobs: T::Boolean,
-              max_tokens: Integer,
+              max_tokens: T.nilable(Integer),
               min_p: Float,
               mode: Telnyx::AI::ChatCompletionRequest::Mode::OrSymbol,
               model: String,
@@ -82,7 +82,26 @@ module Telnyx
             # returns the log probabilities of each output token returned in the `content` of
             # `message`.
             logprobs: nil,
-            # Maximum number of completion tokens the model should generate.
+            # Maximum number of completion (output) tokens, including reasoning and answer
+            # tokens combined. An omitted or null limit defaults to 8192 unless the model is
+            # excluded from that default; excluded models leave the limit to the serving
+            # engine. Explicit values and applied defaults are clamped to the model's
+            # max_completion_tokens metadata when that ceiling is set (see GET
+            # /v2/ai/openai/models). An omitted limit on an excluded model remains unset even
+            # when metadata declares a ceiling. Input and output together must fit the model's
+            # context window. Set an explicit limit when a bounded generation budget is
+            # required. For current Telnyx-hosted models, omitted or null limits default to
+            # 8192 for `zai-org/GLM-5.3`, `zai-org/GLM-5.3-Flash` and
+            # `deepseek-ai/DeepSeek-V4.1-Flash`. The hosted exclusions are
+            # `moonshotai/Kimi-K3`, `moonshotai/Kimi-K2.6`, `moonshotai/Kimi-K2.5`,
+            # `zai-org/GLM-5.2`, `zai-org/GLM-5.1-FP8`, `MiniMaxAI/MiniMax-M3-MXFP8`,
+            # `MiniMaxAI/MiniMax-M2.7`, `Qwen/Qwen3.8-27B`, `Qwen/Qwen3-235B-A22B`,
+            # `deepseek-ai/DeepSeek-V4-Flash-0731`, `meta-llama/Llama-3.3-70B-Instruct`,
+            # `meta-llama/Meta-Llama-3.1-70B-Instruct`,
+            # `meta-llama/Meta-Llama-3.1-8B-Instruct` and `google/gemma-2b-it`. Legacy
+            # external and fine-tuned model IDs can also bypass the default; model discovery
+            # reports completion ceilings, not whether this default applies. Set an explicit
+            # limit for predictable behavior across models.
             max_tokens: nil,
             # This is an alternative to `top_p` that
             # [many prefer](https://github.com/huggingface/transformers/issues/27670). Must be

data/rbi/telnyx/resources/ai/tools.rbi

@@ -144,7 +144,7 @@ module Telnyx
           params(
             tool_id: String,
             request_options: Telnyx::RequestOptions::OrHash
-          ).returns(T.anything)
+          ).void
         end
         def delete(
           # Unique identifier of the tool.

data/rbi/telnyx/resources/calls/actions.rbi

@@ -47,9 +47,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
@@ -118,9 +142,11 @@ module Telnyx
         def answer(
           # Unique identifier and token for controlling the call
           call_control_id,
-          # AI Assistant configuration. All fields except `id` are optional — the
-          # assistant's stored configuration will be used as fallback for any omitted
-          # fields.
+          # AI Assistant configuration and per-call overrides. All fields except `id` are
+          # optional. Omitted assistant fields use the stored configuration. Supplied
+          # `voice_settings` and `transcription` objects replace their stored objects rather
+          # than merging individual settings; include every setting you want to retain.
+          # `dynamic_variables` are merged, with request values taking precedence.
           assistant: nil,
           # Use this field to set the Billing Group ID for the call. Must be a valid and
           # existing Billing Group ID.
@@ -196,7 +222,9 @@ module Telnyx
           stream_track: nil,
           # The destination WebSocket address where the stream is going to be delivered.
           stream_url: nil,
-          # Enable transcription upon call answer. The default value is false.
+          # Enable standalone call transcription upon call answer. The default value is
+          # false. Configure this feature with `transcription_config`. To configure speech
+          # recognition for an AI assistant, use `assistant.transcription` instead.
           transcription: nil,
           transcription_config: nil,
           # A map of event types to retry policies. Each retry policy contains an array of
@@ -435,6 +463,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`)
@@ -530,10 +560,10 @@ module Telnyx
           #   the `VoiceId` (e.g., `AWS.Polly.Joanna-Neural`). Check the
           #   [available voices](https://docs.aws.amazon.com/polly/latest/dg/available-voices.html)
           #   for compatibility.
-          # - **Azure:** Use `Azure.<VoiceId>. (e.g. Azure.en-CA-ClaraNeural,
-          #   Azure.en-CA-LiamNeural, Azure.en-US-BrianMultilingualNeural,
-          #   Azure.en-US-Ava:DragonHDLatestNeural. For a complete list of voices, go to
-          #   [Azure Voice Gallery](https://speech.microsoft.com/portal/voicegallery).)
+          # - **Azure:** Use `Azure.<VoiceId>` (e.g., `Azure.en-CA-ClaraNeural`,
+          #   `Azure.en-CA-LiamNeural`, `Azure.en-US-BrianMultilingualNeural`,
+          #   `Azure.en-US-Ava:DragonHDLatestNeural`). For a complete list of voices, go to
+          #   [Azure Voice Gallery](https://speech.microsoft.com/portal/voicegallery).
           # - **ElevenLabs:** Use `ElevenLabs.<ModelId>.<VoiceId>` (e.g.,
           #   `ElevenLabs.BaseModel.John`). The `ModelId` part is optional. To use
           #   ElevenLabs, you must provide your ElevenLabs API key as an integration secret
@@ -950,10 +980,12 @@ module Telnyx
             language: String,
             max_attempts: Integer,
             metadata: T::Hash[Symbol, T.anything],
+            min_postal_code_length: Integer,
             parameters: T::Hash[Symbol, T.anything],
             payment_method:
               Telnyx::Calls::ActionPayParams::PaymentMethod::OrSymbol,
             payment_token: String,
+            postal_code: Telnyx::Calls::ActionPayParams::PostalCode::Variants,
             prompts: Telnyx::Calls::ActionPayParams::Prompts::OrHash,
             service_level: String,
             timeout_millis: Integer,
@@ -989,12 +1021,27 @@ module Telnyx
           max_attempts: nil,
           # Metadata forwarded to the Pay connector.
           metadata: nil,
+          # Minimum number of digits the caller must enter when collecting a credit-card
+          # billing postal code. Applies only when `postal_code` is `true` or `"true"` and
+          # no `payment_token` is supplied. The default is 1. The maximum number of digits
+          # collected is the greater of 10 and this value. This does not validate the length
+          # of a postal code supplied directly in `postal_code`.
+          min_postal_code_length: nil,
           # Additional parameters forwarded to the Pay connector.
           parameters: nil,
           # Payment method to collect.
           payment_method: nil,
           # Existing payment token. When supplied, payment-detail collection is skipped.
           payment_token: nil,
+          # Controls billing postal code collection for credit-card payments when no
+          # `payment_token` is supplied. Set to `true` or the string `"true"` (the default)
+          # to prompt the caller for a postal code. Set to `false` or the string `"false"`
+          # to skip the postal code prompt without supplying a postal code to the payment
+          # connector. Supply any other non-empty string, such as `"90210"`, to use that
+          # postal code without prompting. Empty or whitespace-only strings are rejected.
+          # This option does not affect ACH debit payments or payments using an existing
+          # token.
+          postal_code: nil,
           # Custom text-to-speech prompts keyed by payment collection step.
           prompts: nil,
           # Speech synthesis service level used for payment prompts. Pay defaults to
@@ -1081,7 +1128,10 @@ module Telnyx
         def reject(
           # Unique identifier and token for controlling the call
           call_control_id,
-          # Cause for call rejection.
+          # Cause for call rejection. The cause sets the SIP response the caller receives:
+          # `USER_BUSY` sends 486 User Busy, `CALL_REJECTED` sends 603 Decline, `NOT_FOUND`
+          # sends 404 Not Found, and `TEMPORARILY_UNAVAILABLE` sends 480 Temporarily
+          # Unavailable.
           cause:,
           # Use this field to add state to every subsequent webhook. It must be a valid
           # Base-64 encoded string.
@@ -1328,6 +1378,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`
         sig do
@@ -1358,9 +1410,11 @@ module Telnyx
         def start_ai_assistant(
           # Unique identifier and token for controlling the call
           call_control_id,
-          # AI Assistant configuration. All fields except `id` are optional — the
-          # assistant's stored configuration will be used as fallback for any omitted
-          # fields.
+          # AI Assistant configuration and per-call overrides. All fields except `id` are
+          # optional. Omitted assistant fields use the stored configuration. Supplied
+          # `voice_settings` and `transcription` objects replace their stored objects rather
+          # than merging individual settings; include every setting you want to retain.
+          # `dynamic_variables` are merged, with request values taking precedence.
           assistant: nil,
           # Use this field to add state to every subsequent webhook. It must be a valid
           # Base-64 encoded string.
@@ -1431,7 +1485,8 @@ module Telnyx
             transcription: T::Hash[Symbol, T.anything],
             transcription_engine:
               Telnyx::Calls::ActionStartConversationRelayParams::TranscriptionEngine::OrSymbol,
-            transcription_engine_config: T::Hash[Symbol, T.anything],
+            transcription_engine_config:
+              Telnyx::Calls::ConversationRelayTranscriptionEngineConfig::OrHash,
             tts_provider: String,
             url: String,
             voice: String,
@@ -1512,7 +1567,10 @@ module Telnyx
           # Engine-specific transcription settings for Conversation Relay. This accepts the
           # same provider-specific options used by the Call Transcription Start command,
           # such as `transcription_model`, without requiring the engine discriminator to be
-          # repeated inside this object.
+          # repeated inside this object. With Deepgram Flux (`deepgram/flux`),
+          # `interim_results`, `eot_threshold` and `eager_eot_threshold` control the interim
+          # prompts and the `eagerEndOfTurn` and `turnResumed` frames sent to your WebSocket
+          # server.
           transcription_engine_config: nil,
           # Text-to-speech provider. If omitted, Telnyx derives it from `voice` or
           # `provider`.
@@ -1530,10 +1588,10 @@ module Telnyx
           #   the `VoiceId` (e.g., `AWS.Polly.Joanna-Neural`). Check the
           #   [available voices](https://docs.aws.amazon.com/polly/latest/dg/available-voices.html)
           #   for compatibility.
-          # - **Azure:** Use `Azure.<VoiceId>. (e.g. Azure.en-CA-ClaraNeural,
-          #   Azure.en-CA-LiamNeural, Azure.en-US-BrianMultilingualNeural,
-          #   Azure.en-US-Ava:DragonHDLatestNeural. For a complete list of voices, go to
-          #   [Azure Voice Gallery](https://speech.microsoft.com/portal/voicegallery).)
+          # - **Azure:** Use `Azure.<VoiceId>` (e.g., `Azure.en-CA-ClaraNeural`,
+          #   `Azure.en-CA-LiamNeural`, `Azure.en-US-BrianMultilingualNeural`,
+          #   `Azure.en-US-Ava:DragonHDLatestNeural`). For a complete list of voices, go to
+          #   [Azure Voice Gallery](https://speech.microsoft.com/portal/voicegallery).
           # - **ElevenLabs:** Use `ElevenLabs.<ModelId>.<VoiceId>` (e.g.,
           #   `ElevenLabs.BaseModel.John`). The `ModelId` part is optional. To use
           #   ElevenLabs, you must provide your ElevenLabs API key as an integration secret
@@ -2302,6 +2360,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
         sig do
           params(
             call_control_id: String,
@@ -2383,12 +2444,22 @@ module Telnyx
           # 'greeting_end' or 'detect_words' is used and a 'machine' is detected, you will
           # receive another 'call.machine.greeting.ended' webhook when the answering machine
           # greeting ends with a beep or silence. If `detect_beep` is used, you will only
-          # receive 'call.machine.greeting.ended' if a beep is detected.
+          # receive 'call.machine.greeting.ended' if a beep is detected. If
+          # `answering_machine_detection` is set to `premium_ios_call_screening_detection`,
+          # Premium AMD runs with iOS Call Screening support: after an initial `machine`
+          # result, Telnyx listens for the iOS call-screening prompt to end or for an Apple
+          # Call Screening tone, sends `call.machine.premium.greeting.ended` with
+          # `result=prompt_ended` or `call.machine.premium.call_screening.detected` with
+          # `result=screening` respectively. When the Apple Call Screening tone is detected,
+          # Premium AMD is restarted on the screened call and a
+          # `call.machine.premium.detection.ended` webhook with the post-screening
+          # classification follows.
           answering_machine_detection: nil,
           # Optional configuration parameters to modify 'answering_machine_detection'
           # performance. Only `total_analysis_time_millis` and `greeting_duration_millis`
           # parameters are applicable when `premium` is selected as
-          # answering_machine_detection.
+          # answering_machine_detection. `prompt_end_timeout_millis` is additionally
+          # applicable when `premium_ios_call_screening_detection` is selected.
           answering_machine_detection_config: nil,
           # The URL of a file to be played back when the transfer destination answers before
           # bridging the call. The URL can point to either a WAV or MP3 file. media_name and