telnyx 5.169.0 → 5.170.0

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      class Memory
+        # Whether a write has finished.
+        # @return [Telnyx::Resources::AI::Memory::Namespaces]
+        attr_reader :namespaces
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+          @namespaces = Telnyx::Resources::AI::Memory::Namespaces.new(client: client)
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/ai/typesafe/v1.rb

@@ -5,34 +5,43 @@ module Telnyx
     class AI
       class Typesafe
         # Beta API for evaluating shared context with typed questions and structured
-        # answers. Telnyx manages model selection.
+        # answers using Flash or Pro.
         class V1
-          # **Beta API.** Telnyx controls model selection.
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::AI::Typesafe::V1SystemoneParams} for more details.
+          #
+          # **Beta API.** Choose telnyx/decision-flash for the lowest cost and latency, or
+          # telnyx/decision-pro for decisions that require long context, including inputs
+          # beyond Jev’s 32k per-decision limit. Omitted model defaults to
+          # telnyx/decision-flash.
           #
           # Evaluate shared context using named choice, noul (yes/no), and score questions.
-          # Returns TypeSafe System One-compatible answer shapes, an opaque compatibility
-          # identifier, and token usage. See the
+          # Returns TypeSafe System One-compatible answer shapes, the selected public model
+          # alias, and token usage. See the
           # [decision model guide](https://developers.telnyx.com/docs/inference/decision-models)
           # for examples and compatibility limits.
           #
           # The supported request subset requires instructions for every question, string
           # descriptions for criteria (or null for choice descriptions), 1–64 questions, and
-          # 2–64 options for choice and score questions. The SDK-supplied model value is
-          # ignored and cannot select a model. Other unknown fields are rejected. The
-          # endpoint is synchronous and does not stream.
+          # 2–64 options for choice and score questions. The model field accepts only
+          # telnyx/decision-flash or telnyx/decision-pro. Unsupported model values and
+          # unknown fields are rejected. The endpoint is synchronous and does not stream.
           #
           # Use the TypeSafe Python SDK with base_url set to
           # https://api.telnyx.com/v2/ai/typesafe and a Telnyx API key. The SDK appends
-          # /v1/systemone. Compatibility covers this operation and the documented request
-          # subset; it does not include TypeSafe model listing. Scores describe relative
-          # preference, not calibrated correctness.
+          # /v1/systemone; explicitly set model to a supported Telnyx alias because its own
+          # default model is not supported. Compatibility covers this operation and the
+          # documented request subset; it does not include TypeSafe model listing. Scores
+          # describe relative preference, not calibrated correctness.
           #
-          # @overload systemone(questions:, state:, request_options: {})
+          # @overload systemone(questions:, state:, model: nil, request_options: {})
           #
           # @param questions [Hash{Symbol=>Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Choice, Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Noul, Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Score}] Between 1 and 64 named questions. Each key identifies the corresponding answer.
           #
           # @param state [String, Hash{Symbol=>Object}, Array<Object>] Shared context evaluated by every question.
           #
+          # @param model [Symbol, Telnyx::Models::AI::Typesafe::V1SystemoneParams::Model] Public model alias. telnyx/decision-flash offers the lowest cost and latency; te
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Telnyx::Models::AI::Typesafe::V1SystemoneResponse]

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

@@ -5,7 +5,7 @@ module Telnyx
     class AI
       class Typesafe
         # Beta API for evaluating shared context with typed questions and structured
-        # answers. Telnyx manages model selection.
+        # answers using Flash or Pro.
         # @return [Telnyx::Resources::AI::Typesafe::V1]
         attr_reader :v1
 

data/lib/telnyx/resources/ai.rb

@@ -58,6 +58,9 @@ module Telnyx
       # @return [Telnyx::Resources::AI::Typesafe]
       attr_reader :typesafe
 
+      # @return [Telnyx::Resources::AI::Memory]
+      attr_reader :memory
+
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::AIRetrieveConversationHistoriesParams} for more details.
       #
@@ -232,6 +235,7 @@ module Telnyx
         @anthropic = Telnyx::Resources::AI::Anthropic.new(client: client)
         @knowledge = Telnyx::Resources::AI::Knowledge.new(client: client)
         @typesafe = Telnyx::Resources::AI::Typesafe.new(client: client)
+        @memory = Telnyx::Resources::AI::Memory.new(client: client)
       end
     end
   end

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

@@ -352,7 +352,7 @@ module Telnyx
         #
         # @param voice [String] The voice to be used by the voice assistant. Currently we support ElevenLabs, Te
         #
-        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings] The settings associated with the voice selected
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -485,7 +485,7 @@ module Telnyx
         #
         # @param valid_digits [String] A list of all digits accepted as valid.
         #
-        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings] The settings associated with the voice selected
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -947,7 +947,7 @@ module Telnyx
         #
         # @param target_legs [Symbol, Telnyx::Models::Calls::ActionSpeakParams::TargetLegs] Specifies which legs of the call should receive the spoken audio.
         #
-        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings] The settings associated with the voice selected
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -1076,7 +1076,7 @@ module Telnyx
         #
         # @param voice [String] The voice to be used by the voice assistant. Currently we support ElevenLabs, Te
         #
-        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings] The settings associated with the voice selected
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #

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

@@ -522,7 +522,7 @@ module Telnyx
         #
         # @param region [Symbol, Telnyx::Models::Conferences::ConferenceRegion] Region where the conference data is located. Defaults to the region defined in u
         #
-        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings] The settings associated with the voice selected
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #

data/lib/telnyx/resources/email_blocks/imports.rb

@@ -16,9 +16,23 @@ module Telnyx
         # - header-only / all-blank / undetectable provider → `400` Returns `202` with the
         #   import record (status `pending`); an Oban worker (`EmailBlockImportWorker`,
         #   max_attempts 3) transitions `pending → processing → completed | failed`.
-        #   `block_ttl_days` applies only to imported `manual_block` rows; other reasons
-        #   get `expires_at: nil`. Provider is auto-detected from the CSV header
-        #   (`sendgrid` / `mailgun` / `ses` / `generic`).
+        #
+        # Native Telnyx exports are detected by the stable first-12-column header
+        # signature (`id` … `group_id`) and are restored with their original `from`,
+        # `domain_id`, `group_id`, `source`, `status`, `expires_at`, plus
+        # `bounce_category`, `dsn_code`, and `meta` when present (`scope` is re-derived
+        # from `domain_id`/`from`; the exported `scope` cell must be a valid enum value).
+        # Lifecycle changes reconcile through the same create path as the API: a row
+        # already in the requested state restores its mutable backup fields without a new
+        # audit event, and a real transition (e.g. tombstone → active) appends the
+        # matching lifecycle event. `block_ttl_days` is not applied to native rows — their
+        # exported `expires_at` is preserved verbatim.
+        #
+        # Competitor and generic imports (SendGrid / Mailgun / SES / generic) remain
+        # account-scoped (`from`, `domain_id`, `group_id`, `scope` are not read) and
+        # `block_ttl_days` applies only to imported `manual_block` rows; other reasons get
+        # `expires_at: nil`. Provider is auto-detected from the CSV header (`sendgrid` /
+        # `mailgun` / `ses` / `generic`).
         #
         # @overload create(file:, block_ttl_days: nil, request_options: {})
         #

data/lib/telnyx/resources/email_blocks.rb

@@ -194,9 +194,11 @@ module Telnyx
       # stream `ORDER BY created_at ASC, id ASC` with no pagination.
       #
       # CSV columns:
-      # `id,to,from,reason,source,scope,status,domain_id, created_at,updated_at,expires_at,group_id`.
-      # The CSV carries the `group_id` column so group-scoped suppressions' group link
-      # survives the export (empty for account-scope rows).
+      # `id,to,from,reason,source,scope,status,domain_id, created_at,updated_at,expires_at,group_id,bounce_category,dsn_code, meta`
+      # (15 columns). The first 12 columns are the stable native signature;
+      # `bounce_category`, `dsn_code`, and `meta` are optional backup fields (empty when
+      # unset). The CSV carries the `group_id` column so group-scoped suppressions'
+      # group link survives the export (empty for account-scope rows).
       #
       # @overload retrieve_export(filter_created_after: nil, filter_created_before: nil, filter_domain_id: nil, filter_reason: nil, page_number: nil, page_size: nil, sort: nil, request_options: {})
       #

data/lib/telnyx/resources/email_domains.rb

@@ -221,6 +221,34 @@ module Telnyx
         )
       end
 
+      # Generates a new DKIM key for the domain, activates it, and retires the previous
+      # key. The response includes the updated DKIM DNS records the customer must
+      # publish. Selectors are fixed, so rotation replaces the TXT value at the existing
+      # `<selector>._domainkey.<domain>` host rather than adding a second record —
+      # `old_selector_retained` is false and the new TXT value must be published
+      # promptly, since signing switches to the new key immediately and the old TXT
+      # value will no longer match. The previous key is retired to a `retiring` state
+      # (retained, not revoked) so it can be revoked after the DNS propagation grace
+      # period.
+      #
+      # @overload rotate_dkim(domain_id, request_options: {})
+      #
+      # @param domain_id [String] Email domain UUID
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::EmailDomainRotateDkimResponse]
+      #
+      # @see Telnyx::Models::EmailDomainRotateDkimParams
+      def rotate_dkim(domain_id, params = {})
+        @client.request(
+          method: :post,
+          path: ["email_domains/%1$s/rotate_dkim", domain_id],
+          model: Telnyx::Models::EmailDomainRotateDkimResponse,
+          options: params[:request_options]
+        )
+      end
+
       # Checks the published DNS records against the records required for the email
       # domain and returns the latest verification results.
       #

data/lib/telnyx/resources/email_events.rb

@@ -8,25 +8,38 @@ module Telnyx
       # {Telnyx::Models::EmailEventListParams} for more details.
       #
       # Lists account-level email events sorted oldest first by
-      # `occurred_at asc, id asc`.
-      #
-      # @overload list(email_id: nil, event_type: nil, from: nil, page_cursor: nil, page_size: nil, to: nil, request_options: {})
+      # `occurred_at asc, id asc`. Each row contains a legacy email.-prefixed event_type
+      # and an additive canonical_event_type. Gateway rejection renders email.failed
+      # with canonical email.gw_reject; ambiguous injection timeout renders
+      # email.injection_timeout in both; MTA expiration renders email.bounced with
+      # canonical email.expired. Message-scoped queued, sending, sandbox, cancelled, and
+      # daily_limit_exceeded rows fan out per durable recipient with stable derived IDs
+      # matching webhook delivery. Scheduled is the cardinality exception: account
+      # polling retains one message-scoped scheduled row with its stored event ID, while
+      # scheduled webhook publication fans out per recipient with derived IDs; reconcile
+      # scheduled events by message ID, event type, and occurrence time rather than
+      # event UUID. Recipient-scoped stored rows retain their stored UUIDs across
+      # polling and webhook delivery. Legacy names are derived from stored rows; an
+      # AdminBounce row stored as failed renders email.failed in polling while its
+      # webhook retains email.bounced, both with canonical email.failed.
+      #
+      # @overload list(email_id: nil, event_type: nil, from: nil, page_size: nil, page_cursor: nil, to: nil, request_options: {})
       #
       # @param email_id [String] Filter events for a specific email message UUID. Invalid UUID values are silentl
       #
-      # @param event_type [String, Array<String>] Comma-separated list of event types to include. Also accepts repeated query para
+      # @param event_type [String, Array<String>] Comma-separated list of event types to include. Also accepts repeated
       #
       # @param from [Time] Inclusive ISO 8601 start timestamp. Defaults to 30 days ago when omitted.
       #
-      # @param page_cursor [String] Opaque URL-safe Base64 cursor returned by a previous list response.
-      #
       # @param page_size [Integer] Number of results to return. Defaults to 25; maximum is 100. Invalid values are
       #
+      # @param page_cursor [String] Opaque URL-safe Base64 cursor returned by a previous event list response. The le
+      #
       # @param to [Time] Inclusive ISO 8601 end timestamp. When `from` is provided without `to`, defaults
       #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Telnyx::Internal::EmailCursorPagination<Telnyx::Models::EmailEventListResponse>]
+      # @return [Telnyx::Models::EmailEventListResponse]
       #
       # @see Telnyx::Models::EmailEventListParams
       def list(params = {})
@@ -35,8 +48,7 @@ module Telnyx
         @client.request(
           method: :get,
           path: "email_events",
-          query: query,
-          page: Telnyx::Internal::EmailCursorPagination,
+          query: query.transform_keys(page_cursor: "page[cursor]"),
           model: Telnyx::Models::EmailEventListResponse,
           options: options
         )

data/lib/telnyx/resources/email_messages.rb

@@ -50,21 +50,21 @@ module Telnyx
       #
       # @param inline_css [Boolean] Body param
       #
-      # @param metadata [Hash{Symbol=>Object}] Body param: Custom metadata. Write-only; not returned in responses.
+      # @param metadata [Hash{Symbol=>Object}] Body param: Custom metadata key/value pairs. Stored on the message, returned on
       #
       # @param reply_to [String, Telnyx::Models::EmailInboxes::EmailAddress] Body param: Reply-to address. If provided as an object with a name, only the ema
       #
       # @param reply_to_all [Boolean, nil] Body param: Indicates a reply-all intent. In Phase 1 (wire-only) this does not
       #
-      # @param sandbox_mode [Boolean] Body param
+      # @param sandbox_mode [Boolean] Body param: Validates and accepts the message without injecting it into the MTA
       #
-      # @param scheduled_at [Time, nil] Body param: Future ISO 8601 time to schedule sending. Invalid or past timestamps
+      # @param scheduled_at [Time, nil] Body param: Future ISO 8601 delivery time. Invalid or non-future timestamps are
       #
       # @param send_at [Time] Body param: Deprecated alias for `scheduled_at`.
       #
       # @param subject [String] Body param: Required unless `template_id` is supplied. When using a template, th
       #
-      # @param tags [Array<String>] Body param: Tags for categorization and reporting. Stored on the message and pro
+      # @param tags [Array<String>] Body param: Tags for categorization and filtering. Stored on the message, return
       #
       # @param template_id [String] Body param
       #
@@ -103,14 +103,14 @@ module Telnyx
       #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Telnyx::Models::EmailMessageRetrieveResponse]
+      # @return [Telnyx::Models::EmailMessageDetailResponse]
       #
       # @see Telnyx::Models::EmailMessageRetrieveParams
       def retrieve(id, params = {})
         @client.request(
           method: :get,
           path: ["email_messages/%1$s", id],
-          model: Telnyx::Models::EmailMessageRetrieveResponse,
+          model: Telnyx::EmailMessageDetailResponse,
           options: params[:request_options]
         )
       end
@@ -118,11 +118,15 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::EmailMessageListParams} for more details.
       #
-      # Lists messages sorted newest first by `created_at desc, id desc`. No filters
-      # other than cursor pagination are implemented. The legacy `/v2/emails` GET route
-      # is a backward-compatible alias for this operation.
+      # Lists messages sorted newest first by `created_at desc, id desc`. Tags and
+      # metadata filters compose with cursor pagination. The legacy `/v2/emails` GET
+      # route is a backward-compatible alias for this operation.
       #
-      # @overload list(page_cursor: nil, page_size: nil, request_options: {})
+      # @overload list(filter_metadata: nil, filter_tags: nil, page_cursor: nil, page_size: nil, request_options: {})
+      #
+      # @param filter_metadata [String] Metadata containment filter, supplied as a JSON object or comma-separated `key=v
+      #
+      # @param filter_tags [String] Comma-separated tags. Each segment is trimmed, and messages having at least one
       #
       # @param page_cursor [String] Opaque URL-safe Base64 cursor returned by a previous list response.
       #
@@ -139,7 +143,7 @@ module Telnyx
         @client.request(
           method: :get,
           path: "email_messages",
-          query: query,
+          query: query.transform_keys(filter_metadata: "filter[metadata]", filter_tags: "filter[tags]"),
           page: Telnyx::Internal::EmailCursorPagination,
           model: Telnyx::EmailInboxes::EmailMessage,
           options: options
@@ -176,13 +180,16 @@ module Telnyx
       # checks run first and can reject the whole batch before message creation. After
       # those checks pass, each message is validated and sent independently; item-level
       # failures do not affect other messages, and the processed batch returns 207
-      # Multi-Status.
+      # Multi-Status. Per-message failures include validation errors; when a template
+      # has `strict_variables` enabled, a missing required variable produces a per-item
+      # `unprocessable_entity` error naming that variable while the other messages
+      # continue.
       #
       # @overload batch(messages:, sandbox_mode: nil, idempotency_key: nil, request_options: {})
       #
       # @param messages [Array<Telnyx::Models::EmailMessageBatchParams::Message>] Body param: Array of email messages to send. Up to 1,000 messages per batch requ
       #
-      # @param sandbox_mode [Boolean] Body param: Applies sandbox mode to all messages in the batch. Overrides any per
+      # @param sandbox_mode [Boolean] Body param: Applies sandbox mode to all messages in the batch and overrides any
       #
       # @param idempotency_key [String] Header param: Optional opaque, unquoted key for safely retrying the same logical
       #
@@ -262,6 +269,15 @@ module Telnyx
       # `occurred_at asc, id asc`. The legacy `/v2/emails/{id}/events` GET route is a
       # backward-compatible alias.
       #
+      # For compatibility, each event carries the legacy customer-visible `event_type`
+      # (`email.`-prefixed), the additive `canonical_event_type` (`email.`-prefixed),
+      # and the deprecated `type` duplicate — whose value keeps the exact legacy format:
+      # the bare stored event name, never `email.`-prefixed. Gateway rejections render
+      # `email.failed` + canonical `email.gw_reject`; MTA expirations render
+      # `email.bounced` + canonical `email.expired`; every unchanged outcome carries
+      # identical `event_type` and `canonical_event_type` values (and `type` keeps the
+      # stored name).
+      #
       # @overload retrieve_events(email_id, page_cursor: nil, page_size: nil, request_options: {})
       #
       # @param email_id [String] Email message UUID.
@@ -288,6 +304,34 @@ module Telnyx
         )
       end
 
+      # Moves an existing scheduled email to a new future send time. Only the delivery
+      # time (`scheduled_at`) changes; the message ID, content, recipients, tags, and
+      # metadata remain unchanged. Returns `409 Conflict` if the message is no longer
+      # scheduled or its scheduled-send worker has already started processing it. This
+      # route emits no dedicated `rescheduled` event.
+      #
+      # @overload update_schedule(email_id, scheduled_at:, request_options: {})
+      #
+      # @param email_id [String] Email message UUID.
+      #
+      # @param scheduled_at [Time] New ISO 8601 delivery time. Must be strictly in the future.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::EmailMessageDetailResponse]
+      #
+      # @see Telnyx::Models::EmailMessageUpdateScheduleParams
+      def update_schedule(email_id, params)
+        parsed, options = Telnyx::EmailMessageUpdateScheduleParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["email_messages/%1$s/schedule", email_id],
+          body: parsed,
+          model: Telnyx::EmailMessageDetailResponse,
+          options: options
+        )
+      end
+
       # @api private
       #
       # @param client [Telnyx::Client]

data/lib/telnyx/resources/email_templates.rb

@@ -9,16 +9,22 @@ module Telnyx
       #
       # Creates a Liquid email template. Variables are auto-extracted when omitted.
       #
-      # @overload create(name:, html_body: nil, subject: nil, text_body: nil, variables: nil, idempotency_key: nil, request_options: {})
+      # @overload create(name:, autoescape: nil, html_body: nil, strict_variables: nil, subject: nil, text_body: nil, variable_schema: nil, variables: nil, idempotency_key: nil, request_options: {})
       #
       # @param name [String] Body param: Letters, numbers, spaces, hyphens, and underscores only.
       #
+      # @param autoescape [Boolean] Body param: Per-template HTML autoescaping setting. Defaults to `false` for back
+      #
       # @param html_body [String, nil] Body param: Liquid template HTML body.
       #
+      # @param strict_variables [Boolean] Body param: Per-template strict variable-validation setting. Defaults to `false`
+      #
       # @param subject [String, nil] Body param: Liquid template subject.
       #
       # @param text_body [String, nil] Body param: Liquid template text body.
       #
+      # @param variable_schema [Hash{Symbol=>Telnyx::Models::EmailTemplateCreateParams::VariableSchema}, nil] Body param: Structured variable requirements. Required variables cannot define d
+      #
       # @param variables [Array<String>] Body param: Template variables. Auto-extracted from subject/body fields when abs
       #
       # @param idempotency_key [String] Header param: Optional opaque, unquoted key for safely retrying the same logical
@@ -62,21 +68,30 @@ module Telnyx
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::EmailTemplateUpdateParams} for more details.
+      #
       # Updates one or more fields of the specified email template and returns the
       # updated template.
       #
-      # @overload update(id, html_body: nil, name: nil, subject: nil, text_body: nil, variables: nil, request_options: {})
+      # @overload update(id, autoescape: nil, html_body: nil, name: nil, strict_variables: nil, subject: nil, text_body: nil, variable_schema: nil, variables: nil, request_options: {})
       #
       # @param id [String] Email template UUID.
       #
+      # @param autoescape [Boolean] Per-template HTML autoescaping setting.
+      #
       # @param html_body [String, nil] Liquid template HTML body.
       #
       # @param name [String]
       #
+      # @param strict_variables [Boolean] Per-template strict variable-validation setting.
+      #
       # @param subject [String, nil] Liquid template subject.
       #
       # @param text_body [String, nil] Liquid template text body.
       #
+      # @param variable_schema [Hash{Symbol=>Telnyx::Models::UpdateEmailTemplateRequest::VariableSchema}, nil] Structured variable requirements. Required variables cannot define defaults; inv
+      #
       # @param variables [Array<String>]
       #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -151,6 +166,12 @@ module Telnyx
       # Renders a template using the provided Liquid variables. Missing
       # `template_variables` defaults to `{}`.
       #
+      # When the template has `strict_variables` enabled and a required variable (per
+      # `variable_schema`) is missing, returns 422 naming the variable. When the
+      # template has `autoescape` enabled, the rendered `html_body` expression output is
+      # HTML-escaped at the output boundary; `subject` and `text_body` are not
+      # autoescaped.
+      #
       # @overload render(id, template_variables: nil, request_options: {})
       #
       # @param id [String] Email template UUID.
@@ -173,21 +194,30 @@ module Telnyx
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::EmailTemplateReplaceParams} for more details.
+      #
       # Replaces template fields. Behaves identically to PATCH; provided for
       # compatibility with Phoenix resource routes.
       #
-      # @overload replace(id, html_body: nil, name: nil, subject: nil, text_body: nil, variables: nil, request_options: {})
+      # @overload replace(id, autoescape: nil, html_body: nil, name: nil, strict_variables: nil, subject: nil, text_body: nil, variable_schema: nil, variables: nil, request_options: {})
       #
       # @param id [String] Email template UUID.
       #
+      # @param autoescape [Boolean] Per-template HTML autoescaping setting.
+      #
       # @param html_body [String, nil] Liquid template HTML body.
       #
       # @param name [String]
       #
+      # @param strict_variables [Boolean] Per-template strict variable-validation setting.
+      #
       # @param subject [String, nil] Liquid template subject.
       #
       # @param text_body [String, nil] Liquid template text body.
       #
+      # @param variable_schema [Hash{Symbol=>Telnyx::Models::UpdateEmailTemplateRequest::VariableSchema}, nil] Structured variable requirements. Required variables cannot define defaults; inv
+      #
       # @param variables [Array<String>]
       #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]

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

@@ -32,7 +32,13 @@ module Telnyx
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::MeetingSessions::ActionSpeakParams} for more details.
         #
-        # Sends audio / text-to-speech into a meeting session.
+        # Sends audio / text-to-speech into a meeting session. With a Telnyx AI Assistant
+        # (or avatar) attached, the bot is a webpage-output bot: the speak audio routes
+        # through the assistant's output page rather than the bot mic and plays once the
+        # assistant is connected -- it is not refused. If that page cannot be reached,
+        # delivery fails with the 502 below, which may arrive without an error envelope,
+        # so branch on the status code before parsing a body. The assistant is designed to
+        # own the conversation, so prefer letting it speak or use `send_chat`.
         #
         # @overload speak(id, text:, interrupt: nil, voice: nil, request_options: {})
         #

data/lib/telnyx/resources/meeting_sessions/artifacts.rb

@@ -5,17 +5,26 @@ module Telnyx
     class MeetingSessions
       # Create and retrieve asynchronous summaries and action-item artifacts.
       class Artifacts
-        # Requests asynchronous generation of one `summary` or `action_items` artifact.
-        # Each type requires its own request. Generation requires transcript content and
-        # configured inference and currently reads at most the first 10,000 segments, so
-        # exceptionally long transcripts may produce incomplete artifacts or fail model
-        # limits.
-        #
-        # @overload create(id, type:, request_options: {})
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::MeetingSessions::ArtifactCreateParams} for more details.
+        #
+        # Requests asynchronous generation of one artifact: `summary`, `action_items`,
+        # `decisions`, `topics`, `open_questions`, or `custom`. Each request produces one
+        # artifact. `custom` is answered from a `prompt` you supply, which is required for
+        # `custom` and rejected on the five named types. Generation requires transcript
+        # content and configured inference and currently reads at most the first 10,000
+        # segments, so exceptionally long transcripts may produce incomplete artifacts or
+        # fail model limits. **Not idempotent, and every call is billed**: each request is
+        # a separate inference run, so a retry or a duplicate POST produces a second
+        # artifact and a second charge. Guard the call rather than relying on the service
+        # to collapse it. The automatic `summarize_on_end` attempt is billed on the same
+        # basis.
+        #
+        # @overload create(id, body:, request_options: {})
         #
         # @param id [String] Unique identifier for the meeting session.
         #
-        # @param type [Symbol, Telnyx::Models::MeetingSessions::ArtifactCreateParams::Type] Type of artifact to generate from the session.
+        # @param body [Telnyx::Models::MeetingSessions::ArtifactCreateParams::Body::NamedArtifact, Telnyx::Models::MeetingSessions::ArtifactCreateParams::Body::CustomArtifact] One of two shapes: a named type on its own, or `custom` with the prompt it answe
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -27,7 +36,7 @@ module Telnyx
           @client.request(
             method: :post,
             path: ["meeting_sessions/%1$s/artifacts", id],
-            body: parsed,
+            body: parsed[:body],
             model: Telnyx::MeetingSessions::MeetingSessionArtifactResponse,
             options: options
           )

data/lib/telnyx/resources/meeting_sessions.rb

@@ -26,11 +26,11 @@ module Telnyx
       # before bot creation; neither the source URL nor image bytes are persisted,
       # returned, or logged. Treat signed URLs as credentials.
       #
-      # @overload create(meeting_url:, assistant: nil, avatar: nil, barge_in: nil, bot_name: nil, camera_image: nil, idempotency_key: nil, join_at: nil, metadata: nil, speak_on_enter: nil, summarize_on_end: nil, voice: nil, webhook_url: nil, request_options: {})
+      # @overload create(meeting_url:, assistant: nil, avatar: nil, barge_in: nil, bot_name: nil, camera_image: nil, chat_on_enter: nil, idempotency_key: nil, join_at: nil, metadata: nil, speak_on_enter: nil, summarize_on_end: nil, voice: nil, webhook_url: nil, request_options: {})
       #
       # @param meeting_url [String] The meeting URL the bot should join.
       #
-      # @param assistant [Telnyx::Models::MeetingSessionCreateParams::Assistant] Request options for attaching a voice assistant to the session. Routing fields (
+      # @param assistant [Telnyx::Models::MeetingSessionCreateParams::Assistant] Attach a Telnyx AI Assistant to the session. Supply the Assistant's ID; the Meet
       #
       # @param avatar [Telnyx::Models::MeetingSessionCreateParams::Avatar] Request options for attaching a bring-your-own-key avatar to the session.
       #
@@ -40,13 +40,16 @@ module Telnyx
       #
       # @param camera_image [Telnyx::Models::MeetingSessionCreateParams::CameraImage::MeetingSessionCameraImageBase64Source, Telnyx::Models::MeetingSessionCreateParams::CameraImage::MeetingSessionCameraImageURLSource] Write-only static camera-tile image for this session, not a native account or pa
       #
+      # @param chat_on_enter [String] A message the bot posts to the meeting's chat as soon as it becomes active — typ
+      #
       # @param idempotency_key [String] Client-supplied idempotency key to safely retry creation requests without duplic
       #
       # @param join_at [Time] ISO-8601 timestamp in the future at which the bot should join. If omitted, the b
       #
       # @param metadata [Hash{Symbol=>Object}] Arbitrary key-value metadata attached to the session. The serialized JSON repres
       #
-      # @param speak_on_enter [String] Text the bot speaks when it enters the meeting.
+      # @param speak_on_enter [String] Text the bot speaks when it enters the meeting. \*\*Not spoken when an
+      # `assistant`
       #
       # @param summarize_on_end [Boolean] If true, generate a summary artifact when the session ends.
       #
@@ -165,8 +168,6 @@ module Telnyx
         )
       end
 
-      # **Not yet available in production** — this route is not currently routed on
-      # api.telnyx.com and returns a generic 404; it is documented ahead of rollout.
       # Irreversibly requests deletion of provider-hosted aggregate recording media
       # under the provider contract. The operation retains the Telnyx-local Meeting
       # session, transcript segments, events, artifacts, and usage records. It is