sentdm 0.38.1 → 0.39.0

data/lib/sentdm/resources/voice/tokens.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Resources
+    class Voice
+      # Phone calls from the numbers you hold, driven by your own callback URL.
+      #
+      # `POST /v3/channels/voice` enables a number for calls, with the callback URL Sent
+      # asks what to do with each call on it, and `POST /v3/voice/tokens` mints a
+      # short-lived token that lets a user of your app place and receive calls as that
+      # number. When a call arrives or a caller presses a key, a signed question is
+      # POSTed to the callback URL and the answer decides the call;
+      # `POST /v3/channels/voice/{number}/test` checks the URL answers the way we need
+      # before a real call reaches it, and
+      # `POST /v3/channels/voice/{number}/rotate-secret` replaces the signing secret.
+      # The call events themselves (`call.completed` and the rest) arrive through your
+      # webhooks.
+      #
+      # Every call is a record under `/v3/voice/calls`: read it, list its recordings
+      # once one is ready, hang it up, start or stop recording, and add, mute or remove
+      # conference participants while it is live. A leg to a phone number runs for at
+      # most what your balance affords at the destination's rate.
+      class Tokens
+        # Some parameter documentations has been truncated, see
+        # {Sentdm::Models::Voice::TokenCreateParams} for more details.
+        #
+        # Mints a short-lived token for one of your app users. Call this from your backend
+        # and return the token to your app, which passes it to the voice client SDK to
+        # register. The identity is bound to the given number, or to your default app-call
+        # number when omitted, and calls placed by that identity are routed through the
+        # bound number. Minting again re-binds the identity, so an identity can move
+        # between numbers.
+        #
+        # @overload create(identity: nil, number: nil, sandbox: nil, ttl: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
+        #
+        # @param identity [String] Body param: Your identifier for the app user, such as an agent or account id. Le
+        #
+        # @param number [String, nil] Body param: One of your voice-enabled phone numbers in E.164 format. Calls place
+        #
+        # @param sandbox [Boolean] Body param: Sandbox flag - when true, the operation is simulated without side ef
+        #
+        # @param ttl [Integer, nil] Body param: Token lifetime in seconds. Defaults to 600 and cannot exceed 3600.
+        #
+        # @param idempotency_key [String] Header param: Unique key to ensure idempotent request processing. Must be 1-255
+        #
+        # @param x_profile_id [String] Header param: Profile UUID to scope the request to a child profile. Only organiz
+        #
+        # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Sentdm::Models::Voice::APIResponseOfVoiceToken]
+        #
+        # @see Sentdm::Models::Voice::TokenCreateParams
+        def create(params = {})
+          parsed, options = Sentdm::Voice::TokenCreateParams.dump_request(params)
+          header_params = {idempotency_key: "idempotency-key", x_profile_id: "x-profile-id"}
+          @client.request(
+            method: :post,
+            path: "v3/voice/tokens",
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
+            model: Sentdm::Voice::APIResponseOfVoiceToken,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Sentdm::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/sentdm/resources/voice.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Resources
+    class Voice
+      # Phone calls from the numbers you hold, driven by your own callback URL.
+      #
+      # `POST /v3/channels/voice` enables a number for calls, with the callback URL Sent
+      # asks what to do with each call on it, and `POST /v3/voice/tokens` mints a
+      # short-lived token that lets a user of your app place and receive calls as that
+      # number. When a call arrives or a caller presses a key, a signed question is
+      # POSTed to the callback URL and the answer decides the call;
+      # `POST /v3/channels/voice/{number}/test` checks the URL answers the way we need
+      # before a real call reaches it, and
+      # `POST /v3/channels/voice/{number}/rotate-secret` replaces the signing secret.
+      # The call events themselves (`call.completed` and the rest) arrive through your
+      # webhooks.
+      #
+      # Every call is a record under `/v3/voice/calls`: read it, list its recordings
+      # once one is ready, hang it up, start or stop recording, and add, mute or remove
+      # conference participants while it is live. A leg to a phone number runs for at
+      # most what your balance affords at the destination's rate.
+      # @return [Sentdm::Resources::Voice::Calls]
+      attr_reader :calls
+
+      # Phone calls from the numbers you hold, driven by your own callback URL.
+      #
+      # `POST /v3/channels/voice` enables a number for calls, with the callback URL Sent
+      # asks what to do with each call on it, and `POST /v3/voice/tokens` mints a
+      # short-lived token that lets a user of your app place and receive calls as that
+      # number. When a call arrives or a caller presses a key, a signed question is
+      # POSTed to the callback URL and the answer decides the call;
+      # `POST /v3/channels/voice/{number}/test` checks the URL answers the way we need
+      # before a real call reaches it, and
+      # `POST /v3/channels/voice/{number}/rotate-secret` replaces the signing secret.
+      # The call events themselves (`call.completed` and the rest) arrive through your
+      # webhooks.
+      #
+      # Every call is a record under `/v3/voice/calls`: read it, list its recordings
+      # once one is ready, hang it up, start or stop recording, and add, mute or remove
+      # conference participants while it is live. A leg to a phone number runs for at
+      # most what your balance affords at the destination's rate.
+      # @return [Sentdm::Resources::Voice::Tokens]
+      attr_reader :tokens
+
+      # @api private
+      #
+      # @param client [Sentdm::Client]
+      def initialize(client:)
+        @client = client
+        @calls = Sentdm::Resources::Voice::Calls.new(client: client)
+        @tokens = Sentdm::Resources::Voice::Tokens.new(client: client)
+      end
+    end
+  end
+end

data/lib/sentdm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Sentdm
-  VERSION = "0.38.1"
+  VERSION = "0.39.0"
 end

data/lib/sentdm.rb

@@ -58,13 +58,10 @@ require_relative "sentdm/internal/conversations_page"
 require_relative "sentdm/internal/templates_page"
 require_relative "sentdm/internal/webhook_events_page"
 require_relative "sentdm/internal/webhooks_page"
-require_relative "sentdm/models/mutation_request"
 require_relative "sentdm/models/channels/voice_number"
+require_relative "sentdm/models/mutation_request"
 require_relative "sentdm/models/template_body_content"
 require_relative "sentdm/models/api_meta"
-require_relative "sentdm/models/api_response_of_call"
-require_relative "sentdm/models/api_response_of_call_recordings"
-require_relative "sentdm/models/api_response_of_calls_list"
 require_relative "sentdm/models/api_response_of_contact"
 require_relative "sentdm/models/api_response_of_contact_message_summary"
 require_relative "sentdm/models/api_response_of_conversation_messages_list"
@@ -78,27 +75,8 @@ require_relative "sentdm/models/brand_business_info"
 require_relative "sentdm/models/brand_compliance_info"
 require_relative "sentdm/models/brand_contact_info"
 require_relative "sentdm/models/brands_brand_data"
-require_relative "sentdm/models/call"
 require_relative "sentdm/models/call_event"
 require_relative "sentdm/models/call_event_payload"
-require_relative "sentdm/models/call_hangup_params"
-require_relative "sentdm/models/call_list_params"
-require_relative "sentdm/models/call_list_recordings_params"
-require_relative "sentdm/models/call_party"
-require_relative "sentdm/models/call_recording"
-require_relative "sentdm/models/call_recordings"
-require_relative "sentdm/models/call_record_params"
-require_relative "sentdm/models/call_retrieve_params"
-require_relative "sentdm/models/calls/api_response_of_list_of_call_participant"
-require_relative "sentdm/models/calls/call_participant"
-require_relative "sentdm/models/calls/call_participant_target"
-require_relative "sentdm/models/calls/participant_add_params"
-require_relative "sentdm/models/calls/participant_list_params"
-require_relative "sentdm/models/calls/participant_remove_all_params"
-require_relative "sentdm/models/calls/participant_remove_params"
-require_relative "sentdm/models/calls/participant_update_params"
-require_relative "sentdm/models/calls_list"
-require_relative "sentdm/models/call_timeline_entry"
 require_relative "sentdm/models/channel_event"
 require_relative "sentdm/models/channel_event_payload"
 require_relative "sentdm/models/channels/api_response_of_list_of_voice_number"
@@ -106,20 +84,17 @@ require_relative "sentdm/models/channels/api_response_of_voice_callback_test"
 require_relative "sentdm/models/channels/api_response_of_voice_number"
 require_relative "sentdm/models/channels/api_response_of_voice_number_created"
 require_relative "sentdm/models/channels/api_response_of_voice_secret"
-require_relative "sentdm/models/channels/api_response_of_voice_token"
 require_relative "sentdm/models/channels/voice_callback_test"
 require_relative "sentdm/models/channels/voice_callback_test_error_info"
 require_relative "sentdm/models/channels/voice_callback_test_request_info"
 require_relative "sentdm/models/channels/voice_callback_test_response_info"
 require_relative "sentdm/models/channels/voice_create_params"
-require_relative "sentdm/models/channels/voice_create_token_params"
 require_relative "sentdm/models/channels/voice_list_params"
 require_relative "sentdm/models/channels/voice_number_created"
 require_relative "sentdm/models/channels/voice_retrieve_params"
 require_relative "sentdm/models/channels/voice_rotate_secret_params"
 require_relative "sentdm/models/channels/voice_secret"
 require_relative "sentdm/models/channels/voice_test_params"
-require_relative "sentdm/models/channels/voice_token"
 require_relative "sentdm/models/channels/voice_update_params"
 require_relative "sentdm/models/contact_create_params"
 require_relative "sentdm/models/contact_delete_params"
@@ -197,6 +172,31 @@ require_relative "sentdm/models/user_remove_params"
 require_relative "sentdm/models/user_response"
 require_relative "sentdm/models/user_retrieve_params"
 require_relative "sentdm/models/user_update_role_params"
+require_relative "sentdm/models/voice/api_response_of_call"
+require_relative "sentdm/models/voice/api_response_of_call_recordings"
+require_relative "sentdm/models/voice/api_response_of_calls_list"
+require_relative "sentdm/models/voice/api_response_of_voice_token"
+require_relative "sentdm/models/voice/call"
+require_relative "sentdm/models/voice/call_hangup_params"
+require_relative "sentdm/models/voice/call_list_params"
+require_relative "sentdm/models/voice/call_list_recordings_params"
+require_relative "sentdm/models/voice/call_party"
+require_relative "sentdm/models/voice/call_recording"
+require_relative "sentdm/models/voice/call_recordings"
+require_relative "sentdm/models/voice/call_record_params"
+require_relative "sentdm/models/voice/call_retrieve_params"
+require_relative "sentdm/models/voice/calls/api_response_of_list_of_call_participant"
+require_relative "sentdm/models/voice/calls/call_participant"
+require_relative "sentdm/models/voice/calls/call_participant_target"
+require_relative "sentdm/models/voice/calls/participant_add_params"
+require_relative "sentdm/models/voice/calls/participant_list_params"
+require_relative "sentdm/models/voice/calls/participant_remove_all_params"
+require_relative "sentdm/models/voice/calls/participant_remove_params"
+require_relative "sentdm/models/voice/calls/participant_update_params"
+require_relative "sentdm/models/voice/calls_list"
+require_relative "sentdm/models/voice/call_timeline_entry"
+require_relative "sentdm/models/voice/token_create_params"
+require_relative "sentdm/models/voice/voice_token"
 require_relative "sentdm/models/webhook_create_params"
 require_relative "sentdm/models/webhook_delete_params"
 require_relative "sentdm/models/webhook_event_type"
@@ -214,8 +214,6 @@ require_relative "sentdm/models/webhook_test_response"
 require_relative "sentdm/models/webhook_toggle_status_params"
 require_relative "sentdm/models/webhook_update_params"
 require_relative "sentdm/models"
-require_relative "sentdm/resources/calls"
-require_relative "sentdm/resources/calls/participants"
 require_relative "sentdm/resources/channels"
 require_relative "sentdm/resources/channels/voice"
 require_relative "sentdm/resources/contacts"
@@ -227,4 +225,8 @@ require_relative "sentdm/resources/profiles"
 require_relative "sentdm/resources/profiles/campaigns"
 require_relative "sentdm/resources/templates"
 require_relative "sentdm/resources/users"
+require_relative "sentdm/resources/voice"
+require_relative "sentdm/resources/voice/calls"
+require_relative "sentdm/resources/voice/calls/participants"
+require_relative "sentdm/resources/voice/tokens"
 require_relative "sentdm/resources/webhooks"

data/rbi/sentdm/client.rbi

@@ -115,25 +115,8 @@ module Sentdm
     sig { returns(Sentdm::Resources::Conversations) }
     attr_reader :conversations
 
-    # Phone calls from the numbers you hold, driven by your own callback URL.
-    #
-    # `POST /v3/channels/voice` enables a number for calls, with the callback URL Sent
-    # asks what to do with each call on it, and `POST /v3/channels/voice/tokens` mints
-    # a short-lived token that lets a user of your app place and receive calls as that
-    # number. When a call arrives or a caller presses a key, a signed question is
-    # POSTed to the callback URL and the answer decides the call;
-    # `POST /v3/channels/voice/{number}/test` checks the URL answers the way we need
-    # before a real call reaches it, and
-    # `POST /v3/channels/voice/{number}/rotate-secret` replaces the signing secret.
-    # The call events themselves (`call.completed` and the rest) arrive through your
-    # webhooks.
-    #
-    # Every call is a record under `/v3/calls`: read it, list its recordings once one
-    # is ready, hang it up, start or stop recording, and add, mute or remove
-    # conference participants while it is live. A leg to a phone number runs for at
-    # most what your balance affords at the destination's rate.
-    sig { returns(Sentdm::Resources::Calls) }
-    attr_reader :calls
+    sig { returns(Sentdm::Resources::Voice) }
+    attr_reader :voice
 
     sig { returns(Sentdm::Resources::Channels) }
     attr_reader :channels

data/rbi/sentdm/models/call_event_payload.rbi

@@ -48,8 +48,9 @@ module Sentdm
       sig { returns(T.nilable(String)) }
       attr_accessor :reason
 
-      # The recording that became available, the same id GET /v3/calls/{id}/recordings
-      # lists it under. Only on call.recording_ready, which is sent once per recording.
+      # The recording that became available, the same id GET
+      # /v3/voice/calls/{id}/recordings lists it under. Only on call.recording_ready,
+      # which is sent once per recording.
       sig { returns(T.nilable(String)) }
       attr_accessor :recording_id
 
@@ -105,8 +106,9 @@ module Sentdm
         # The machine-readable reason the call did not complete. Only on call.failed, and
         # omitted when no reason was recorded.
         reason: nil,
-        # The recording that became available, the same id GET /v3/calls/{id}/recordings
-        # lists it under. Only on call.recording_ready, which is sent once per recording.
+        # The recording that became available, the same id GET
+        # /v3/voice/calls/{id}/recordings lists it under. Only on call.recording_ready,
+        # which is sent once per recording.
         recording_id: nil,
         # When the change happened on the call, as opposed to when the event was emitted.
         updated_at: nil

data/rbi/sentdm/models/message_send_params.rbi

@@ -31,6 +31,11 @@ module Sentdm
       # itself is unchanged: the same rules are scored and ranked the same way, with
       # routes pinned to numbers you did not list removed from the running.
       #
+      # Each channel's list is independent: an sms list does not restrict MMS. To choose
+      # the numbers a message may go out from as MMS, name them under mms. MMS sends
+      # from your SMS numbers, so an mms list may name any of your active SMS numbers
+      # whose market carries MMS — the ones listed under mms in your channels.
+      #
       # Every number must be an active sender on your account. The request itself is
       # still accepted (202) if one is not — like every other send-time rule, that is
       # decided per message, so each affected message is recorded BLOCKED with error
@@ -53,7 +58,9 @@ module Sentdm
       #
       # Their presence is also what makes a message eligible for MMS on an auto-detect
       # send: a message with nothing attached is delivered as SMS, because an MMS with
-      # no media is a more expensive text message.
+      # no media is a more expensive text message. For the same reason a send that names
+      # mms in channel with nothing attached, here or on the template, is refused with
+      # a 400.
       #
       # The recipient's carrier fetches each URL after the send is accepted, so it must
       # stay publicly reachable — a link that expires, or one behind auth, arrives as a
@@ -164,6 +171,11 @@ module Sentdm
         # itself is unchanged: the same rules are scored and ranked the same way, with
         # routes pinned to numbers you did not list removed from the running.
         #
+        # Each channel's list is independent: an sms list does not restrict MMS. To choose
+        # the numbers a message may go out from as MMS, name them under mms. MMS sends
+        # from your SMS numbers, so an mms list may name any of your active SMS numbers
+        # whose market carries MMS — the ones listed under mms in your channels.
+        #
         # Every number must be an active sender on your account. The request itself is
         # still accepted (202) if one is not — like every other send-time rule, that is
         # decided per message, so each affected message is recorded BLOCKED with error
@@ -178,7 +190,9 @@ module Sentdm
         #
         # Their presence is also what makes a message eligible for MMS on an auto-detect
         # send: a message with nothing attached is delivered as SMS, because an MMS with
-        # no media is a more expensive text message.
+        # no media is a more expensive text message. For the same reason a send that names
+        # mms in channel with nothing attached, here or on the template, is refused with
+        # a 400.
         #
         # The recipient's carrier fetches each URL after the send is accepted, so it must
         # stay publicly reachable — a link that expires, or one behind auth, arrives as a

data/rbi/sentdm/models/template.rbi

@@ -41,17 +41,18 @@ module Sentdm
       attr_writer :category
 
       # The channels this template's definition can render on, in canonical order: sms,
-      # whatsapp, rcs.
+      # whatsapp, rcs, mms.
       #
       # Derived from the definition's body, mirroring each channel's send-time fallback
       # chain, so a channel is listed only when a real body would be produced for it:
       # SMS reads sms ?? multiChannel, WhatsApp reads whatsapp ?? multiChannel, and RCS
-      # reads rcs ?? multiChannel ?? sms. A multiChannel body therefore reports all
-      # three, and the extra SMS fallback on RCS is why an sms/whatsapp pair reports RCS
-      # too.
+      # and MMS read rcs ?? multiChannel ?? sms and mms ?? multiChannel ?? sms. A
+      # multiChannel body therefore reports all four, and the extra SMS fallback is why
+      # an sms/whatsapp pair reports RCS and MMS too.
       #
       # This says what the content can render on, not what may be sent: sending also
-      # needs the template approved for that channel.
+      # needs the template approved for that channel, and MMS needs an attachment, from
+      # media_urls or the template's mms body.
       sig { returns(T.nilable(T::Array[String])) }
       attr_accessor :channels
 
@@ -138,17 +139,18 @@ module Sentdm
         # Template category: MARKETING, UTILITY, AUTHENTICATION
         category: nil,
         # The channels this template's definition can render on, in canonical order: sms,
-        # whatsapp, rcs.
+        # whatsapp, rcs, mms.
         #
         # Derived from the definition's body, mirroring each channel's send-time fallback
         # chain, so a channel is listed only when a real body would be produced for it:
         # SMS reads sms ?? multiChannel, WhatsApp reads whatsapp ?? multiChannel, and RCS
-        # reads rcs ?? multiChannel ?? sms. A multiChannel body therefore reports all
-        # three, and the extra SMS fallback on RCS is why an sms/whatsapp pair reports RCS
-        # too.
+        # and MMS read rcs ?? multiChannel ?? sms and mms ?? multiChannel ?? sms. A
+        # multiChannel body therefore reports all four, and the extra SMS fallback is why
+        # an sms/whatsapp pair reports RCS and MMS too.
         #
         # This says what the content can render on, not what may be sent: sending also
-        # needs the template approved for that channel.
+        # needs the template approved for that channel, and MMS needs an attachment, from
+        # media_urls or the template's mms body.
         channels: nil,
         # When the template was created
         created_at: nil,

data/rbi/sentdm/models/template_body.rbi

@@ -9,10 +9,10 @@ module Sentdm
       # MMS-specific content — subject, text and attachments.
       #
       # Like Rcs, an override that cannot stand on its own: a template still needs a
-      # MultiChannel body or the Sms + Whatsapp pair to be deliverable at all. Unlike
-      # Rcs, it has no fallback at send time — MMS with no media is a more expensive
-      # SMS, so a template without this slot is deliberately not MMS-capable and never
-      # produces an MMS route candidate.
+      # MultiChannel body or the Sms + Whatsapp pair to be deliverable at all. Without
+      # this slot MMS renders the shared or SMS body, so it is only needed for
+      # MMS-specific copy, a subject or attachments. When present it replaces that body
+      # on MMS rather than adding to it.
       sig { returns(T.nilable(Sentdm::TemplateBody::Mms)) }
       attr_reader :mms
 
@@ -78,10 +78,10 @@ module Sentdm
         # MMS-specific content — subject, text and attachments.
         #
         # Like Rcs, an override that cannot stand on its own: a template still needs a
-        # MultiChannel body or the Sms + Whatsapp pair to be deliverable at all. Unlike
-        # Rcs, it has no fallback at send time — MMS with no media is a more expensive
-        # SMS, so a template without this slot is deliberately not MMS-capable and never
-        # produces an MMS route candidate.
+        # MultiChannel body or the Sms + Whatsapp pair to be deliverable at all. Without
+        # this slot MMS renders the shared or SMS body, so it is only needed for
+        # MMS-specific copy, a subject or attachments. When present it replaces that body
+        # on MMS rather than adding to it.
         mms: nil,
         # The shared body, used for every channel. One half of the choice described above.
         multi_channel: nil,
@@ -134,10 +134,10 @@ module Sentdm
         # MMS-specific content — subject, text and attachments.
         #
         # Like Rcs, an override that cannot stand on its own: a template still needs a
-        # MultiChannel body or the Sms + Whatsapp pair to be deliverable at all. Unlike
-        # Rcs, it has no fallback at send time — MMS with no media is a more expensive
-        # SMS, so a template without this slot is deliberately not MMS-capable and never
-        # produces an MMS route candidate.
+        # MultiChannel body or the Sms + Whatsapp pair to be deliverable at all. Without
+        # this slot MMS renders the shared or SMS body, so it is only needed for
+        # MMS-specific copy, a subject or attachments. When present it replaces that body
+        # on MMS rather than adding to it.
         sig do
           params(
             media:

data/rbi/sentdm/models/voice/api_response_of_call.rbi

@@ -0,0 +1,76 @@
+# typed: strong
+
+module Sentdm
+  module Models
+    module Voice
+      class APIResponseOfCall < Sentdm::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Sentdm::Voice::APIResponseOfCall, Sentdm::Internal::AnyHash)
+          end
+
+        # A call record
+        sig { returns(T.nilable(Sentdm::Voice::Call)) }
+        attr_reader :data
+
+        sig { params(data: T.nilable(Sentdm::Voice::Call::OrHash)).void }
+        attr_writer :data
+
+        # Error information
+        sig { returns(T.nilable(Sentdm::ErrorDetail)) }
+        attr_reader :error
+
+        sig { params(error: T.nilable(Sentdm::ErrorDetail::OrHash)).void }
+        attr_writer :error
+
+        # Request and response metadata
+        sig { returns(T.nilable(Sentdm::APIMeta)) }
+        attr_reader :meta
+
+        sig { params(meta: Sentdm::APIMeta::OrHash).void }
+        attr_writer :meta
+
+        # Indicates whether the request was successful
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :success
+
+        sig { params(success: T::Boolean).void }
+        attr_writer :success
+
+        # Standard API response envelope for all v3 endpoints
+        sig do
+          params(
+            data: T.nilable(Sentdm::Voice::Call::OrHash),
+            error: T.nilable(Sentdm::ErrorDetail::OrHash),
+            meta: Sentdm::APIMeta::OrHash,
+            success: T::Boolean
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # A call record
+          data: nil,
+          # Error information
+          error: nil,
+          # Request and response metadata
+          meta: nil,
+          # Indicates whether the request was successful
+          success: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              data: T.nilable(Sentdm::Voice::Call),
+              error: T.nilable(Sentdm::ErrorDetail),
+              meta: Sentdm::APIMeta,
+              success: T::Boolean
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/sentdm/models/voice/api_response_of_call_recordings.rbi

@@ -0,0 +1,81 @@
+# typed: strong
+
+module Sentdm
+  module Models
+    module Voice
+      class APIResponseOfCallRecordings < Sentdm::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Sentdm::Voice::APIResponseOfCallRecordings,
+              Sentdm::Internal::AnyHash
+            )
+          end
+
+        # The recordings of a call, each as a short-lived download link
+        sig { returns(T.nilable(Sentdm::Voice::CallRecordings)) }
+        attr_reader :data
+
+        sig do
+          params(data: T.nilable(Sentdm::Voice::CallRecordings::OrHash)).void
+        end
+        attr_writer :data
+
+        # Error information
+        sig { returns(T.nilable(Sentdm::ErrorDetail)) }
+        attr_reader :error
+
+        sig { params(error: T.nilable(Sentdm::ErrorDetail::OrHash)).void }
+        attr_writer :error
+
+        # Request and response metadata
+        sig { returns(T.nilable(Sentdm::APIMeta)) }
+        attr_reader :meta
+
+        sig { params(meta: Sentdm::APIMeta::OrHash).void }
+        attr_writer :meta
+
+        # Indicates whether the request was successful
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :success
+
+        sig { params(success: T::Boolean).void }
+        attr_writer :success
+
+        # Standard API response envelope for all v3 endpoints
+        sig do
+          params(
+            data: T.nilable(Sentdm::Voice::CallRecordings::OrHash),
+            error: T.nilable(Sentdm::ErrorDetail::OrHash),
+            meta: Sentdm::APIMeta::OrHash,
+            success: T::Boolean
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The recordings of a call, each as a short-lived download link
+          data: nil,
+          # Error information
+          error: nil,
+          # Request and response metadata
+          meta: nil,
+          # Indicates whether the request was successful
+          success: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              data: T.nilable(Sentdm::Voice::CallRecordings),
+              error: T.nilable(Sentdm::ErrorDetail),
+              meta: Sentdm::APIMeta,
+              success: T::Boolean
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end