telnyx 5.170.0 → 5.171.0

data/rbi/telnyx/resources/calls.rbi

@@ -11,10 +11,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
@@ -23,6 +31,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
@@ -150,16 +161,28 @@ module Telnyx
         # `greeting_end` or `detect_words` is used and a `machine` is detected, you will
         # receive another `call.machine.greeting.ended` webhook when the answering machine
         # greeting ends with a beep or silence. If `detect_beep` is used, you will only
-        # receive `call.machine.greeting.ended` if a beep is detected.
+        # receive `call.machine.greeting.ended` if a beep is detected. If
+        # `answering_machine_detection` is set to `premium_ios_call_screening_detection`,
+        # Premium AMD runs with iOS Call Screening support: after an initial `machine`
+        # result, Telnyx listens for the iOS call-screening prompt to end or for an Apple
+        # Call Screening tone, sends `call.machine.premium.greeting.ended` with
+        # `result=prompt_ended` or `call.machine.premium.call_screening.detected` with
+        # `result=screening` respectively. When the Apple Call Screening tone is detected,
+        # Premium AMD is restarted on the screened call and a
+        # `call.machine.premium.detection.ended` webhook with the post-screening
+        # classification follows.
         answering_machine_detection: nil,
         # Optional configuration parameters to modify 'answering_machine_detection'
         # performance. Only `total_analysis_time_millis` and `greeting_duration_millis`
         # parameters are applicable when `premium` is selected as
-        # answering_machine_detection.
+        # answering_machine_detection. `prompt_end_timeout_millis` is additionally
+        # applicable when `premium_ios_call_screening_detection` is selected.
         answering_machine_detection_config: nil,
-        # AI Assistant configuration. All fields except `id` are optional — the
-        # assistant's stored configuration will be used as fallback for any omitted
-        # fields.
+        # AI Assistant configuration and per-call overrides. All fields except `id` are
+        # optional. Omitted assistant fields use the stored configuration. Supplied
+        # `voice_settings` and `transcription` objects replace their stored objects rather
+        # than merging individual settings; include every setting you want to retain.
+        # `dynamic_variables` are merged, with request values taking precedence.
         assistant: nil,
         # The URL of a file to be played back to the callee when the call is answered. The
         # URL can point to either a WAV or MP3 file. media_name and audio_url cannot be

data/rbi/telnyx/resources/dir/phone_numbers.rbi

@@ -13,7 +13,6 @@ module Telnyx
             dir_id: String,
             page_number: Integer,
             page_size: Integer,
-            status: Telnyx::Dir::DirPhoneNumberStatus::OrSymbol,
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(
             Telnyx::Internal::DefaultFlatPagination[Telnyx::Dir::DirPhoneNumber]
@@ -26,18 +25,16 @@ module Telnyx
           page_number: nil,
           # Items per page. Maximum 250; values above are clamped to 250.
           page_size: nil,
-          # Filter by phone-number status.
-          status: nil,
           request_options: {}
         )
         end
 
         # 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.
         sig do
           params(
             dir_id: String,
@@ -74,6 +71,8 @@ module Telnyx
         def remove(
           # The DIR id. Lowercase UUID.
           dir_id,
+          # The phone numbers to remove from this brand, in E.164 format, up to 100 per
+          # request. They must currently be attached to this brand.
           phone_numbers:,
           request_options: {}
         )

data/rbi/telnyx/resources/dir/references.rbi

@@ -96,19 +96,22 @@ module Telnyx
           dir_id:,
           # Path param: Reference type to address.
           ref_type:,
-          # Body param: Reference contact email address.
+          # Body param: The reference's email address. We email them scheduling and dial-in
+          # instructions before we call, so use an address they check.
           email: nil,
-          # Body param: Full name of the reference contact.
+          # Body param: The full name of the person we should contact as your reference.
           full_name: nil,
-          # Body param: Job title of the reference contact.
+          # Body param: The reference contact's job title, for example CFO or Owner.
           job_title: nil,
-          # Body param: Organization the reference contact belongs to.
+          # Body param: The name of the organization the reference contact works for.
           organization: nil,
-          # Body param: Reference phone number in E.164 format.
+          # Body param: The reference's phone number in E.164 format, for example
+          # +14155550123. We call this number during their local business hours.
           phone_e164: nil,
           # Body param: How the reference contact is related to the registering business.
           relationship_to_registrant: nil,
-          # Body param: IANA timezone id for the reference.
+          # Body param: The reference's IANA time zone, for example America/New_York. We
+          # only call during their local 8am to 9pm hours, which is why we need it.
           timezone: nil,
           request_options: {}
         )

data/rbi/telnyx/resources/dir.rbi

@@ -47,17 +47,21 @@ 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.
       sig do
         params(
           dir_id: String,
           authorizer_email: String,
           authorizer_name: String,
+          bpo_authorizations: T::Array[Telnyx::BpoAuthorizationInput::OrHash],
           call_reasons: T::Array[String],
           certify_brand_is_accurate: T::Boolean,
           certify_ip_ownership: T::Boolean,
@@ -66,6 +70,7 @@ module Telnyx
           documents: T::Array[Telnyx::Document::OrHash],
           logo_url: String,
           reselling: T::Boolean,
+          webhook_url: T.nilable(String),
           request_options: Telnyx::RequestOptions::OrHash
         ).returns(Telnyx::DirWrapped)
       end
@@ -78,6 +83,13 @@ module Telnyx
         # Name of the person at your enterprise authorizing this DIR. Must be a real
         # individual.
         authorizer_name: nil,
+        # Optional. Replace this DIR's authorized BPO (Business Process Outsourcer)
+        # accounts with these, each with its signed Letter of Authorization. The supplied
+        # list replaces the current one: a BPO left out has its authorization removed, and
+        # a new BPO (or a changed Letter of Authorization) is created `pending` admin
+        # review. Send an empty list to clear all authorizations; omit the field to leave
+        # them unchanged. Editing this list does not re-vet the DIR. Maximum 10.
+        bpo_authorizations: nil,
         # 1–10 reasons your business calls customers. Validate phrasing against
         # `POST /call_reasons/validate`.
         call_reasons: nil,
@@ -102,6 +114,10 @@ module Telnyx
         # Set to true if your organization places calls on behalf of other enterprises
         # (BPO/reseller). Updating this triggers re-vetting on next submit.
         reselling: nil,
+        # Optional `https://` URL that receives webhook notifications when this DIR's
+        # compliance review completes. Send `null` to clear. Changing only this field on a
+        # `verified` DIR does not re-vet it. Maximum 2048 characters.
+        webhook_url: nil,
         request_options: {}
       )
       end
@@ -153,14 +169,18 @@ 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.
       sig do
         params(
           dir_id: String,
           request_options: Telnyx::RequestOptions::OrHash
-        ).void
+        ).returns(Telnyx::Models::DirDeleteResponse)
       end
       def delete(
         # The DIR id. Lowercase UUID.
@@ -169,6 +189,40 @@ module Telnyx
       )
       end
 
+      # 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`.
+      sig do
+        params(
+          dir_id: String,
+          bpo_enterprise_id: String,
+          signature: Telnyx::SignaturePayload::OrHash,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(StringIO)
+      end
+      def bpo_loa(
+        # The DIR id.
+        dir_id,
+        # The approved BPO enterprise the Brand Owner is authorizing. Must be a BPO
+        # account on the caller's organization that has already been approved.
+        bpo_enterprise_id:,
+        # Optional. When provided the rendered PDF embeds the signature image, printed
+        # name, and signed-at date. When absent the PDF is returned unsigned so the Brand
+        # Owner can sign externally and the BPO can upload it via the Documents API.
+        signature: nil,
+        request_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
@@ -223,7 +277,7 @@ module Telnyx
           dir_id: String,
           phone_numbers: T::Array[String],
           agent: Telnyx::Enterprises::Reputation::AgentInput::OrHash,
-          signature: Telnyx::DirNewLoaParams::Signature::OrHash,
+          signature: Telnyx::SignaturePayload::OrHash,
           request_options: Telnyx::RequestOptions::OrHash
         ).returns(StringIO)
       end
@@ -233,8 +287,9 @@ module Telnyx
         # Telephone numbers to authorize on the DIR, in `+E164` format (`+` followed by
         # 10-15 digits). Max 15 per request.
         phone_numbers:,
-        # Third-party reseller / partner managing the enterprise's phone numbers. Omit
-        # when the enterprise works directly with Telnyx.
+        # Third-party reseller / partner managing the enterprise's phone numbers on its
+        # behalf, such as a call center (BPO) acting for a client. Omit when the
+        # enterprise manages its own numbers.
         agent: nil,
         # Optional. When provided the rendered PDF embeds the signature image, printed
         # name, and signed-at date. When absent the PDF is returned unsigned so the
@@ -244,6 +299,37 @@ module Telnyx
       )
       end
 
+      # 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.
+      sig do
+        params(
+          dir_id: String,
+          page_number: Integer,
+          page_size: Integer,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::Models::DirRetrieveBpoAuthorizationsResponse)
+      end
+      def retrieve_bpo_authorizations(
+        # The DIR id. Lowercase UUID.
+        dir_id,
+        # 1-based page number. Out-of-range values return an empty page with correct meta.
+        page_number: nil,
+        # Items per page. Maximum 250; values above are clamped to 250.
+        page_size: nil,
+        request_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
@@ -252,7 +338,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.
       sig do
         params(
           dir_id: String,
@@ -298,13 +384,16 @@ module Telnyx
         certify_brand_is_accurate:,
         # Must be `true`.
         certify_ip_ownership:,
-        # Must be `true`.
+        # Check to certify that the brand no longer infringes anyone else's trademark or
+        # intellectual property.
         certify_no_infringement:,
         # Must be `true`.
         certify_no_shaft_content:,
         # Explanation of how the infringement concern was addressed.
         infringement_resolution_notes:,
         call_reasons: nil,
+        # The business name shown to call recipients, 1 to 35 characters, no emoji, not
+        # blank.
         display_name: nil,
         # Append-only supporting documents to attach while resolving the claim (e.g.
         # authorization or licensing proof).

data/rbi/telnyx/resources/email_templates.rbi

@@ -20,7 +20,9 @@ module Telnyx
                 Telnyx::EmailTemplateCreateParams::VariableSchema::OrHash
               ]
             ),
-          variables: T::Array[String],
+          variables: T.nilable(T::Array[String]),
+          variables_mode:
+            Telnyx::EmailTemplateCreateParams::VariablesMode::OrSymbol,
           idempotency_key: String,
           request_options: Telnyx::RequestOptions::OrHash
         ).returns(Telnyx::EmailTemplateResponse)
@@ -58,9 +60,17 @@ module Telnyx
         # while present values such as `false` and `0` pass (they are present, not empty).
         # Optional variables fall back to their `default` when absent.
         variable_schema: nil,
-        # Body param: Template variables. Auto-extracted from subject/body fields when
-        # absent.
+        # Body param: Persisted variable names. In `automatic` mode a non-null array is
+        # rejected; in `explicit` mode this is the exact manual array and each item is
+        # limited to 255 Unicode code points.
         variables: nil,
+        # Body param: Controls how `variables` is maintained. If both fields are omitted
+        # (or `variables` is null), the template uses `automatic` mode and extracts
+        # variable names from the effective subject, HTML body, and text body. A non-null
+        # `variables` array with no mode selects `explicit`. `automatic` rejects a
+        # simultaneous non-null array; `explicit` requires a non-null array, including
+        # valid `[]`, and preserves its exact order, duplicates, and string contents.
+        variables_mode: nil,
         # Header param: Optional opaque, unquoted key for safely retrying the same logical
         # request. Keys must contain 1 to 255 letters, numbers, hyphens, or underscores.
         # Generate a unique UUID v4 for each operation and reuse it only when retrying
@@ -107,7 +117,9 @@ module Telnyx
                 Telnyx::UpdateEmailTemplateRequest::VariableSchema::OrHash
               ]
             ),
-          variables: T::Array[String],
+          variables: T.nilable(T::Array[String]),
+          variables_mode:
+            Telnyx::UpdateEmailTemplateRequest::VariablesMode::OrSymbol,
           request_options: Telnyx::RequestOptions::OrHash
         ).returns(Telnyx::EmailTemplateResponse)
       end
@@ -128,14 +140,35 @@ module Telnyx
         # Structured variable requirements. Required variables cannot define defaults;
         # invalid combinations return 422. Set to `null` to clear the schema.
         variable_schema: nil,
+        # Persisted variable names. In `automatic` mode a non-null array is rejected; in
+        # `explicit` mode this is the exact manual array and each item is limited to 255
+        # Unicode code points.
         variables: nil,
+        # Controls how `variables` is maintained. Setting `automatic` re-extracts
+        # immediately from the effective subject, HTML body, and text body and rejects a
+        # simultaneous non-null array. Setting `explicit` requires the exact non-null
+        # array, including valid `[]`. With the mode omitted, a non-null array selects
+        # explicit mode, null selects automatic mode, and omitting both fields preserves
+        # the current mode. Source-content changes re-extract only in automatic mode.
+        variables_mode: nil,
         request_options: {}
       )
       end
 
-      # 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.
       sig do
         params(
+          filter_autoescape:
+            Telnyx::EmailTemplateListParams::FilterAutoescape::OrSymbol,
+          filter_content_type:
+            Telnyx::EmailTemplateListParams::FilterContentType::OrSymbol,
+          filter_query: String,
+          filter_strict_variables:
+            Telnyx::EmailTemplateListParams::FilterStrictVariables::OrSymbol,
           page_cursor: String,
           page_size: Integer,
           request_options: Telnyx::RequestOptions::OrHash
@@ -144,6 +177,23 @@ module Telnyx
         )
       end
       def list(
+        # Exact match on the template's `autoescape` option. Only the exact query strings
+        # `true` and `false` are accepted; other values, including blank, return 400.
+        filter_autoescape: nil,
+        # Matches templates by stored body presence. `html_and_text` requires both an HTML
+        # and text body; `html_only` requires HTML and no text body; `text_only` requires
+        # text and no HTML body; `no_body` requires neither. `null` and exactly `""` count
+        # as absent; whitespace-only strings count as content. An empty or unsupported
+        # value returns a 400 response.
+        filter_content_type: nil,
+        # Case-insensitive literal substring match over the template `name` or stored
+        # `subject` only; bodies are never searched. `%`, `_`, and `\` are literal
+        # characters with no wildcard meaning. A blank value is treated as omitted.
+        filter_query: nil,
+        # Exact match on the template's `strict_variables` option. Only the exact query
+        # strings `true` and `false` are accepted; other values, including blank,
+        # return 400.
+        filter_strict_variables: nil,
         # Opaque URL-safe Base64 cursor returned by a previous list response.
         page_cursor: nil,
         # Number of results to return. Defaults to 25; maximum is 100. Invalid values are
@@ -208,7 +258,9 @@ module Telnyx
                 Telnyx::UpdateEmailTemplateRequest::VariableSchema::OrHash
               ]
             ),
-          variables: T::Array[String],
+          variables: T.nilable(T::Array[String]),
+          variables_mode:
+            Telnyx::UpdateEmailTemplateRequest::VariablesMode::OrSymbol,
           request_options: Telnyx::RequestOptions::OrHash
         ).returns(Telnyx::EmailTemplateResponse)
       end
@@ -229,7 +281,17 @@ module Telnyx
         # Structured variable requirements. Required variables cannot define defaults;
         # invalid combinations return 422. Set to `null` to clear the schema.
         variable_schema: nil,
+        # Persisted variable names. In `automatic` mode a non-null array is rejected; in
+        # `explicit` mode this is the exact manual array and each item is limited to 255
+        # Unicode code points.
         variables: nil,
+        # Controls how `variables` is maintained. Setting `automatic` re-extracts
+        # immediately from the effective subject, HTML body, and text body and rejects a
+        # simultaneous non-null array. Setting `explicit` requires the exact non-null
+        # array, including valid `[]`. With the mode omitted, a non-null array selects
+        # explicit mode, null selects automatic mode, and omitting both fields preserves
+        # the current mode. Source-content changes re-extract only in automatic mode.
+        variables_mode: nil,
         request_options: {}
       )
       end

data/rbi/telnyx/resources/enterprises/dir.rbi

@@ -27,10 +27,16 @@ 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.
         sig do
           params(
             enterprise_id: String,
@@ -44,9 +50,11 @@ module Telnyx
             certify_no_shaft_content:
               Telnyx::Enterprises::DirCreateParams::CertifyNoShaftContent::OrBoolean,
             display_name: String,
+            bpo_authorizations: T::Array[Telnyx::BpoAuthorizationInput::OrHash],
             documents: T::Array[Telnyx::Document::OrHash],
             logo_url: String,
             reselling: T::Boolean,
+            webhook_url: T.nilable(String),
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(Telnyx::DirWrapped)
         end
@@ -62,7 +70,8 @@ module Telnyx
           # 1–10 reasons your business calls customers. Validate phrasing against
           # `POST /call_reasons/validate`.
           call_reasons:,
-          # Must be `true`.
+          # Certification that the DIR information is accurate. Must be `true` for the DIR
+          # to be submitted for vetting.
           certify_brand_is_accurate:,
           # Must be `true`. Confirms ownership of any logos/trademarks shown.
           certify_ip_ownership:,
@@ -71,6 +80,13 @@ module Telnyx
           certify_no_shaft_content:,
           # Name shown to call recipients. No emoji; not whitespace-only.
           display_name:,
+          # Optional. Approved BPO (Business Process Outsourcer) accounts on your
+          # organization authorized to place branded calls for this DIR, each with the
+          # signed Letter of Authorization the Brand Owner granted it. Each authorization
+          # starts `pending` and takes effect only after an admin reviews its Letter of
+          # Authorization. Omit or send an empty list to authorize no BPO on this DIR.
+          # Maximum 10.
+          bpo_authorizations: nil,
           # Supporting documents. Each `document_id` may appear at most once on a DIR.
           documents: nil,
           # Publicly accessible HTTPS URL (max 128 chars) to a 256x256 BMP logo (max 1 MB).
@@ -78,6 +94,10 @@ module Telnyx
           # Set to true if your organization places calls on behalf of other enterprises
           # (BPO/reseller).
           reselling: nil,
+          # Optional `https://` URL that receives webhook notifications when this DIR's
+          # compliance review completes (rejection outcomes include structured rejection
+          # reasons). Maximum 2048 characters.
+          webhook_url: nil,
           request_options: {}
         )
         end

data/rbi/telnyx/resources/enterprises/reputation/external_verification.rbi

@@ -0,0 +1,65 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class Enterprises
+      class Reputation
+        # Phone-number reputation monitoring (spam-score lookup and tracking).
+        class ExternalVerification
+          # 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.
+          sig do
+            params(
+              enterprise_id: String,
+              document_ids: T::Array[String],
+              phone_numbers: T::Array[String],
+              request_options: Telnyx::RequestOptions::OrHash
+            ).returns(
+              Telnyx::Enterprises::Reputation::ExternalVerificationWrapped
+            )
+          end
+          def create(
+            # The enterprise id. Lowercase UUID.
+            enterprise_id,
+            # Ids of uploaded documents (Documents API) proving the enterprise owns its phone
+            # numbers hosted with another provider, for example a carrier invoice or account
+            # statement.
+            document_ids:,
+            # Optional. The phone numbers hosted with another provider that the documents
+            # cover, in E.164 format. Shown to the reviewer to match the documents to your
+            # numbers; you can still add numbers that are not listed here, and each is checked
+            # on its own.
+            phone_numbers: nil,
+            request_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.
+          sig do
+            params(
+              enterprise_id: String,
+              request_options: Telnyx::RequestOptions::OrHash
+            ).returns(
+              Telnyx::Enterprises::Reputation::ExternalVerificationWrapped
+            )
+          end
+          def list(
+            # The enterprise id. Lowercase UUID.
+            enterprise_id,
+            request_options: {}
+          )
+          end
+
+          # @api private
+          sig { params(client: Telnyx::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/enterprises/reputation/loa.rbi

@@ -37,7 +37,8 @@ module Telnyx
           sig do
             params(
               enterprise_id: String,
-              agent: Telnyx::Enterprises::Reputation::AgentInput::OrHash,
+              agent:
+                Telnyx::Enterprises::Reputation::LoaRenderParams::Agent::OrHash,
               signature:
                 Telnyx::Enterprises::Reputation::LoaRenderParams::Signature::OrHash,
               request_options: Telnyx::RequestOptions::OrHash