telnyx 5.170.0 → 5.173.0

data/lib/telnyx/models/dial_metric_list_params.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::DialMetrics#list
+    class DialMetricListParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      # @!attribute end_time
+      #   Exclusive end of the range, ISO 8601. Must be after `start_time`. Buckets that
+      #   start before this time are returned.
+      #
+      #   @return [Time]
+      required :end_time, Time
+
+      # @!attribute granularity
+      #   Bucket size. `second` returns 5-second buckets (the finest resolution) and is
+      #   kept for the last 48 hours. `minute` and `hour` are kept for the last 30 days.
+      #
+      #   @return [Symbol, Telnyx::Models::DialMetricListParams::Granularity]
+      required :granularity, enum: -> { Telnyx::DialMetricListParams::Granularity }
+
+      # @!attribute start_time
+      #   Inclusive start of the range, ISO 8601 (for example `2026-09-29T12:00:00.000Z`).
+      #   Buckets that start at or after this time are returned. A `start_time` older than
+      #   the retention window of the chosen `granularity` is moved forward to the start
+      #   of that window, and `meta.start_time` returns the start actually used.
+      #
+      #   @return [Time]
+      required :start_time, Time
+
+      # @!attribute page_after
+      #   Opaque cursor from `meta.cursors.after` of the previous page. Do not parse or
+      #   construct it. A cursor that matches no records returns an empty page whose
+      #   `meta.cursors.after` and `meta.cursors.before` both echo the given cursor.
+      #
+      #   @return [String, nil]
+      optional :page_after, String
+
+      # @!attribute page_limit
+      #   Maximum number of buckets per page. Values outside the range are clamped to
+      #   1-10,000.
+      #
+      #   @return [Integer, nil]
+      optional :page_limit, Integer
+
+      # @!attribute sort
+      #   Sort order of the buckets by `start_time`. `-start_time` (default) returns the
+      #   newest first, `start_time` the oldest first. `region` follows the same direction
+      #   for buckets with the same `start_time`. To read the live rate, use
+      #   `granularity=second` and `sort=-start_time`, then take the first record of each
+      #   `region`.
+      #
+      #   @return [Symbol, Telnyx::Models::DialMetricListParams::Sort, nil]
+      optional :sort, enum: -> { Telnyx::DialMetricListParams::Sort }
+
+      # @!method initialize(end_time:, granularity:, start_time:, page_after: nil, page_limit: nil, sort: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::DialMetricListParams} for more details.
+      #
+      #   @param end_time [Time] Exclusive end of the range, ISO 8601. Must be after `start_time`. Buckets that s
+      #
+      #   @param granularity [Symbol, Telnyx::Models::DialMetricListParams::Granularity] Bucket size. `second` returns 5-second buckets (the finest resolution) and is ke
+      #
+      #   @param start_time [Time] Inclusive start of the range, ISO 8601 (for example `2026-09-29T12:00:00.000Z`).
+      #
+      #   @param page_after [String] Opaque cursor from `meta.cursors.after` of the previous page. Do not parse or co
+      #
+      #   @param page_limit [Integer] Maximum number of buckets per page. Values outside the range are clamped to 1-10
+      #
+      #   @param sort [Symbol, Telnyx::Models::DialMetricListParams::Sort] Sort order of the buckets by `start_time`. `-start_time` (default) returns the n
+      #
+      #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+      # Bucket size. `second` returns 5-second buckets (the finest resolution) and is
+      # kept for the last 48 hours. `minute` and `hour` are kept for the last 30 days.
+      module Granularity
+        extend Telnyx::Internal::Type::Enum
+
+        SECOND = :second
+        MINUTE = :minute
+        HOUR = :hour
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Sort order of the buckets by `start_time`. `-start_time` (default) returns the
+      # newest first, `start_time` the oldest first. `region` follows the same direction
+      # for buckets with the same `start_time`. To read the live rate, use
+      # `granularity=second` and `sort=-start_time`, then take the first record of each
+      # `region`.
+      module Sort
+        extend Telnyx::Internal::Type::Enum
+
+        MINUS_START_TIME = :"-start_time"
+        START_TIME = :start_time
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/telnyx/models/dial_metric_list_response.rb

@@ -0,0 +1,160 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::DialMetrics#list
+    class DialMetricListResponse < Telnyx::Internal::Type::BaseModel
+      # @!attribute average_dps
+      #   `dials.total` divided by the bucket duration in seconds, rounded to 4 decimal
+      #   places. Counts every dial attempt, rejected ones included.
+      #
+      #   @return [Float, nil]
+      optional :average_dps, Float
+
+      # @!attribute dials
+      #   Dial attempt counts in the bucket.
+      #
+      #   @return [Telnyx::Models::DialMetricListResponse::Dials, nil]
+      optional :dials, -> { Telnyx::Models::DialMetricListResponse::Dials }
+
+      # @!attribute dps_limit
+      #   DPS limit in force during the busiest 5-second window, so it compares directly
+      #   with `peak_dps`. `null` means unlimited. Enforcement near the limit is
+      #   approximate; `dials.rejected.dps_limit` is the authoritative signal that the
+      #   limit was reached.
+      #
+      #   @return [Integer, nil]
+      optional :dps_limit, Integer, nil?: true
+
+      # @!attribute end_time
+      #   End of the bucket (exclusive), UTC. Five seconds, one minute or one hour after
+      #   `start_time`, depending on `granularity`.
+      #
+      #   @return [Time, nil]
+      optional :end_time, Time
+
+      # @!attribute peak_dps
+      #   Dials per second, rounded to 4 decimal places, in the busiest 5-second window of
+      #   the bucket, summed across all call-processing nodes of the region. Counts every
+      #   dial attempt, rejected ones included, so `peak_dps` above `dps_limit` is
+      #   expected when dials were rejected. For `granularity=second` it equals
+      #   `average_dps`.
+      #
+      #   @return [Float, nil]
+      optional :peak_dps, Float
+
+      # @!attribute record_type
+      #
+      #   @return [Symbol, Telnyx::Models::DialMetricListResponse::RecordType, nil]
+      optional :record_type, enum: -> { Telnyx::Models::DialMetricListResponse::RecordType }
+
+      # @!attribute region
+      #   Region where the dials were handled. Current values are `us`, `eu`, `australia`,
+      #   `middle_east`, `canada` and `india`. New values can be added, so clients must
+      #   tolerate values not listed here. Buckets of different regions are separate
+      #   records.
+      #
+      #   @return [String, nil]
+      optional :region, String
+
+      # @!attribute start_time
+      #   Start of the bucket (inclusive), UTC.
+      #
+      #   @return [Time, nil]
+      optional :start_time, Time
+
+      # @!method initialize(average_dps: nil, dials: nil, dps_limit: nil, end_time: nil, peak_dps: nil, record_type: nil, region: nil, start_time: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::DialMetricListResponse} for more details.
+      #
+      #   Dial counts and rates for one region in one time bucket. One record per region
+      #   per bucket.
+      #
+      #   @param average_dps [Float] `dials.total` divided by the bucket duration in seconds, rounded to 4 decimal pl
+      #
+      #   @param dials [Telnyx::Models::DialMetricListResponse::Dials] Dial attempt counts in the bucket.
+      #
+      #   @param dps_limit [Integer, nil] DPS limit in force during the busiest 5-second window, so it compares directly w
+      #
+      #   @param end_time [Time] End of the bucket (exclusive), UTC. Five seconds, one minute or one hour after `
+      #
+      #   @param peak_dps [Float] Dials per second, rounded to 4 decimal places, in the busiest 5-second window of
+      #
+      #   @param record_type [Symbol, Telnyx::Models::DialMetricListResponse::RecordType]
+      #
+      #   @param region [String] Region where the dials were handled. Current values are `us`, `eu`, `australia`,
+      #
+      #   @param start_time [Time] Start of the bucket (inclusive), UTC.
+
+      # @see Telnyx::Models::DialMetricListResponse#dials
+      class Dials < Telnyx::Internal::Type::BaseModel
+        # @!attribute accepted
+        #   Dial attempts that were not rejected by a limit.
+        #
+        #   @return [Integer, nil]
+        optional :accepted, Integer
+
+        # @!attribute rejected
+        #   Dial attempts rejected by a limit.
+        #
+        #   @return [Telnyx::Models::DialMetricListResponse::Dials::Rejected, nil]
+        optional :rejected, -> { Telnyx::Models::DialMetricListResponse::Dials::Rejected }
+
+        # @!attribute total
+        #   All dial attempts, rejected ones included: accepted plus every rejected count.
+        #
+        #   @return [Integer, nil]
+        optional :total, Integer
+
+        # @!method initialize(accepted: nil, rejected: nil, total: nil)
+        #   Dial attempt counts in the bucket.
+        #
+        #   @param accepted [Integer] Dial attempts that were not rejected by a limit.
+        #
+        #   @param rejected [Telnyx::Models::DialMetricListResponse::Dials::Rejected] Dial attempts rejected by a limit.
+        #
+        #   @param total [Integer] All dial attempts, rejected ones included: accepted plus every rejected count.
+
+        # @see Telnyx::Models::DialMetricListResponse::Dials#rejected
+        class Rejected < Telnyx::Internal::Type::BaseModel
+          # @!attribute daily_limit
+          #   Rejected by a daily limit.
+          #
+          #   @return [Integer, nil]
+          optional :daily_limit, Integer
+
+          # @!attribute dps_limit
+          #   Rejected by the dials-per-second limit.
+          #
+          #   @return [Integer, nil]
+          optional :dps_limit, Integer
+
+          # @!attribute hourly_limit
+          #   Rejected by an hourly limit.
+          #
+          #   @return [Integer, nil]
+          optional :hourly_limit, Integer
+
+          # @!method initialize(daily_limit: nil, dps_limit: nil, hourly_limit: nil)
+          #   Dial attempts rejected by a limit.
+          #
+          #   @param daily_limit [Integer] Rejected by a daily limit.
+          #
+          #   @param dps_limit [Integer] Rejected by the dials-per-second limit.
+          #
+          #   @param hourly_limit [Integer] Rejected by an hourly limit.
+        end
+      end
+
+      # @see Telnyx::Models::DialMetricListResponse#record_type
+      module RecordType
+        extend Telnyx::Internal::Type::Enum
+
+        DIAL_METRIC = :dial_metric
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/telnyx/models/dir/phone_number_list_params.rb

@@ -25,13 +25,7 @@ module Telnyx
         #   @return [Integer, nil]
         optional :page_size, Integer
 
-        # @!attribute status
-        #   Filter by phone-number status.
-        #
-        #   @return [Symbol, Telnyx::Models::Dir::DirPhoneNumberStatus, nil]
-        optional :status, enum: -> { Telnyx::Dir::DirPhoneNumberStatus }
-
-        # @!method initialize(dir_id:, page_number: nil, page_size: nil, status: nil, request_options: {})
+        # @!method initialize(dir_id:, page_number: nil, page_size: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::Dir::PhoneNumberListParams} for more details.
         #
@@ -41,8 +35,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}]
       end
     end

data/lib/telnyx/models/dir/phone_number_remove_params.rb

@@ -14,13 +14,20 @@ module Telnyx
         required :dir_id, String
 
         # @!attribute phone_numbers
+        #   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.
         #
         #   @return [Array<String>]
         required :phone_numbers, Telnyx::Internal::Type::ArrayOf[String]
 
         # @!method initialize(dir_id:, phone_numbers:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::Dir::PhoneNumberRemoveParams} for more details.
+        #
         #   @param dir_id [String]
-        #   @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}]
       end
     end

data/lib/telnyx/models/dir/reference_update_params.rb

@@ -24,31 +24,33 @@ module Telnyx
         required :slot, Integer
 
         # @!attribute email
-        #   Reference contact email address.
+        #   The reference's email address. We email them scheduling and dial-in instructions
+        #   before we call, so use an address they check.
         #
         #   @return [String, nil]
         optional :email, String
 
         # @!attribute full_name
-        #   Full name of the reference contact.
+        #   The full name of the person we should contact as your reference.
         #
         #   @return [String, nil]
         optional :full_name, String
 
         # @!attribute job_title
-        #   Job title of the reference contact.
+        #   The reference contact's job title, for example CFO or Owner.
         #
         #   @return [String, nil]
         optional :job_title, String, nil?: true
 
         # @!attribute organization
-        #   Organization the reference contact belongs to.
+        #   The name of the organization the reference contact works for.
         #
         #   @return [String, nil]
         optional :organization, String, nil?: true
 
         # @!attribute phone_e164
-        #   Reference phone number in E.164 format.
+        #   The reference's phone number in E.164 format, for example +14155550123. We call
+        #   this number during their local business hours.
         #
         #   @return [String, nil]
         optional :phone_e164, String
@@ -60,31 +62,35 @@ module Telnyx
         optional :relationship_to_registrant, String, nil?: true
 
         # @!attribute timezone
-        #   IANA timezone id for the reference.
+        #   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.
         #
         #   @return [String, nil]
         optional :timezone, String
 
         # @!method initialize(dir_id:, ref_type:, slot:, email: nil, full_name: nil, job_title: nil, organization: nil, phone_e164: nil, relationship_to_registrant: nil, timezone: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::Dir::ReferenceUpdateParams} for more details.
+        #
         #   @param dir_id [String]
         #
         #   @param ref_type [Symbol, Telnyx::Models::Dir::ReferenceUpdateParams::RefType]
         #
         #   @param slot [Integer]
         #
-        #   @param email [String] Reference contact email address.
+        #   @param email [String] The reference's email address. We email them scheduling and dial-in instructions
         #
-        #   @param full_name [String] Full name of the reference contact.
+        #   @param full_name [String] The full name of the person we should contact as your reference.
         #
-        #   @param job_title [String, nil] Job title of the reference contact.
+        #   @param job_title [String, nil] The reference contact's job title, for example CFO or Owner.
         #
-        #   @param organization [String, nil] Organization the reference contact belongs to.
+        #   @param organization [String, nil] The name of the organization the reference contact works for.
         #
-        #   @param phone_e164 [String] Reference phone number in E.164 format.
+        #   @param phone_e164 [String] The reference's phone number in E.164 format, for example +14155550123. We call
         #
         #   @param relationship_to_registrant [String, nil] How the reference contact is related to the registering business.
         #
-        #   @param timezone [String] IANA timezone id for the reference.
+        #   @param timezone [String] The reference's IANA time zone, for example America/New_York. We only call durin
         #
         #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
 

data/lib/telnyx/models/dir.rb

@@ -83,10 +83,21 @@ module Telnyx
       #   - `infringement_claimed` - a trademark/impersonation claim is open against this
       #     DIR.
       #   - `permanently_rejected` - terminal; cannot be resubmitted.
+      #   - `delete_requested` - you have requested deletion; the DIR still exists and
+      #     Telnyx is completing the removal (de-registration and cleanup). A verified DIR
+      #     keeps serving its branded identity, and keeps billing, until the removal
+      #     finishes.
       #
       #   @return [Symbol, Telnyx::Models::DirStatus, nil]
       optional :status, enum: -> { Telnyx::DirStatus }
 
+      # @!attribute webhook_url
+      #   `https://` URL that receives webhook notifications for this DIR's
+      #   compliance-review outcomes. `null` when not subscribed.
+      #
+      #   @return [String, nil]
+      optional :webhook_url, String, nil?: true
+
       response_only do
         # @!attribute id
         #
@@ -98,6 +109,13 @@ module Telnyx
         #   @return [Time, nil]
         optional :created_at, Time
 
+        # @!attribute delete_requested_at
+        #   When deletion was requested. Set once the DIR enters `delete_requested`; `null`
+        #   otherwise.
+        #
+        #   @return [Time, nil]
+        optional :delete_requested_at, Time, nil?: true
+
         # @!attribute expiring_at
         #
         #   @return [Time, nil]
@@ -124,7 +142,7 @@ module Telnyx
         optional :verified_at, Time, nil?: true
       end
 
-      # @!method initialize(id: nil, authorizer_email: nil, authorizer_name: nil, call_reasons: nil, certify_brand_is_accurate: nil, certify_ip_ownership: nil, certify_no_shaft_content: nil, created_at: nil, display_name: nil, documents: nil, enterprise_id: nil, expiring_at: nil, logo_url: nil, rejected_at: nil, rejection_reasons: nil, reselling: nil, status: nil, submitted_at: nil, updated_at: nil, verified_at: nil)
+      # @!method initialize(id: nil, authorizer_email: nil, authorizer_name: nil, call_reasons: nil, certify_brand_is_accurate: nil, certify_ip_ownership: nil, certify_no_shaft_content: nil, created_at: nil, delete_requested_at: nil, display_name: nil, documents: nil, enterprise_id: nil, expiring_at: nil, logo_url: nil, rejected_at: nil, rejection_reasons: nil, reselling: nil, status: nil, submitted_at: nil, updated_at: nil, verified_at: nil, webhook_url: nil)
       #   Some parameter documentations has been truncated, see {Telnyx::Models::DirAPI}
       #   for more details.
       #
@@ -144,6 +162,8 @@ module Telnyx
       #
       #   @param created_at [Time]
       #
+      #   @param delete_requested_at [Time, nil] When deletion was requested. Set once the DIR enters `delete_requested`; `null`
+      #
       #   @param display_name [String]
       #
       #   @param documents [Array<Telnyx::Models::Document>, nil]
@@ -167,6 +187,8 @@ module Telnyx
       #   @param updated_at [Time]
       #
       #   @param verified_at [Time, nil]
+      #
+      #   @param webhook_url [String, nil] `https://` URL that receives webhook notifications for this DIR's compliance-rev
 
       class CallReason < Telnyx::Internal::Type::BaseModel
         # @!attribute reason

data/lib/telnyx/models/dir_bpo_loa_params.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::Dir#bpo_loa
+    class DirBpoLoaParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      # @!attribute dir_id
+      #
+      #   @return [String]
+      required :dir_id, String
+
+      # @!attribute bpo_enterprise_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.
+      #
+      #   @return [String]
+      required :bpo_enterprise_id, String
+
+      # @!attribute signature
+      #   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.
+      #
+      #   @return [Telnyx::Models::SignaturePayload, nil]
+      optional :signature, -> { Telnyx::SignaturePayload }
+
+      # @!method initialize(dir_id:, bpo_enterprise_id:, signature: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::DirBpoLoaParams} for more details.
+      #
+      #   @param dir_id [String]
+      #
+      #   @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}]
+    end
+  end
+end

data/lib/telnyx/models/dir_delete_response.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::Dir#delete
+    class DirDeleteResponse < Telnyx::Internal::Type::BaseModel
+      # @!attribute data
+      #
+      #   @return [Telnyx::Models::DirDeleteResponse::Data]
+      required :data, -> { Telnyx::Models::DirDeleteResponse::Data }
+
+      # @!method initialize(data:)
+      #   @param data [Telnyx::Models::DirDeleteResponse::Data]
+
+      # @see Telnyx::Models::DirDeleteResponse#data
+      class Data < Telnyx::Internal::Type::BaseModel
+        # @!attribute id
+        #   Id of the DIR whose deletion was requested.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute status
+        #   Always `delete_requested`: the DIR has been queued for removal, not yet removed.
+        #
+        #   @return [Symbol, Telnyx::Models::DirDeleteResponse::Data::Status]
+        required :status, enum: -> { Telnyx::Models::DirDeleteResponse::Data::Status }
+
+        # @!method initialize(id:, status:)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::DirDeleteResponse::Data} for more details.
+        #
+        #   @param id [String] Id of the DIR whose deletion was requested.
+        #
+        #   @param status [Symbol, Telnyx::Models::DirDeleteResponse::Data::Status] Always `delete_requested`: the DIR has been queued for removal, not yet removed.
+
+        # Always `delete_requested`: the DIR has been queued for removal, not yet removed.
+        #
+        # @see Telnyx::Models::DirDeleteResponse::Data#status
+        module Status
+          extend Telnyx::Internal::Type::Enum
+
+          DELETE_REQUESTED = :delete_requested
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/dir_new_loa_params.rb

@@ -20,8 +20,9 @@ module Telnyx
       required :phone_numbers, Telnyx::Internal::Type::ArrayOf[String]
 
       # @!attribute agent
-      #   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.
       #
       #   @return [Telnyx::Models::Enterprises::Reputation::AgentInput, nil]
       optional :agent, -> { Telnyx::Enterprises::Reputation::AgentInput }
@@ -31,8 +32,8 @@ module Telnyx
       #   name, and signed-at date. When absent the PDF is returned unsigned so the
       #   customer can sign externally and upload it via the Documents API.
       #
-      #   @return [Telnyx::Models::DirNewLoaParams::Signature, nil]
-      optional :signature, -> { Telnyx::DirNewLoaParams::Signature }
+      #   @return [Telnyx::Models::SignaturePayload, nil]
+      optional :signature, -> { Telnyx::SignaturePayload }
 
       # @!method initialize(dir_id:, phone_numbers:, agent: nil, signature: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
@@ -42,38 +43,11 @@ 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}]
-
-      class Signature < Telnyx::Internal::Type::BaseModel
-        # @!attribute image_base64
-        #   PNG image, base64-encoded.
-        #
-        #   @return [String]
-        required :image_base64, String
-
-        # @!attribute signer_name
-        #   Optional. When absent the rendered PDF falls back to the enterprise contact's
-        #   legal name.
-        #
-        #   @return [String, nil]
-        optional :signer_name, String, nil?: true
-
-        # @!method initialize(image_base64:, signer_name: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {Telnyx::Models::DirNewLoaParams::Signature} for more details.
-        #
-        #   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
-        #   customer can sign externally and upload it via the Documents API.
-        #
-        #   @param image_base64 [String] PNG image, base64-encoded.
-        #
-        #   @param signer_name [String, nil] Optional. When absent the rendered PDF falls back to the enterprise contact's le
-      end
     end
   end
 end

data/lib/telnyx/models/dir_retrieve_bpo_authorizations_params.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::Dir#retrieve_bpo_authorizations
+    class DirRetrieveBpoAuthorizationsParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      # @!attribute dir_id
+      #
+      #   @return [String]
+      required :dir_id, String
+
+      # @!attribute page_number
+      #   1-based page number. Out-of-range values return an empty page with correct meta.
+      #
+      #   @return [Integer, nil]
+      optional :page_number, Integer
+
+      # @!attribute page_size
+      #   Items per page. Maximum 250; values above are clamped to 250.
+      #
+      #   @return [Integer, nil]
+      optional :page_size, Integer
+
+      # @!method initialize(dir_id:, page_number: nil, page_size: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::DirRetrieveBpoAuthorizationsParams} for more details.
+      #
+      #   @param dir_id [String]
+      #
+      #   @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}]
+    end
+  end
+end