telnyx 5.170.0 → 5.171.0

data/lib/telnyx/resources/calls.rb

@@ -14,10 +14,18 @@ module Telnyx
       # include a `call_leg_id` which can be used to correlate the command with
       # subsequent webhooks.
       #
+      # To place the call with an AI assistant from the start, include `assistant.id`
+      # and any per-call overrides in the `assistant` object; Telnyx attempts to warm up
+      # the assistant before placing the call and starts it automatically when the
+      # called party answers.
+      #
       # **Expected Webhooks:**
       #
       # - `call.initiated`
       # - `call.answered` or `call.hangup`
+      # - `call.conversation.created` when the requested assistant conversation is
+      #   created, or `call.conversation.start_failed` when it could not be started
+      #   after the called party answered
       # - `call.hold` and `call.unhold` if the call is held/unheld
       # - `call.machine.detection.ended` if `answering_machine_detection` was requested
       # - `call.machine.greeting.ended` if `answering_machine_detection` was requested
@@ -26,6 +34,9 @@ module Telnyx
       #   `answering_machine_detection=premium` was requested
       # - `call.machine.premium.greeting.ended` if `answering_machine_detection=premium`
       #   was requested and a beep was detected
+      # - `call.machine.premium.call_screening.detected` if
+      #   `answering_machine_detection=premium_ios_call_screening_detection` was
+      #   requested and an Apple Call Screening tone was detected
       # - `call.deepfake_detection.result` if `deepfake_detection` was enabled
       # - `call.deepfake_detection.error` if `deepfake_detection` was enabled and an
       #   error occurred
@@ -47,7 +58,7 @@ module Telnyx
       #
       # @param answering_machine_detection_config [Telnyx::Models::CallDialParams::AnsweringMachineDetectionConfig] Optional configuration parameters to modify 'answering_machine_detection' perfor
       #
-      # @param assistant [Telnyx::Models::CallAssistantRequest] AI Assistant configuration. All fields except `id` are optional — the assistant'
+      # @param assistant [Telnyx::Models::CallAssistantRequest] AI Assistant configuration and per-call overrides. All fields except `id` are op
       #
       # @param audio_url [String] The URL of a file to be played back to the callee when the call is answered. The
       #

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

@@ -12,7 +12,7 @@ module Telnyx
         # List the phone numbers registered under a DIR. The enterprise is resolved
         # server-side from the DIR id.
         #
-        # @overload list(dir_id, page_number: nil, page_size: nil, status: nil, request_options: {})
+        # @overload list(dir_id, page_number: nil, page_size: nil, request_options: {})
         #
         # @param dir_id [String] The DIR id. Lowercase UUID.
         #
@@ -20,8 +20,6 @@ module Telnyx
         #
         # @param page_size [Integer] Items per page. Maximum 250; values above are clamped to 250.
         #
-        # @param status [Symbol, Telnyx::Models::Dir::DirPhoneNumberStatus] Filter by phone-number status.
-        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::Dir::DirPhoneNumber>]
@@ -44,11 +42,11 @@ module Telnyx
         # {Telnyx::Models::Dir::PhoneNumberAddParams} for more details.
         #
         # Register phone numbers under a DIR. The enterprise is resolved server-side from
-        # the DIR id. Same body, failure modes, and batch semantics whichever path form
-        # you use.
+        # the DIR id.
         #
-        # **Pricing:** This is a billable action. See https://telnyx.com/pricing/numbers
-        # for current pricing.
+        # **Pricing:** Adding phone numbers is free. Branded Calling fees are charged per
+        # DIR and per branded call. See https://telnyx.com/pricing/branded-calling for
+        # current pricing.
         #
         # @overload add(dir_id, documents:, phone_numbers:, request_options: {})
         #
@@ -74,6 +72,9 @@ module Telnyx
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Dir::PhoneNumberRemoveParams} for more details.
+        #
         # Deregister phone numbers from a DIR. The enterprise is resolved server-side from
         # the DIR id. Returns a partial-success envelope.
         #
@@ -81,7 +82,7 @@ module Telnyx
         #
         # @param dir_id [String] The DIR id. Lowercase UUID.
         #
-        # @param phone_numbers [Array<String>]
+        # @param phone_numbers [Array<String>] The phone numbers to remove from this brand, in E.164 format, up to 100 per requ
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #

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

@@ -84,19 +84,19 @@ module Telnyx
         #
         # @param ref_type [Symbol, Telnyx::Models::Dir::ReferenceUpdateParams::RefType] Path param: Reference type to address.
         #
-        # @param email [String] Body param: Reference contact email address.
+        # @param email [String] Body param: The reference's email address. We email them scheduling and dial-in
         #
-        # @param full_name [String] Body param: Full name of the reference contact.
+        # @param full_name [String] Body param: The full name of the person we should contact as your reference.
         #
-        # @param job_title [String, nil] Body param: Job title of the reference contact.
+        # @param job_title [String, nil] Body param: The reference contact's job title, for example CFO or Owner.
         #
-        # @param organization [String, nil] Body param: Organization the reference contact belongs to.
+        # @param organization [String, nil] Body param: The name of the organization the reference contact works for.
         #
-        # @param phone_e164 [String] Body param: Reference phone number in E.164 format.
+        # @param phone_e164 [String] Body param: The reference's phone number in E.164 format, for example +141555501
         #
         # @param relationship_to_registrant [String, nil] Body param: How the reference contact is related to the registering business.
         #
-        # @param timezone [String] Body param: IANA timezone id for the reference.
+        # @param timezone [String] Body param: The reference's IANA time zone, for example America/New_York. We onl
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #

data/lib/telnyx/resources/dir.rb

@@ -56,14 +56,17 @@ module Telnyx
       # Edit a DIR. DIRs in `draft`, `rejected`, `unsuccessful`, or `suspended` can be
       # edited freely: PATCH is a pure edit, `status` is never changed, and you re-vet
       # by calling `POST /v2/dir/{dir_id}/submit` explicitly. A `verified` DIR can also
-      # be edited in place: a PATCH that changes any value returns the DIR to `draft`
-      # and branded delivery stops until you re-submit and the DIR is approved again,
-      # while a PATCH that changes nothing (an empty body or values identical to the
-      # current ones) leaves the DIR `verified`, so idempotent retries are safe. DIRs in
-      # any other status (`submitted`, `in_review`, `expired`, `infringement_claimed`,
+      # be edited in place: a PATCH that changes any value returns the DIR to `draft`;
+      # the currently approved identity keeps displaying, and the edited content goes
+      # live only after you re-submit and the DIR is approved again. A PATCH that
+      # changes nothing (an empty body or values identical to the current ones) leaves
+      # the DIR `verified`, so idempotent retries are safe. Changing only
+      # `bpo_authorizations` or `webhook_url` is the exception: the DIR stays
+      # `verified`. Each BPO authorization is reviewed on its own instead. DIRs in any
+      # other status (`submitted`, `in_review`, `expired`, `infringement_claimed`,
       # `permanently_rejected`) cannot be edited.
       #
-      # @overload update(dir_id, authorizer_email: nil, authorizer_name: nil, call_reasons: nil, certify_brand_is_accurate: nil, certify_ip_ownership: nil, certify_no_shaft_content: nil, display_name: nil, documents: nil, logo_url: nil, reselling: nil, request_options: {})
+      # @overload update(dir_id, authorizer_email: nil, authorizer_name: nil, bpo_authorizations: nil, call_reasons: nil, certify_brand_is_accurate: nil, certify_ip_ownership: nil, certify_no_shaft_content: nil, display_name: nil, documents: nil, logo_url: nil, reselling: nil, webhook_url: nil, request_options: {})
       #
       # @param dir_id [String] The DIR id. Lowercase UUID.
       #
@@ -71,6 +74,8 @@ module Telnyx
       #
       # @param authorizer_name [String] Name of the person at your enterprise authorizing this DIR. Must be a real indiv
       #
+      # @param bpo_authorizations [Array<Telnyx::Models::BpoAuthorizationInput>] Optional. Replace this DIR's authorized BPO (Business Process Outsourcer) accoun
+      #
       # @param call_reasons [Array<String>] 1–10 reasons your business calls customers. Validate phrasing against `POST /cal
       #
       # @param certify_brand_is_accurate [Boolean] Certification that the DIR information is accurate. Must be `true` for the DIR t
@@ -87,6 +92,8 @@ module Telnyx
       #
       # @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]
@@ -162,9 +169,13 @@ module Telnyx
         )
       end
 
-      # Delete a DIR. Failure modes: `400` if a child phone number is in a non-deletable
-      # status, `409` if the DIR has an unresolved infringement claim, `404` if the DIR
-      # is not yours.
+      # Request deletion of a DIR. This does not remove the DIR on this call: it records
+      # the request, moves the DIR to `delete_requested`, and Telnyx completes the
+      # removal (de-registration and cleanup) shortly after. A verified DIR keeps
+      # serving its branded identity, and keeps billing, until the removal is executed.
+      # Failure modes: `400` if a child phone number is still attached or the DIR is
+      # `in_review` (wait for the review to finish), `409` if the DIR has an unresolved
+      # infringement claim, `404` if the DIR is not yours.
       #
       # @overload delete(dir_id, request_options: {})
       #
@@ -172,18 +183,59 @@ module Telnyx
       #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [nil]
+      # @return [Telnyx::Models::DirDeleteResponse]
       #
       # @see Telnyx::Models::DirDeleteParams
       def delete(dir_id, params = {})
         @client.request(
           method: :delete,
           path: ["dir/%1$s", dir_id],
-          model: NilClass,
+          model: Telnyx::Models::DirDeleteResponse,
           options: params[:request_options]
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::DirBpoLoaParams} for more details.
+      #
+      # The Letter of Authorization in which a Brand Owner authorizes an approved BPO
+      # (Business Process Outsourcer) to place branded calls that display this DIR on
+      # the owner's behalf. Both parties are read from the caller's account: the Brand
+      # Owner is the enterprise that owns the DIR, and the BPO is `bpo_enterprise_id`.
+      # No business identity is accepted in the body.
+      #
+      # When `signature` is omitted the PDF is returned unsigned so the Brand Owner can
+      # sign it externally and the BPO can upload it via the Documents API. When
+      # `signature` is present the PDF embeds the supplied image, printed name, and
+      # signed-at date.
+      #
+      # Returns `application/pdf`.
+      #
+      # @overload bpo_loa(dir_id, bpo_enterprise_id:, signature: nil, request_options: {})
+      #
+      # @param dir_id [String] The DIR id.
+      #
+      # @param bpo_enterprise_id [String] The approved BPO enterprise the Brand Owner is authorizing. Must be a BPO accoun
+      #
+      # @param signature [Telnyx::Models::SignaturePayload] Optional. When provided the rendered PDF embeds the signature image, printed nam
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [StringIO]
+      #
+      # @see Telnyx::Models::DirBpoLoaParams
+      def bpo_loa(dir_id, params)
+        parsed, options = Telnyx::DirBpoLoaParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["dir/%1$s/bpo_loa", dir_id],
+          headers: {"accept" => "application/pdf"},
+          body: parsed,
+          model: StringIO,
+          options: options
+        )
+      end
+
       # Reference list of `document_type` values accepted by
       # `DirCreateRequest.documents[].document_type` and the infringement-contest
       # endpoint. Each entry has a stable `short_name` (used in API calls) and a
@@ -261,9 +313,9 @@ module Telnyx
       #
       # @param phone_numbers [Array<String>] Telephone numbers to authorize on the DIR, in `+E164` format (`+` followed by 10
       #
-      # @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::AgentInput] Third-party reseller / partner managing the enterprise's phone numbers on its be
       #
-      # @param signature [Telnyx::Models::DirNewLoaParams::Signature] Optional. When provided the rendered PDF embeds the signature image, printed nam
+      # @param signature [Telnyx::Models::SignaturePayload] Optional. When provided the rendered PDF embeds the signature image, printed nam
       #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -282,6 +334,47 @@ module Telnyx
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::DirRetrieveBpoAuthorizationsParams} for more details.
+      #
+      # List the BPO (Business Process Outsourcer) accounts a Brand Owner has authorized
+      # on this DIR, together with the review state of each authorization.
+      #
+      # Authorizations are supplied as the `bpo_authorizations` array when creating or
+      # updating a DIR, and each one is reviewed on its own. Only an `approved`
+      # authorization adds that BPO to this DIR's authorized callers in the branded
+      # calling registry; `pending` and `rejected` authorizations do not. Each entry
+      # includes the `loa_document_id` you submitted: because `bpo_authorizations`
+      # replaces the whole list on every DIR update, send each entry you want to keep
+      # back with its `loa_document_id` unchanged, and it keeps its review state. A
+      # rejected entry carries a `rejection_reason`. Returns an empty list when the DIR
+      # has authorized no BPOs.
+      #
+      # @overload retrieve_bpo_authorizations(dir_id, page_number: nil, page_size: nil, request_options: {})
+      #
+      # @param dir_id [String] The DIR id. Lowercase UUID.
+      #
+      # @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. Maximum 250; values above are clamped to 250.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::DirRetrieveBpoAuthorizationsResponse]
+      #
+      # @see Telnyx::Models::DirRetrieveBpoAuthorizationsParams
+      def retrieve_bpo_authorizations(dir_id, params = {})
+        parsed, options = Telnyx::DirRetrieveBpoAuthorizationsParams.dump_request(params)
+        query = Telnyx::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["dir/%1$s/bpo_authorizations", dir_id],
+          query: query.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+          model: Telnyx::Models::DirRetrieveBpoAuthorizationsResponse,
+          options: options
+        )
+      end
+
       # Submit a DIR for vetting. Sends the DIR back through the vetting cycle from any
       # non-terminal status. When re-submitting from `suspended` or `expired`, the DIR's
       # previous Branded Calling registration is torn down transactionally and its phone
@@ -290,7 +383,7 @@ module Telnyx
       #
       # Returns `400` from `submitted`/`in_review`/`permanently_rejected`. Returns `400`
       # if the DIR's business and financial references have not been submitted. Returns
-      # `409` if the DIR has an unresolved infringement claim.
+      # `400` if the DIR has an unresolved infringement claim.
       #
       # @overload submit(dir_id, request_options: {})
       #
@@ -328,7 +421,7 @@ module Telnyx
       #
       # @param certify_ip_ownership [Boolean, Telnyx::Models::DirUpdateInfringementParams::CertifyIPOwnership] Must be `true`.
       #
-      # @param certify_no_infringement [Boolean, Telnyx::Models::DirUpdateInfringementParams::CertifyNoInfringement] Must be `true`.
+      # @param certify_no_infringement [Boolean, Telnyx::Models::DirUpdateInfringementParams::CertifyNoInfringement] Check to certify that the brand no longer infringes anyone else's trademark or i
       #
       # @param certify_no_shaft_content [Boolean, Telnyx::Models::DirUpdateInfringementParams::CertifyNoShaftContent] Must be `true`.
       #
@@ -336,7 +429,7 @@ module Telnyx
       #
       # @param call_reasons [Array<String>, nil]
       #
-      # @param display_name [String, nil]
+      # @param display_name [String, nil] The business name shown to call recipients, 1 to 35 characters, no emoji, not bl
       #
       # @param documents [Array<Telnyx::Models::Document>, nil] Append-only supporting documents to attach while resolving the claim (e.g. autho
       #

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]

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
           #