telnyx 5.169.0 → 5.171.0

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,17 +9,25 @@ 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, variables_mode: 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 variables [Array<String>] Body param: Template variables. Auto-extracted from subject/body fields when abs
+      # @param variable_schema [Hash{Symbol=>Telnyx::Models::EmailTemplateCreateParams::VariableSchema}, nil] Body param: Structured variable requirements. Required variables cannot define d
+      #
+      # @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
       #
@@ -62,22 +70,33 @@ 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, variables_mode: 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 variables [Array<String>]
+      # @param variable_schema [Hash{Symbol=>Telnyx::Models::UpdateEmailTemplateRequest::VariableSchema}, nil] Structured variable requirements. Required variables cannot define defaults; inv
+      #
+      # @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]
       #
@@ -98,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: {})
       #
-      # @overload list(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
+      #
+      # @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.
       #
@@ -117,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
@@ -151,6 +187,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,22 +215,33 @@ 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, variables_mode: 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 variables [Array<String>]
+      # @param variable_schema [Hash{Symbol=>Telnyx::Models::UpdateEmailTemplateRequest::VariableSchema}, nil] Structured variable requirements. Required variables cannot define defaults; inv
+      #
+      # @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]

data/lib/telnyx/resources/enterprises/reputation/external_verification.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Enterprises
+      class Reputation
+        # Phone-number reputation monitoring (spam-score lookup and tracking).
+        class ExternalVerification
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::Enterprises::Reputation::ExternalVerificationCreateParams} for
+          # more details.
+          #
+          # Request permission to add phone numbers that the enterprise owns but that are
+          # hosted with another provider. Submit one or more uploaded documents proving
+          # ownership, such as a carrier invoice or account statement. The request is
+          # reviewed once per enterprise. While it is `pending` or `rejected` you can submit
+          # again to replace the documents; once `approved` it cannot be changed.
+          #
+          # @overload create(enterprise_id, document_ids:, phone_numbers: nil, request_options: {})
+          #
+          # @param enterprise_id [String] The enterprise id. Lowercase UUID.
+          #
+          # @param document_ids [Array<String>] Ids of uploaded documents (Documents API) proving the enterprise owns its phone
+          #
+          # @param phone_numbers [Array<String>] Optional. The phone numbers hosted with another provider that the documents cove
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::Enterprises::Reputation::ExternalVerificationWrapped]
+          #
+          # @see Telnyx::Models::Enterprises::Reputation::ExternalVerificationCreateParams
+          def create(enterprise_id, params)
+            parsed, options = Telnyx::Enterprises::Reputation::ExternalVerificationCreateParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: ["enterprises/%1$s/reputation/external_verification", enterprise_id],
+              body: parsed,
+              model: Telnyx::Enterprises::Reputation::ExternalVerificationWrapped,
+              options: options
+            )
+          end
+
+          # Get the review status of the enterprise's ownership proof for phone numbers
+          # hosted with another provider. Returns 404 when no proof has been submitted.
+          #
+          # @overload list(enterprise_id, request_options: {})
+          #
+          # @param enterprise_id [String] The enterprise id. Lowercase UUID.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::Enterprises::Reputation::ExternalVerificationWrapped]
+          #
+          # @see Telnyx::Models::Enterprises::Reputation::ExternalVerificationListParams
+          def list(enterprise_id, params = {})
+            @client.request(
+              method: :get,
+              path: ["enterprises/%1$s/reputation/external_verification", enterprise_id],
+              model: Telnyx::Enterprises::Reputation::ExternalVerificationWrapped,
+              options: params[:request_options]
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Telnyx::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/enterprises/reputation/loa.rb

@@ -50,7 +50,7 @@ module Telnyx
           #
           # @param enterprise_id [String] The enterprise id. Lowercase UUID.
           #
-          # @param agent [Telnyx::Models::Enterprises::Reputation::AgentInput] Third-party reseller / partner managing the enterprise's phone numbers. Omit whe
+          # @param agent [Telnyx::Models::Enterprises::Reputation::LoaRenderParams::Agent] Third-party reseller / partner managing the enterprise's phone numbers. Omit whe
           #
           # @param signature [Telnyx::Models::Enterprises::Reputation::LoaRenderParams::Signature] Optional signature embedded in the rendered PDF. When omitted the PDF is returne
           #

data/lib/telnyx/resources/enterprises/reputation/numbers.rb

@@ -50,14 +50,18 @@ module Telnyx
           # enterprise. The response includes the latest reputation snapshot per number
           # where one has been collected.
           #
-          # @overload list(enterprise_id, filter_phone_number_contains: nil, filter_phone_number_eq: nil, page_number: nil, page_size: nil, request_options: {})
+          # @overload list(enterprise_id, filter_ownership_status: nil, filter_phone_number_contains: nil, filter_phone_number_eq: nil, filter_source: nil, page_number: nil, page_size: nil, request_options: {})
           #
           # @param enterprise_id [String] The enterprise id. Lowercase UUID.
           #
+          # @param filter_ownership_status [Symbol, Telnyx::Models::Enterprises::Reputation::ReputationOwnershipStatus] Only numbers with this ownership status. `removed` lists the numbers that were r
+          #
           # @param filter_phone_number_contains [String] Partial match on phone number. Must contain at least 5 digits.
           #
           # @param filter_phone_number_eq [String] Exact phone-number match (E.164).
           #
+          # @param filter_source [Symbol, Telnyx::Models::Enterprises::Reputation::ReputationNumberSource] Only numbers with this source.
+          #
           # @param page_number [Integer] 1-based page number. Out-of-range values return an empty page with correct meta.
           #
           # @param page_size [Integer] Items per page. Default 10. Maximum 250; values above are clamped to 250.
@@ -74,8 +78,10 @@ module Telnyx
               method: :get,
               path: ["enterprises/%1$s/reputation/numbers", enterprise_id],
               query: query.transform_keys(
+                filter_ownership_status: "filter[ownership_status]",
                 filter_phone_number_contains: "filter[phone_number][contains]",
                 filter_phone_number_eq: "filter[phone_number][eq]",
+                filter_source: "filter[source]",
                 page_number: "page[number]",
                 page_size: "page[size]"
               ),
@@ -86,8 +92,9 @@ module Telnyx
           end
 
           # Add up to 100 phone numbers to reputation monitoring on this enterprise. Each
-          # must be in E.164 format (`+1NPANXXXXXX` for US/CA) and belong to your Telnyx
-          # phone-number inventory.
+          # must be in E.164 format (`+1NPANXXXXXX` for US/CA). A number in your Telnyx
+          # phone-number inventory is accepted as `source: telnyx`; a number that is not is
+          # treated as hosted with another provider and must meet the requirements below.
           #
           # **Prerequisite**: reputation must already be enabled on this enterprise (see
           # `POST .../reputation`).
@@ -95,6 +102,14 @@ module Telnyx
           # **Pricing:** This is a billable action. See https://telnyx.com/pricing/numbers
           # for current pricing.
           #
+          # A phone number that is not in your Telnyx inventory is treated as a number
+          # hosted with another provider (`source: external`). It must be a US local number,
+          # and the enterprise's ownership proof must be approved first
+          # (`POST /enterprises/{enterprise_id}/reputation/external_verification`);
+          # otherwise the request fails with a 400 whose `detail` contains
+          # `external_verification_required`. Ownership of such numbers is checked every
+          # day.
+          #
           # @overload associate(enterprise_id, phone_numbers:, request_options: {})
           #
           # @param enterprise_id [String] The enterprise id. Lowercase UUID.
@@ -149,6 +164,55 @@ module Telnyx
             )
           end
 
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::Enterprises::Reputation::NumberOwnershipConfirmParams} for more
+          # details.
+          #
+          # Answer an ownership question about a phone number hosted with another provider.
+          #
+          # Send `still_own: true` to confirm you still own a number whose
+          # `ownership_status` is `pending_confirmation` or `flagged`; its status returns to
+          # `verified` and, after a carrier change, the new carrier becomes the one on
+          # record.
+          #
+          # Send `still_own: false` to report that you no longer own the number. It is
+          # removed from Number Reputation immediately, whatever its current status, and the
+          # response shows it with `ownership_status: removed`.
+          #
+          # @overload ownership_confirm(phone_number, enterprise_id:, still_own:, evidence_document_id: nil, request_options: {})
+          #
+          # @param phone_number [String] Path param: Phone number in E.164 format (`+1NPANXXXXXX` for US/CA). The leading
+          #
+          # @param enterprise_id [String] Path param: The enterprise id. Lowercase UUID.
+          #
+          # @param still_own [Boolean] Body param: `true` confirms you still own the number. `false` reports that you n
+          #
+          # @param evidence_document_id [String] Body param: Optional id of an uploaded document supporting the confirmation.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::Enterprises::Reputation::ReputationPhoneNumberWithReputation]
+          #
+          # @see Telnyx::Models::Enterprises::Reputation::NumberOwnershipConfirmParams
+          def ownership_confirm(phone_number, params)
+            parsed, options = Telnyx::Enterprises::Reputation::NumberOwnershipConfirmParams.dump_request(params)
+            enterprise_id =
+              parsed.delete(:enterprise_id) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+            @client.request(
+              method: :post,
+              path: [
+                "enterprises/%1$s/reputation/numbers/%2$s/ownership_confirm",
+                enterprise_id,
+                phone_number
+              ],
+              body: parsed,
+              model: Telnyx::Enterprises::Reputation::ReputationPhoneNumberWithReputation,
+              options: options
+            )
+          end
+
           # Some parameter documentations has been truncated, see
           # {Telnyx::Models::Enterprises::Reputation::NumberRefreshParams} for more details.
           #
@@ -182,6 +246,38 @@ module Telnyx
             )
           end
 
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::Enterprises::Reputation::NumberRetrieveOwnershipParams} for
+          # more details.
+          #
+          # Get the ownership status of a phone number, when it was last checked, the
+          # carrier recorded as its baseline, and the history of ownership events.
+          #
+          # @overload retrieve_ownership(phone_number, enterprise_id:, request_options: {})
+          #
+          # @param phone_number [String] Phone number in E.164 format (`+1NPANXXXXXX` for US/CA). The leading `+` MUST be
+          #
+          # @param enterprise_id [String] The enterprise id. Lowercase UUID.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::Enterprises::Reputation::NumberRetrieveOwnershipResponse]
+          #
+          # @see Telnyx::Models::Enterprises::Reputation::NumberRetrieveOwnershipParams
+          def retrieve_ownership(phone_number, params)
+            parsed, options = Telnyx::Enterprises::Reputation::NumberRetrieveOwnershipParams.dump_request(params)
+            enterprise_id =
+              parsed.delete(:enterprise_id) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+            @client.request(
+              method: :get,
+              path: ["enterprises/%1$s/reputation/numbers/%2$s/ownership", enterprise_id, phone_number],
+              model: Telnyx::Models::Enterprises::Reputation::NumberRetrieveOwnershipResponse,
+              options: options
+            )
+          end
+
           # @api private
           #
           # @param client [Telnyx::Client]

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

@@ -17,6 +17,10 @@ module Telnyx
         # @return [Telnyx::Resources::Enterprises::Reputation::Remediation]
         attr_reader :remediation
 
+        # Phone-number reputation monitoring (spam-score lookup and tracking).
+        # @return [Telnyx::Resources::Enterprises::Reputation::ExternalVerification]
+        attr_reader :external_verification
+
         # Phone Number Reputation tracks how your outbound caller-IDs are perceived (spam
         # risk, engagement, etc.) across the call-screening ecosystem. This endpoint reads
         # the enterprise-level settings: whether the product is enabled, the refresh
@@ -141,6 +145,36 @@ module Telnyx
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Enterprises::ReputationUpdateWebhookParams} for more details.
+        #
+        # Set the HTTPS URL that receives number-ownership events for this enterprise:
+        # `number_reputation.number.flagged`, `number_reputation.number.removed` and
+        # `number_reputation.external_verification.status_changed`. Send
+        # `webhook_url: null` to stop receiving them.
+        #
+        # @overload update_webhook(enterprise_id, webhook_url:, request_options: {})
+        #
+        # @param enterprise_id [String] The enterprise id. Lowercase UUID.
+        #
+        # @param webhook_url [String, nil] HTTPS URL on a publicly routable host. Send `null` to stop receiving number-owne
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Enterprises::EnterpriseReputationPublicWrapped]
+        #
+        # @see Telnyx::Models::Enterprises::ReputationUpdateWebhookParams
+        def update_webhook(enterprise_id, params)
+          parsed, options = Telnyx::Enterprises::ReputationUpdateWebhookParams.dump_request(params)
+          @client.request(
+            method: :patch,
+            path: ["enterprises/%1$s/reputation/webhook", enterprise_id],
+            body: parsed,
+            model: Telnyx::Enterprises::EnterpriseReputationPublicWrapped,
+            options: options
+          )
+        end
+
         # @api private
         #
         # @param client [Telnyx::Client]
@@ -149,6 +183,8 @@ module Telnyx
           @numbers = Telnyx::Resources::Enterprises::Reputation::Numbers.new(client: client)
           @loa = Telnyx::Resources::Enterprises::Reputation::Loa.new(client: client)
           @remediation = Telnyx::Resources::Enterprises::Reputation::Remediation.new(client: client)
+          @external_verification =
+            Telnyx::Resources::Enterprises::Reputation::ExternalVerification.new(client: client)
         end
       end
     end