telnyx 5.170.0 → 5.173.0

data/lib/telnyx/resources/email/dedicated_ips.rb

@@ -0,0 +1,212 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Email
+      # Purchase and manage dedicated sending IP addresses for your Telnyx email
+      # traffic.
+      class DedicatedIPs
+        # Purchase and manage dedicated sending IP addresses for your Telnyx email
+        # traffic.
+        # @return [Telnyx::Resources::Email::DedicatedIPs::Actions]
+        attr_reader :actions
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Email::DedicatedIPCreateParams} for more details.
+        #
+        # Purchase a dedicated sending IP. Requires a verified, enterprise, or legacy
+        # account, and an `Idempotency-Key` header: a request without the header returns
+        # `400` (code `10015`) and allocates nothing. Telnyx allocates the next available
+        # IP from stock. The optional `region` and `ip_version` fields each restrict which
+        # stock IP is allocated; they never change the allocated IP's metadata. An omitted
+        # field applies no restriction for that field, and omitting the body applies
+        # neither restriction. An unsupported selector value returns `422`; a supported
+        # value that matches no available IP returns `429` and records the request on the
+        # waitlist. Billing: $14/month/IP, charged as a monthly recurring charge (MRC)
+        # from purchase. The IP is returned in `provisioning` status with a Telnyx-managed
+        # PTR hostname and carries no mail until you call `start_warmup` and add it to a
+        # pool that routes mail.
+        #
+        # @overload create(idempotency_key:, ip_version: nil, region: nil, request_options: {})
+        #
+        # @param idempotency_key [String] Header param: Required. Opaque, unquoted key for safely retrying the same purcha
+        #
+        # @param ip_version [Symbol, Telnyx::Models::Email::DedicatedIPCreateParams::IPVersion] Body param: Allocate an IP of this address family. Supported value: `ipv4`. Any
+        #
+        # @param region [Symbol, Telnyx::Models::Email::DedicatedIPCreateParams::Region] Body param: Allocate an IP in this region. Supported value: `ewr-nj1`. Any other
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Email::DedicatedIPShowResponse]
+        #
+        # @see Telnyx::Models::Email::DedicatedIPCreateParams
+        def create(params)
+          parsed, options = Telnyx::Email::DedicatedIPCreateParams.dump_request(params)
+          header_params = {idempotency_key: "idempotency-key"}
+          @client.request(
+            method: :post,
+            path: "email/dedicated_ips",
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
+            model: Telnyx::Email::DedicatedIPShowResponse,
+            options: options
+          )
+        end
+
+        # Retrieve a single dedicated IP by its identifier, including warm-up state,
+        # billing state, and the DNS/PTR provisioning checklist.
+        #
+        # @overload retrieve(id, request_options: {})
+        #
+        # @param id [String] The dedicated IP identifier (UUID).
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Email::DedicatedIPShowResponse]
+        #
+        # @see Telnyx::Models::Email::DedicatedIPRetrieveParams
+        def retrieve(id, params = {})
+          @client.request(
+            method: :get,
+            path: ["email/dedicated_ips/%1$s", id],
+            model: Telnyx::Email::DedicatedIPShowResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Email::DedicatedIPUpdateParams} for more details.
+        #
+        # Move the IP to another pool, or pause/resume its warm-up ramp. One change
+        # applies per request. `pool_id` takes precedence over warm-up changes. Otherwise,
+        # use `warmup_paused` or `warmup.paused`; a Boolean `warmup_paused` takes
+        # precedence. Moving the last IP out of a pool requires `force: true` and
+        # `drain: true`. The PTR hostname is managed by Telnyx: a request that includes
+        # `ptr_hostname` returns `422` unless `pool_id` or a warm-up field is present, in
+        # which case `ptr_hostname` is ignored.
+        #
+        # @overload update(id, drain: nil, force: nil, pool_id: nil, warmup: nil, warmup_paused: nil, weight: nil, request_options: {})
+        #
+        # @param id [String] The dedicated IP identifier (UUID).
+        #
+        # @param drain [Boolean] Set together with `force: true` to move the last IP out of its current pool. Ack
+        #
+        # @param force [Boolean] Set together with `drain: true` to move the last IP out of its current pool. Use
+        #
+        # @param pool_id [String] Move the IP to this pool, replacing its current membership. Use the IP's current
+        #
+        # @param warmup [Telnyx::Models::Email::DedicatedIPUpdateParams::Warmup] Alias for `warmup_paused`.
+        #
+        # @param warmup_paused [Boolean] Pause (`true`) or resume (`false`) the warm-up ramp; equivalent to the `pause_wa
+        #
+        # @param weight [Integer] Routing weight in the target pool. Used only with `pool_id`.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Email::DedicatedIPShowResponse]
+        #
+        # @see Telnyx::Models::Email::DedicatedIPUpdateParams
+        def update(id, params = {})
+          parsed, options = Telnyx::Email::DedicatedIPUpdateParams.dump_request(params)
+          @client.request(
+            method: :patch,
+            path: ["email/dedicated_ips/%1$s", id],
+            body: parsed,
+            model: Telnyx::Email::DedicatedIPShowResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Email::DedicatedIPListParams} for more details.
+        #
+        # List the dedicated sending IPs owned by the account, newest first. Narrow the
+        # list with `filter[status]`, `filter[pool_id]`, and `filter[region]`; supplied
+        # filters combine, so an IP must match every one. An empty value, or a nested or
+        # array value such as `filter[status][]=active`, applies no filter, and other
+        # `filter[...]` keys are ignored. A value that no IP can match (an unknown status,
+        # a `pool_id` that is not a UUID, or a value containing a NUL byte) returns an
+        # empty list, not an error.
+        #
+        # @overload list(filter_pool_id: nil, filter_region: nil, filter_status: nil, request_options: {})
+        #
+        # @param filter_pool_id [String] Return only IPs in this pool (exact match on `pool_id`). A value that is not a U
+        #
+        # @param filter_region [String] Return only IPs in this region (exact, case-sensitive match on `region`). An emp
+        #
+        # @param filter_status [Symbol, Telnyx::Models::Email::DedicatedIPListParams::FilterStatus] Return only IPs in this lifecycle status (exact match). Any other value returns
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Email::DedicatedIPListResponse]
+        #
+        # @see Telnyx::Models::Email::DedicatedIPListParams
+        def list(params = {})
+          parsed, options = Telnyx::Email::DedicatedIPListParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: "email/dedicated_ips",
+            query: query.transform_keys(
+              filter_pool_id: "filter[pool_id]",
+              filter_region: "filter[region]",
+              filter_status: "filter[status]"
+            ),
+            model: Telnyx::Models::Email::DedicatedIPListResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Email::DedicatedIPDeleteParams} for more details.
+        #
+        # Release the dedicated IP to Telnyx. The IP stops carrying mail immediately,
+        # leaves its pool, and moves to `released`. Telnyx sets `quarantine_until` to 30
+        # days after release. Release requests that the MRC stop asynchronously. Check
+        # `billing`: `stopping` means the stop is pending, `stopped` means it completed,
+        # and `stop_failed` means the charge remains. If the charge was never created or
+        # its creation has not completed, `billing` keeps showing the creation status
+        # (`not_started`, `pending`, `in_progress`, or `failed`). Any status except
+        # `released` can be released. Releasing the last IP in a pool requires
+        # `force=true` and `drain=true`.
+        #
+        # @overload delete(id, body_drain: nil, body_force: nil, body_reason: nil, request_options: {})
+        #
+        # @param id [String] Path param: The dedicated IP identifier (UUID).
+        #
+        # @param body_drain [Boolean] Body param: Set together with `force: true` to release the last IP in a pool. Ac
+        #
+        # @param body_force [Boolean] Body param: Set together with `drain: true` to release the last IP in a pool. Ei
+        #
+        # @param body_reason [String] Body param: Free-text reason recorded with the release.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Email::DedicatedIPShowResponse]
+        #
+        # @see Telnyx::Models::Email::DedicatedIPDeleteParams
+        def delete(id, params = {})
+          query_params = [:query_drain, :query_force, :query_reason]
+          parsed, options = Telnyx::Email::DedicatedIPDeleteParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed.slice(*query_params))
+          @client.request(
+            method: :delete,
+            path: ["email/dedicated_ips/%1$s", id],
+            query: query.transform_keys(query_drain: "drain", query_force: "force", query_reason: "reason"),
+            body: parsed.except(*query_params),
+            model: Telnyx::Email::DedicatedIPShowResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+          @actions = Telnyx::Resources::Email::DedicatedIPs::Actions.new(client: client)
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/email/ip_pools/ips.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Email
+      class IPPools
+        # Group dedicated IPs into pools for sending.
+        class IPs
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::Email::IPPools::IPCreateParams} for more details.
+          #
+          # Add a dedicated IP to the pool with an optional routing weight. An IP can belong
+          # to one pool; to move an IP that is already in a pool, use
+          # `PATCH /email/dedicated_ips/{id}` with `pool_id`.
+          #
+          # @overload create(id, dedicated_ip_id:, weight: nil, request_options: {})
+          #
+          # @param id [String] The IP pool identifier (UUID).
+          #
+          # @param dedicated_ip_id [String] The dedicated IP to add. It must belong to the account, must not be released, an
+          #
+          # @param weight [Integer] Relative routing weight for this IP in the pool. Positive integer; defaults to 1
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::Email::IPPools::IPCreateResponse]
+          #
+          # @see Telnyx::Models::Email::IPPools::IPCreateParams
+          def create(id, params)
+            parsed, options = Telnyx::Email::IPPools::IPCreateParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: ["email/ip_pools/%1$s/ips", id],
+              body: parsed,
+              model: Telnyx::Models::Email::IPPools::IPCreateResponse,
+              options: options
+            )
+          end
+
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::Email::IPPools::IPDeleteParams} for more details.
+          #
+          # Remove the dedicated IP from the pool. The IP is kept but carries no mail until
+          # added to a pool again. Removing the last IP requires `force=true` and
+          # `drain=true`.
+          #
+          # @overload delete(ip_id, id:, drain: nil, force: nil, request_options: {})
+          #
+          # @param ip_id [String] Path param: The dedicated IP identifier (UUID).
+          #
+          # @param id [String] Path param: The IP pool identifier (UUID).
+          #
+          # @param drain [Boolean] Query param: Set together with `force=true` to remove the last IP in the pool. A
+          #
+          # @param force [Boolean] Query param: Set together with `drain=true` to remove the last IP in the pool. E
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [nil]
+          #
+          # @see Telnyx::Models::Email::IPPools::IPDeleteParams
+          def delete(ip_id, params)
+            parsed, options = Telnyx::Email::IPPools::IPDeleteParams.dump_request(params)
+            query = Telnyx::Internal::Util.encode_query_params(parsed)
+            id =
+              parsed.delete(:id) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+            @client.request(
+              method: :delete,
+              path: ["email/ip_pools/%1$s/ips/%2$s", id, ip_id],
+              query: query,
+              model: NilClass,
+              options: options
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Telnyx::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/email/ip_pools.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Email
+      # Group dedicated IPs into pools for sending.
+      class IPPools
+        # Group dedicated IPs into pools for sending.
+        # @return [Telnyx::Resources::Email::IPPools::IPs]
+        attr_reader :ips
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Email::IPPoolCreateParams} for more details.
+        #
+        # Create an account-scoped pool of dedicated IPs. Set `is_default` or `domain_id`
+        # for the pool to carry mail; a pool with neither carries none.
+        #
+        # @overload create(name:, domain_id: nil, is_default: nil, request_options: {})
+        #
+        # @param name [String] Pool name: 1-64 characters of lowercase letters, digits, `.`, `_`, and `-`, star
+        #
+        # @param domain_id [String] Scope the pool to one of the account's email domains; the pool then carries that
+        #
+        # @param is_default [Boolean] Make this the account's default pool, which carries mail for sending domains wit
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Email::IPPoolShowResponse]
+        #
+        # @see Telnyx::Models::Email::IPPoolCreateParams
+        def create(params)
+          parsed, options = Telnyx::Email::IPPoolCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "email/ip_pools",
+            body: parsed,
+            model: Telnyx::Email::IPPoolShowResponse,
+            options: options
+          )
+        end
+
+        # Retrieve a single IP pool by its identifier, including its dedicated-IP members
+        # with billing state.
+        #
+        # @overload retrieve(id, request_options: {})
+        #
+        # @param id [String] The IP pool identifier (UUID).
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Email::IPPoolShowResponse]
+        #
+        # @see Telnyx::Models::Email::IPPoolRetrieveParams
+        def retrieve(id, params = {})
+          @client.request(
+            method: :get,
+            path: ["email/ip_pools/%1$s", id],
+            model: Telnyx::Email::IPPoolShowResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Email::IPPoolUpdateParams} for more details.
+        #
+        # Rename the pool, set or clear the default flag, or change its domain scope.
+        # Routing follows the new settings for subsequent mail.
+        #
+        # @overload update(id, domain_id: nil, is_default: nil, name: nil, request_options: {})
+        #
+        # @param id [String] The IP pool identifier (UUID).
+        #
+        # @param domain_id [String, nil] Scope the pool to one of the account's email domains, or `null` to remove the sc
+        #
+        # @param is_default [Boolean] Set or clear the account default flag. An account can have one default pool.
+        #
+        # @param name [String] Pool name: 1-64 characters of lowercase letters, digits, `.`, `_`, and `-`, star
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Email::IPPoolShowResponse]
+        #
+        # @see Telnyx::Models::Email::IPPoolUpdateParams
+        def update(id, params = {})
+          parsed, options = Telnyx::Email::IPPoolUpdateParams.dump_request(params)
+          @client.request(
+            method: :patch,
+            path: ["email/ip_pools/%1$s", id],
+            body: parsed,
+            model: Telnyx::Email::IPPoolShowResponse,
+            options: options
+          )
+        end
+
+        # List the account's dedicated-IP pools. Member IPs are not included (`ips` is
+        # empty); retrieve a pool to see its members.
+        #
+        # @overload list(request_options: {})
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Email::IPPoolListResponse]
+        #
+        # @see Telnyx::Models::Email::IPPoolListParams
+        def list(params = {})
+          @client.request(
+            method: :get,
+            path: "email/ip_pools",
+            model: Telnyx::Models::Email::IPPoolListResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Email::IPPoolDeleteParams} for more details.
+        #
+        # Delete the pool. Member IPs are kept but leave the pool, so they carry no mail
+        # until added to another pool. Deleting a pool changes routing for subsequently
+        # resolved messages. It does not reroute messages already assigned to the deleted
+        # pool. Deleting a pool that still has IPs requires `force=true` and `drain=true`.
+        #
+        # @overload delete(id, drain: nil, force: nil, request_options: {})
+        #
+        # @param id [String] The IP pool identifier (UUID).
+        #
+        # @param drain [Boolean] Set together with `force=true` to delete a pool that still has IPs. Acknowledges
+        #
+        # @param force [Boolean] Set together with `drain=true` to delete a pool that still has IPs. Either flag
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [nil]
+        #
+        # @see Telnyx::Models::Email::IPPoolDeleteParams
+        def delete(id, params = {})
+          parsed, options = Telnyx::Email::IPPoolDeleteParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :delete,
+            path: ["email/ip_pools/%1$s", id],
+            query: query,
+            model: NilClass,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+          @ips = Telnyx::Resources::Email::IPPools::IPs.new(client: client)
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/email.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Email
+      # Purchase and manage dedicated sending IP addresses for your Telnyx email
+      # traffic.
+      # @return [Telnyx::Resources::Email::DedicatedIPs]
+      attr_reader :dedicated_ips
+
+      # Group dedicated IPs into pools for sending.
+      # @return [Telnyx::Resources::Email::IPPools]
+      attr_reader :ip_pools
+
+      # @api private
+      #
+      # @param client [Telnyx::Client]
+      def initialize(client:)
+        @client = client
+        @dedicated_ips = Telnyx::Resources::Email::DedicatedIPs.new(client: client)
+        @ip_pools = Telnyx::Resources::Email::IPPools.new(client: client)
+      end
+    end
+  end
+end

data/lib/telnyx/resources/email_templates.rb

@@ -9,7 +9,7 @@ module Telnyx
       #
       # Creates a Liquid email template. Variables are auto-extracted when omitted.
       #
-      # @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: {})
+      # @overload create(name:, autoescape: nil, html_body: nil, strict_variables: nil, subject: nil, text_body: nil, variable_schema: nil, variables: nil, variables_mode: nil, idempotency_key: nil, request_options: {})
       #
       # @param name [String] Body param: Letters, numbers, spaces, hyphens, and underscores only.
       #
@@ -25,7 +25,9 @@ module Telnyx
       #
       # @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 variables [Array<String>, nil] Body param: Persisted variable names. In `automatic` mode a non-null array is re
+      #
+      # @param variables_mode [Symbol, Telnyx::Models::EmailTemplateCreateParams::VariablesMode] Body param: Controls how `variables` is maintained. If both fields are omitted (
       #
       # @param idempotency_key [String] Header param: Optional opaque, unquoted key for safely retrying the same logical
       #
@@ -74,7 +76,7 @@ module Telnyx
       # Updates one or more fields of the specified email template and returns the
       # updated template.
       #
-      # @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: {})
+      # @overload update(id, autoescape: nil, html_body: nil, name: nil, strict_variables: nil, subject: nil, text_body: nil, variable_schema: nil, variables: nil, variables_mode: nil, request_options: {})
       #
       # @param id [String] Email template UUID.
       #
@@ -92,7 +94,9 @@ module Telnyx
       #
       # @param variable_schema [Hash{Symbol=>Telnyx::Models::UpdateEmailTemplateRequest::VariableSchema}, nil] Structured variable requirements. Required variables cannot define defaults; inv
       #
-      # @param variables [Array<String>]
+      # @param variables [Array<String>, nil] Persisted variable names. In `automatic` mode a non-null array is rejected; in `
+      #
+      # @param variables_mode [Symbol, Telnyx::Models::UpdateEmailTemplateRequest::VariablesMode] Controls how `variables` is maintained. Setting `automatic` re-extracts immediat
       #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -113,9 +117,21 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::EmailTemplateListParams} for more details.
       #
-      # Lists templates sorted newest first by `created_at desc, id desc`.
+      # Lists templates sorted newest first by `created_at desc, id desc`. Optional
+      # filters match a case-insensitive literal name/subject query, stored body
+      # presence, and the `strict_variables` and `autoescape` settings. Filters
+      # intersect, remain scoped to the authenticated account, and apply before cursor
+      # pagination. Invalid filter names or values return 400.
+      #
+      # @overload list(filter_autoescape: nil, filter_content_type: nil, filter_query: nil, filter_strict_variables: nil, page_cursor: nil, page_size: nil, request_options: {})
+      #
+      # @param filter_autoescape [Symbol, Telnyx::Models::EmailTemplateListParams::FilterAutoescape] Exact match on the template's `autoescape` option. Only the exact query strings
       #
-      # @overload list(page_cursor: nil, page_size: nil, request_options: {})
+      # @param filter_content_type [Symbol, Telnyx::Models::EmailTemplateListParams::FilterContentType] Matches templates by stored body presence. `html_and_text` requires both an HTML
+      #
+      # @param filter_query [String] Case-insensitive literal substring match over the template `name` or stored `sub
+      #
+      # @param filter_strict_variables [Symbol, Telnyx::Models::EmailTemplateListParams::FilterStrictVariables] Exact match on the template's `strict_variables` option. Only the exact query st
       #
       # @param page_cursor [String] Opaque URL-safe Base64 cursor returned by a previous list response.
       #
@@ -132,7 +148,12 @@ module Telnyx
         @client.request(
           method: :get,
           path: "email_templates",
-          query: query,
+          query: query.transform_keys(
+            filter_autoescape: "filter[autoescape]",
+            filter_content_type: "filter[content_type]",
+            filter_query: "filter[query]",
+            filter_strict_variables: "filter[strict_variables]"
+          ),
           page: Telnyx::Internal::EmailCursorPagination,
           model: Telnyx::EmailTemplate,
           options: options
@@ -200,7 +221,7 @@ module Telnyx
       # Replaces template fields. Behaves identically to PATCH; provided for
       # compatibility with Phoenix resource routes.
       #
-      # @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: {})
+      # @overload replace(id, autoescape: nil, html_body: nil, name: nil, strict_variables: nil, subject: nil, text_body: nil, variable_schema: nil, variables: nil, variables_mode: nil, request_options: {})
       #
       # @param id [String] Email template UUID.
       #
@@ -218,7 +239,9 @@ module Telnyx
       #
       # @param variable_schema [Hash{Symbol=>Telnyx::Models::UpdateEmailTemplateRequest::VariableSchema}, nil] Structured variable requirements. Required variables cannot define defaults; inv
       #
-      # @param variables [Array<String>]
+      # @param variables [Array<String>, nil] Persisted variable names. In `automatic` mode a non-null array is rejected; in `
+      #
+      # @param variables_mode [Symbol, Telnyx::Models::UpdateEmailTemplateRequest::VariablesMode] Controls how `variables` is maintained. Setting `automatic` re-extracts immediat
       #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/telnyx/resources/enterprises/dir.rb

@@ -30,12 +30,18 @@ module Telnyx
         #
         # **Failure modes**
         #
-        # - `422` - validation error; `errors[].source.pointer` names the offending field.
-        # - `403` - Branded Calling not activated on this enterprise (see
+        # - `400` - validation error; `errors[].source.pointer` names the offending field.
+        # - `400` - a certification field is not `true`.
+        # - `400` - Branded Calling not activated on this enterprise (see
         #   `POST /enterprises/{id}/branded_calling`).
+        # - `400` - the enterprise is a BPO enterprise (`role_type` `bpo`), which cannot
+        #   own a DIR.
+        # - `400` - a `bpo_authorizations` entry is not an approved BPO enterprise in your
+        #   account, or its `loa_document_id` could not be validated.
         # - `404` - enterprise does not exist or does not belong to your account.
+        # - `503` - the document check is temporarily unavailable; retry.
         #
-        # @overload create(enterprise_id, authorizer_email:, authorizer_name:, call_reasons:, certify_brand_is_accurate:, certify_ip_ownership:, certify_no_shaft_content:, display_name:, documents: nil, logo_url: nil, reselling: nil, request_options: {})
+        # @overload create(enterprise_id, authorizer_email:, authorizer_name:, call_reasons:, certify_brand_is_accurate:, certify_ip_ownership:, certify_no_shaft_content:, display_name:, bpo_authorizations: nil, documents: nil, logo_url: nil, reselling: nil, webhook_url: nil, request_options: {})
         #
         # @param enterprise_id [String] The enterprise id. Lowercase UUID.
         #
@@ -45,7 +51,7 @@ module Telnyx
         #
         # @param call_reasons [Array<String>] 1–10 reasons your business calls customers. Validate phrasing against `POST /cal
         #
-        # @param certify_brand_is_accurate [Boolean, Telnyx::Models::Enterprises::DirCreateParams::CertifyBrandIsAccurate] Must be `true`.
+        # @param certify_brand_is_accurate [Boolean, Telnyx::Models::Enterprises::DirCreateParams::CertifyBrandIsAccurate] Certification that the DIR information is accurate. Must be `true` for the DIR t
         #
         # @param certify_ip_ownership [Boolean, Telnyx::Models::Enterprises::DirCreateParams::CertifyIPOwnership] Must be `true`. Confirms ownership of any logos/trademarks shown.
         #
@@ -53,12 +59,16 @@ module Telnyx
         #
         # @param display_name [String] Name shown to call recipients. No emoji; not whitespace-only.
         #
+        # @param bpo_authorizations [Array<Telnyx::Models::BpoAuthorizationInput>] Optional. Approved BPO (Business Process Outsourcer) accounts on your organizati
+        #
         # @param documents [Array<Telnyx::Models::Document>] Supporting documents. Each `document_id` may appear at most once on a DIR.
         #
         # @param logo_url [String] Publicly accessible HTTPS URL (max 128 chars) to a 256x256 BMP logo (max 1 MB).
         #
         # @param reselling [Boolean] Set to true if your organization places calls on behalf of other enterprises (BP
         #
+        # @param webhook_url [String, nil] Optional `https://` URL that receives webhook notifications when this DIR's comp
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Models::DirWrapped]