telnyx 5.171.0 → 5.174.0

data/rbi/telnyx/models/messages/rc_send_params.rbi

@@ -68,6 +68,12 @@ module Telnyx
         sig { params(webhook_url: String).void }
         attr_writer :webhook_url
 
+        sig { returns(T.nilable(String)) }
+        attr_reader :idempotency_key
+
+        sig { params(idempotency_key: String).void }
+        attr_writer :idempotency_key
+
         sig do
           params(
             agent_id: String,
@@ -78,6 +84,7 @@ module Telnyx
             sms_fallback: Telnyx::Messages::RcSendParams::SMSFallback::OrHash,
             type: Telnyx::Messages::RcSendParams::Type::OrSymbol,
             webhook_url: String,
+            idempotency_key: String,
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
@@ -95,6 +102,7 @@ module Telnyx
           type: nil,
           # The URL where webhooks related to this message will be sent.
           webhook_url: nil,
+          idempotency_key: nil,
           request_options: {}
         )
         end
@@ -110,6 +118,7 @@ module Telnyx
               sms_fallback: Telnyx::Messages::RcSendParams::SMSFallback,
               type: Telnyx::Messages::RcSendParams::Type::OrSymbol,
               webhook_url: String,
+              idempotency_key: String,
               request_options: Telnyx::RequestOptions
             }
           )

data/rbi/telnyx/models/messaging_inbound_message_payload.rbi

@@ -459,13 +459,23 @@ module Telnyx
         sig { params(foreign_id: String).void }
         attr_writer :foreign_id
 
-        # WhatsApp sender in E.164 format.
+        # WhatsApp sender in E.164 format. Empty when the user hides their phone number;
+        # `from_user_id` then identifies the sender.
         sig { returns(T.nilable(String)) }
         attr_reader :from
 
         sig { params(from: String).void }
         attr_writer :from
 
+        # Business-scoped user ID (BSUID) of the WhatsApp sender when Meta provides one,
+        # for example `US.13491208655302741918`. When `from` is empty, pass this value as
+        # `to` to reply.
+        sig { returns(T.nilable(String)) }
+        attr_reader :from_user_id
+
+        sig { params(from_user_id: String).void }
+        attr_writer :from_user_id
+
         # Location shared in an RCS message.
         sig do
           returns(
@@ -576,6 +586,7 @@ module Telnyx
             edit: Telnyx::MessagingInboundMessagePayload::Body::Edit::OrHash,
             foreign_id: String,
             from: String,
+            from_user_id: String,
             location:
               Telnyx::MessagingInboundMessagePayload::Body::Location::OrHash,
             revoke:
@@ -600,8 +611,13 @@ module Telnyx
           edit: nil,
           # Meta WhatsApp message identifier for this webhook event.
           foreign_id: nil,
-          # WhatsApp sender in E.164 format.
+          # WhatsApp sender in E.164 format. Empty when the user hides their phone number;
+          # `from_user_id` then identifies the sender.
           from: nil,
+          # Business-scoped user ID (BSUID) of the WhatsApp sender when Meta provides one,
+          # for example `US.13491208655302741918`. When `from` is empty, pass this value as
+          # `to` to reply.
+          from_user_id: nil,
           # Location shared in an RCS message.
           location: nil,
           # Details for a revoked WhatsApp message.
@@ -627,6 +643,7 @@ module Telnyx
               edit: Telnyx::MessagingInboundMessagePayload::Body::Edit,
               foreign_id: String,
               from: String,
+              from_user_id: String,
               location: Telnyx::MessagingInboundMessagePayload::Body::Location,
               revoke: Telnyx::MessagingInboundMessagePayload::Body::Revoke,
               suggestion_response:

data/rbi/telnyx/models/messaging_messaging_profile.rbi

@@ -56,6 +56,13 @@ module Telnyx
       sig { returns(T.nilable(String)) }
       attr_accessor :health_webhook_url
 
+      # MM7 settings for inbound messages
+      sig { returns(T.nilable(Telnyx::Mm7Metadata)) }
+      attr_reader :mm7_metadata
+
+      sig { params(mm7_metadata: T.nilable(Telnyx::Mm7Metadata::OrHash)).void }
+      attr_writer :mm7_metadata
+
       # enables SMS fallback for MMS messages.
       sig { returns(T.nilable(T::Boolean)) }
       attr_reader :mms_fall_back_to_sms
@@ -249,6 +256,7 @@ module Telnyx
           enabled: T::Boolean,
           features: T.nilable(Telnyx::MessagingProfileFeatures::OrHash),
           health_webhook_url: T.nilable(String),
+          mm7_metadata: T.nilable(Telnyx::Mm7Metadata::OrHash),
           mms_fall_back_to_sms: T::Boolean,
           mms_transcoding: T::Boolean,
           mobile_only: T::Boolean,
@@ -294,6 +302,8 @@ module Telnyx
         features: nil,
         # DEPRECATED: health check url service checking
         health_webhook_url: nil,
+        # MM7 settings for inbound messages
+        mm7_metadata: nil,
         # enables SMS fallback for MMS messages.
         mms_fall_back_to_sms: nil,
         # enables automated resizing of MMS media.
@@ -368,6 +378,7 @@ module Telnyx
             enabled: T::Boolean,
             features: T.nilable(Telnyx::MessagingProfileFeatures),
             health_webhook_url: T.nilable(String),
+            mm7_metadata: T.nilable(Telnyx::Mm7Metadata),
             mms_fall_back_to_sms: T::Boolean,
             mms_transcoding: T::Boolean,
             mobile_only: T::Boolean,

data/rbi/telnyx/models/messaging_outbound_message_payload.rbi

@@ -18,7 +18,8 @@ module Telnyx
       sig { params(id: String).void }
       attr_writer :id
 
-      # RCS webhook message body. Text messages use the text property.
+      # Message body for RCS and WhatsApp. RCS text messages use the text property.
+      # WhatsApp messages contain the `whatsapp_message` object from the send request.
       sig { returns(T.nilable(Telnyx::MessagingOutboundMessagePayload::Body)) }
       attr_reader :body
 
@@ -41,6 +42,12 @@ module Telnyx
       end
       attr_writer :cc
 
+      # Identifies the next chunk when server-side SMS chunking
+      # (`auto_chunk_long_messages` on the messaging profile) split this message. Always
+      # present; null on non-chunked messages and on the final chunk.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :child_message_id
+
       # ISO 8601 formatted date indicating when the message was finalized.
       sig { returns(T.nilable(Time)) }
       attr_accessor :completed_at
@@ -153,6 +160,13 @@ module Telnyx
       sig { params(organization_id: String).void }
       attr_writer :organization_id
 
+      # Identifies the original request's message when server-side SMS chunking
+      # (`auto_chunk_long_messages` on the messaging profile) split it into chunks. The
+      # first chunk's ID is the original request's message ID. Always present; null when
+      # this message is not part of a chunked send.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :parent_message_id
+
       # Number of parts into which the message's body must be split.
       sig { returns(T.nilable(Integer)) }
       attr_reader :parts
@@ -225,6 +239,21 @@ module Telnyx
       sig { returns(T.nilable(String)) }
       attr_accessor :tcr_campaign_registered
 
+      # Telnyx ID of the WhatsApp template used by the message, when known.
+      sig { returns(T.nilable(String)) }
+      attr_reader :template_id
+
+      sig { params(template_id: String).void }
+      attr_writer :template_id
+
+      # Name of the WhatsApp template used by the message. Present for WhatsApp template
+      # messages.
+      sig { returns(T.nilable(String)) }
+      attr_reader :template_name
+
+      sig { params(template_name: String).void }
+      attr_writer :template_name
+
       # Message body (i.e., content) as a non-empty string.
       #
       # **Required for SMS**
@@ -289,6 +318,7 @@ module Telnyx
           id: String,
           body: Telnyx::MessagingOutboundMessagePayload::Body::OrHash,
           cc: T::Array[Telnyx::MessagingOutboundMessagePayload::Cc::OrHash],
+          child_message_id: T.nilable(String),
           completed_at: T.nilable(Time),
           cost:
             T.nilable(Telnyx::MessagingOutboundMessagePayload::Cost::OrHash),
@@ -306,6 +336,7 @@ module Telnyx
           messaging_profile_id: String,
           num_chars: Integer,
           organization_id: String,
+          parent_message_id: T.nilable(String),
           parts: Integer,
           received_at: Time,
           record_type:
@@ -317,6 +348,8 @@ module Telnyx
           tcr_campaign_billable: T::Boolean,
           tcr_campaign_id: T.nilable(String),
           tcr_campaign_registered: T.nilable(String),
+          template_id: String,
+          template_name: String,
           text: String,
           to: T::Array[Telnyx::MessagingOutboundMessagePayload::To::OrHash],
           type: Telnyx::MessagingOutboundMessagePayload::Type::OrSymbol,
@@ -329,9 +362,14 @@ module Telnyx
       def self.new(
         # Identifies the type of resource.
         id: nil,
-        # RCS webhook message body. Text messages use the text property.
+        # Message body for RCS and WhatsApp. RCS text messages use the text property.
+        # WhatsApp messages contain the `whatsapp_message` object from the send request.
         body: nil,
         cc: nil,
+        # Identifies the next chunk when server-side SMS chunking
+        # (`auto_chunk_long_messages` on the messaging profile) split this message. Always
+        # present; null on non-chunked messages and on the final chunk.
+        child_message_id: nil,
         # ISO 8601 formatted date indicating when the message was finalized.
         completed_at: nil,
         cost: nil,
@@ -353,6 +391,11 @@ module Telnyx
         num_chars: nil,
         # The id of the organization the messaging profile belongs to.
         organization_id: nil,
+        # Identifies the original request's message when server-side SMS chunking
+        # (`auto_chunk_long_messages` on the messaging profile) split it into chunks. The
+        # first chunk's ID is the original request's message ID. Always present; null when
+        # this message is not part of a chunked send.
+        parent_message_id: nil,
         # Number of parts into which the message's body must be split.
         parts: nil,
         # ISO 8601 formatted date indicating when the message request was received.
@@ -376,6 +419,11 @@ module Telnyx
         tcr_campaign_id: nil,
         # The registration status of the TCR campaign.
         tcr_campaign_registered: nil,
+        # Telnyx ID of the WhatsApp template used by the message, when known.
+        template_id: nil,
+        # Name of the WhatsApp template used by the message. Present for WhatsApp template
+        # messages.
+        template_name: nil,
         # Message body (i.e., content) as a non-empty string.
         #
         # **Required for SMS**
@@ -405,6 +453,7 @@ module Telnyx
             id: String,
             body: Telnyx::MessagingOutboundMessagePayload::Body,
             cc: T::Array[Telnyx::MessagingOutboundMessagePayload::Cc],
+            child_message_id: T.nilable(String),
             completed_at: T.nilable(Time),
             cost: T.nilable(Telnyx::MessagingOutboundMessagePayload::Cost),
             cost_breakdown:
@@ -418,6 +467,7 @@ module Telnyx
             messaging_profile_id: String,
             num_chars: Integer,
             organization_id: String,
+            parent_message_id: T.nilable(String),
             parts: Integer,
             received_at: Time,
             record_type:
@@ -429,6 +479,8 @@ module Telnyx
             tcr_campaign_billable: T::Boolean,
             tcr_campaign_id: T.nilable(String),
             tcr_campaign_registered: T.nilable(String),
+            template_id: String,
+            template_name: String,
             text: String,
             to: T::Array[Telnyx::MessagingOutboundMessagePayload::To],
             type: Telnyx::MessagingOutboundMessagePayload::Type::OrSymbol,
@@ -458,7 +510,8 @@ module Telnyx
         sig { params(text: String).void }
         attr_writer :text
 
-        # RCS webhook message body. Text messages use the text property.
+        # Message body for RCS and WhatsApp. RCS text messages use the text property.
+        # WhatsApp messages contain the `whatsapp_message` object from the send request.
         sig { params(text: String).returns(T.attached_class) }
         def self.new(
           # RCS text message.
@@ -1375,6 +1428,11 @@ module Telnyx
             :RCS,
             Telnyx::MessagingOutboundMessagePayload::Type::TaggedSymbol
           )
+        WHATSAPP =
+          T.let(
+            :WHATSAPP,
+            Telnyx::MessagingOutboundMessagePayload::Type::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/telnyx/models/messaging_profile_create_params.rbi

@@ -69,6 +69,13 @@ module Telnyx
       sig { returns(T.nilable(String)) }
       attr_accessor :health_webhook_url
 
+      # MM7 settings for inbound messages
+      sig { returns(T.nilable(Telnyx::Mm7Metadata)) }
+      attr_reader :mm7_metadata
+
+      sig { params(mm7_metadata: T.nilable(Telnyx::Mm7Metadata::OrHash)).void }
+      attr_writer :mm7_metadata
+
       # enables SMS fallback for MMS messages.
       sig { returns(T.nilable(T::Boolean)) }
       attr_reader :mms_fall_back_to_sms
@@ -175,6 +182,7 @@ module Telnyx
           enabled: T::Boolean,
           features: T.nilable(Telnyx::MessagingProfileFeatures::OrHash),
           health_webhook_url: T.nilable(String),
+          mm7_metadata: T.nilable(Telnyx::Mm7Metadata::OrHash),
           mms_fall_back_to_sms: T::Boolean,
           mms_transcoding: T::Boolean,
           mobile_only: T::Boolean,
@@ -215,6 +223,8 @@ module Telnyx
         features: nil,
         # A URL to receive health check webhooks for numbers in this profile.
         health_webhook_url: nil,
+        # MM7 settings for inbound messages
+        mm7_metadata: nil,
         # enables SMS fallback for MMS messages.
         mms_fall_back_to_sms: nil,
         # enables automated resizing of MMS media.
@@ -265,6 +275,7 @@ module Telnyx
             enabled: T::Boolean,
             features: T.nilable(Telnyx::MessagingProfileFeatures),
             health_webhook_url: T.nilable(String),
+            mm7_metadata: T.nilable(Telnyx::Mm7Metadata),
             mms_fall_back_to_sms: T::Boolean,
             mms_transcoding: T::Boolean,
             mobile_only: T::Boolean,

data/rbi/telnyx/models/messaging_profile_features.rbi

@@ -18,24 +18,55 @@ module Telnyx
       sig { params(ai_opt_out_detection_enabled: T::Boolean).void }
       attr_writer :ai_opt_out_detection_enabled
 
+      # Enables server-side chunking of outbound SMS. When enabled, an outbound message
+      # that exceeds the maximum number of segments allowed for its destination (10
+      # segments by default; some aggregators accept up to 25) is automatically split
+      # into multiple child messages, each within the segment limit, and sent
+      # sequentially in order. Splitting is encoding-aware: GSM-7 bodies split at
+      # 153-character boundaries and UCS-2 bodies at 134-byte (67-character) boundaries.
+      # When disabled (the default), messages exceeding the segment limit are rejected
+      # with an error.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :auto_chunk_long_messages
+
+      sig { params(auto_chunk_long_messages: T::Boolean).void }
+      attr_writer :auto_chunk_long_messages
+
       # Telnyx product features the messaging customer can enable on the messaging
       # profile. Keys map to individual feature flags; unknown keys are accepted and
       # preserved for forward compatibility with rolling deployments.
       sig do
-        params(ai_opt_out_detection_enabled: T::Boolean).returns(
-          T.attached_class
-        )
+        params(
+          ai_opt_out_detection_enabled: T::Boolean,
+          auto_chunk_long_messages: T::Boolean
+        ).returns(T.attached_class)
       end
       def self.new(
         # Enables AI detection of inbound opt-out messages that do not follow the standard
         # STOP/UNSTOP/HELP opt-out keyword pattern. When enabled, the messaging platform
         # applies an AI model to identify non-standard opt-out requests (e.g.
         # natural-language phrases) and treats them as opt-outs.
-        ai_opt_out_detection_enabled: nil
+        ai_opt_out_detection_enabled: nil,
+        # Enables server-side chunking of outbound SMS. When enabled, an outbound message
+        # that exceeds the maximum number of segments allowed for its destination (10
+        # segments by default; some aggregators accept up to 25) is automatically split
+        # into multiple child messages, each within the segment limit, and sent
+        # sequentially in order. Splitting is encoding-aware: GSM-7 bodies split at
+        # 153-character boundaries and UCS-2 bodies at 134-byte (67-character) boundaries.
+        # When disabled (the default), messages exceeding the segment limit are rejected
+        # with an error.
+        auto_chunk_long_messages: nil
       )
       end
 
-      sig { override.returns({ ai_opt_out_detection_enabled: T::Boolean }) }
+      sig do
+        override.returns(
+          {
+            ai_opt_out_detection_enabled: T::Boolean,
+            auto_chunk_long_messages: T::Boolean
+          }
+        )
+      end
       def to_hash
       end
     end

data/rbi/telnyx/models/messaging_profile_update_params.rbi

@@ -58,6 +58,13 @@ module Telnyx
       end
       attr_writer :features
 
+      # MM7 settings for inbound messages
+      sig { returns(T.nilable(Telnyx::Mm7Metadata)) }
+      attr_reader :mm7_metadata
+
+      sig { params(mm7_metadata: T.nilable(Telnyx::Mm7Metadata::OrHash)).void }
+      attr_writer :mm7_metadata
+
       # enables SMS fallback for MMS messages.
       sig { returns(T.nilable(T::Boolean)) }
       attr_reader :mms_fall_back_to_sms
@@ -202,6 +209,7 @@ module Telnyx
           daily_spend_limit_enabled: T::Boolean,
           enabled: T::Boolean,
           features: T.nilable(Telnyx::MessagingProfileFeatures::OrHash),
+          mm7_metadata: T.nilable(Telnyx::Mm7Metadata::OrHash),
           mms_fall_back_to_sms: T::Boolean,
           mms_transcoding: T::Boolean,
           mobile_only: T::Boolean,
@@ -239,6 +247,8 @@ module Telnyx
         # profile. Keys map to individual feature flags; unknown keys are accepted and
         # preserved for forward compatibility with rolling deployments.
         features: nil,
+        # MM7 settings for inbound messages
+        mm7_metadata: nil,
         # enables SMS fallback for MMS messages.
         mms_fall_back_to_sms: nil,
         # enables automated resizing of MMS media.
@@ -304,6 +314,7 @@ module Telnyx
             daily_spend_limit_enabled: T::Boolean,
             enabled: T::Boolean,
             features: T.nilable(Telnyx::MessagingProfileFeatures),
+            mm7_metadata: T.nilable(Telnyx::Mm7Metadata),
             mms_fall_back_to_sms: T::Boolean,
             mms_transcoding: T::Boolean,
             mobile_only: T::Boolean,

data/rbi/telnyx/models/mm7_metadata.rbi

@@ -0,0 +1,47 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    class Mm7Metadata < Telnyx::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias { T.any(Telnyx::Mm7Metadata, Telnyx::Internal::AnyHash) }
+
+      # Failover webhook URL to receive inbound MM7 traffic
+      sig { returns(T.nilable(String)) }
+      attr_reader :mm7_failover_webhook_url
+
+      sig { params(mm7_failover_webhook_url: String).void }
+      attr_writer :mm7_failover_webhook_url
+
+      # Webhook URL to receive inbound MM7 traffic
+      sig { returns(T.nilable(String)) }
+      attr_reader :mm7_webhook_url
+
+      sig { params(mm7_webhook_url: String).void }
+      attr_writer :mm7_webhook_url
+
+      # MM7 settings for inbound messages
+      sig do
+        params(
+          mm7_failover_webhook_url: String,
+          mm7_webhook_url: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Failover webhook URL to receive inbound MM7 traffic
+        mm7_failover_webhook_url: nil,
+        # Webhook URL to receive inbound MM7 traffic
+        mm7_webhook_url: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          { mm7_failover_webhook_url: String, mm7_webhook_url: String }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/telnyx/models/model_metadata.rbi

@@ -55,6 +55,14 @@ module Telnyx
       sig { returns(T.nilable(String)) }
       attr_accessor :base_model
 
+      # Whether the model is in beta. New Telnyx-hosted models launch with `beta: true`;
+      # the label is removed once the model is established.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :beta
+
+      sig { params(beta: T::Boolean).void }
+      attr_writer :beta
+
       # Short, human-readable summary of what the model is best suited for.
       sig { returns(T.nilable(String)) }
       attr_accessor :description
@@ -166,6 +174,7 @@ module Telnyx
           parameters: Integer,
           tier: Telnyx::ModelMetadata::Tier::OrSymbol,
           base_model: T.nilable(String),
+          beta: T::Boolean,
           description: T.nilable(String),
           is_fine_tunable: T::Boolean,
           is_vision_supported: T::Boolean,
@@ -209,6 +218,9 @@ module Telnyx
         # Base model the fine-tuned model was trained from. Only set for fine-tuned
         # models.
         base_model: nil,
+        # Whether the model is in beta. New Telnyx-hosted models launch with `beta: true`;
+        # the label is removed once the model is established.
+        beta: nil,
         # Short, human-readable summary of what the model is best suited for.
         description: nil,
         # Whether the model can be used as a base for a fine-tuning job via
@@ -265,6 +277,7 @@ module Telnyx
             parameters: Integer,
             tier: Telnyx::ModelMetadata::Tier::TaggedSymbol,
             base_model: T.nilable(String),
+            beta: T::Boolean,
             description: T.nilable(String),
             is_fine_tunable: T::Boolean,
             is_vision_supported: T::Boolean,

data/rbi/telnyx/models/netapps_cursor_pagination_meta.rbi

@@ -0,0 +1,106 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    class NetappsCursorPaginationMeta < Telnyx::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Telnyx::NetappsCursorPaginationMeta, Telnyx::Internal::AnyHash)
+        end
+
+      # Opaque cursors. Absent keys mean there is no such page.
+      sig { returns(T.nilable(Telnyx::NetappsCursorPaginationMeta::Cursors)) }
+      attr_reader :cursors
+
+      sig do
+        params(
+          cursors: Telnyx::NetappsCursorPaginationMeta::Cursors::OrHash
+        ).void
+      end
+      attr_writer :cursors
+
+      # The path of the next page, with the same query parameters. Absent on the last
+      # page.
+      sig { returns(T.nilable(String)) }
+      attr_reader :next_
+
+      sig { params(next_: String).void }
+      attr_writer :next_
+
+      # The path of the previous page. Present when the request used `page[after]`.
+      sig { returns(T.nilable(String)) }
+      attr_reader :previous
+
+      sig { params(previous: String).void }
+      attr_writer :previous
+
+      sig do
+        params(
+          cursors: Telnyx::NetappsCursorPaginationMeta::Cursors::OrHash,
+          next_: String,
+          previous: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Opaque cursors. Absent keys mean there is no such page.
+        cursors: nil,
+        # The path of the next page, with the same query parameters. Absent on the last
+        # page.
+        next_: nil,
+        # The path of the previous page. Present when the request used `page[after]`.
+        previous: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            cursors: Telnyx::NetappsCursorPaginationMeta::Cursors,
+            next_: String,
+            previous: String
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Cursors < Telnyx::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Telnyx::NetappsCursorPaginationMeta::Cursors,
+              Telnyx::Internal::AnyHash
+            )
+          end
+
+        # Pass as `page[after]` to fetch the next page. Absent on the last page.
+        sig { returns(T.nilable(String)) }
+        attr_reader :after
+
+        sig { params(after: String).void }
+        attr_writer :after
+
+        # The cursor of the previous page. Present when the request used `page[after]`.
+        sig { returns(T.nilable(String)) }
+        attr_reader :before
+
+        sig { params(before: String).void }
+        attr_writer :before
+
+        # Opaque cursors. Absent keys mean there is no such page.
+        sig { params(after: String, before: String).returns(T.attached_class) }
+        def self.new(
+          # Pass as `page[after]` to fetch the next page. Absent on the last page.
+          after: nil,
+          # The cursor of the previous page. Present when the request used `page[after]`.
+          before: nil
+        )
+        end
+
+        sig { override.returns({ after: String, before: String }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end