surge_api 0.17.0 → 0.19.0

data/rbi/surge_api/models/audience_list_contacts_params.rbi

@@ -14,6 +14,10 @@ module SurgeAPI
           )
         end
 
+      # The audience ID to list contacts for.
+      sig { returns(String) }
+      attr_accessor :audience_id
+
       # Cursor for forward pagination. Use the next_cursor from a previous response.
       sig { returns(T.nilable(String)) }
       attr_reader :after
@@ -31,12 +35,15 @@ module SurgeAPI
 
       sig do
         params(
+          audience_id: String,
           after: String,
           before: String,
           request_options: SurgeAPI::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
+        # The audience ID to list contacts for.
+        audience_id:,
         # Cursor for forward pagination. Use the next_cursor from a previous response.
         after: nil,
         # Cursor for backward pagination. Use the previous_cursor from a previous
@@ -49,6 +56,7 @@ module SurgeAPI
       sig do
         override.returns(
           {
+            audience_id: String,
             after: String,
             before: String,
             request_options: SurgeAPI::RequestOptions

data/rbi/surge_api/models/blast_create_params.rbi

@@ -11,6 +11,10 @@ module SurgeAPI
           T.any(SurgeAPI::BlastCreateParams, SurgeAPI::Internal::AnyHash)
         end
 
+      # The account for which the blast should be sent.
+      sig { returns(String) }
+      attr_accessor :account_id
+
       sig do
         returns(T.nilable(T::Array[SurgeAPI::BlastCreateParams::Attachment]))
       end
@@ -74,6 +78,7 @@ module SurgeAPI
 
       sig do
         params(
+          account_id: String,
           attachments:
             T::Array[SurgeAPI::BlastCreateParams::Attachment::OrHash],
           body: T.nilable(String),
@@ -87,6 +92,8 @@ module SurgeAPI
         ).returns(T.attached_class)
       end
       def self.new(
+        # The account for which the blast should be sent.
+        account_id:,
         attachments: nil,
         # The message body.
         body: nil,
@@ -112,6 +119,7 @@ module SurgeAPI
       sig do
         override.returns(
           {
+            account_id: String,
             attachments: T::Array[SurgeAPI::BlastCreateParams::Attachment],
             body: T.nilable(String),
             contacts: T::Array[String],

data/rbi/surge_api/models/call_ended_webhook_event.rbi

@@ -94,6 +94,18 @@ module SurgeAPI
         end
         attr_accessor :status
 
+        # The E.164 phone number of the caller
+        sig { returns(T.nilable(String)) }
+        attr_accessor :from
+
+        # The Surge phone number ID (e.g. pn\_...)
+        sig { returns(T.nilable(String)) }
+        attr_accessor :phone_number_id
+
+        # The E.164 phone number of the callee
+        sig { returns(T.nilable(String)) }
+        attr_accessor :to
+
         # The data associated with the event
         sig do
           params(
@@ -101,7 +113,10 @@ module SurgeAPI
             contact: SurgeAPI::Contact::OrHash,
             duration: Integer,
             initiated_at: Time,
-            status: SurgeAPI::CallEndedWebhookEvent::Data::Status::OrSymbol
+            status: SurgeAPI::CallEndedWebhookEvent::Data::Status::OrSymbol,
+            from: T.nilable(String),
+            phone_number_id: T.nilable(String),
+            to: T.nilable(String)
           ).returns(T.attached_class)
         end
         def self.new(
@@ -114,7 +129,13 @@ module SurgeAPI
           # When the call was initiated
           initiated_at:,
           # The status of the call
-          status:
+          status:,
+          # The E.164 phone number of the caller
+          from: nil,
+          # The Surge phone number ID (e.g. pn\_...)
+          phone_number_id: nil,
+          # The E.164 phone number of the callee
+          to: nil
         )
         end
 
@@ -126,7 +147,10 @@ module SurgeAPI
               duration: Integer,
               initiated_at: Time,
               status:
-                SurgeAPI::CallEndedWebhookEvent::Data::Status::TaggedSymbol
+                SurgeAPI::CallEndedWebhookEvent::Data::Status::TaggedSymbol,
+              from: T.nilable(String),
+              phone_number_id: T.nilable(String),
+              to: T.nilable(String)
             }
           )
         end

data/rbi/surge_api/models/campaign_create_params.rbi

@@ -11,46 +11,26 @@ module SurgeAPI
           T.any(SurgeAPI::CampaignCreateParams, SurgeAPI::Internal::AnyHash)
         end
 
-      # Parameters for creating a new campaign. Either provide full campaign details or
-      # import using a TCR ID.
-      sig do
-        returns(
-          T.any(
-            SurgeAPI::CampaignParams::StandardCampaignParams,
-            SurgeAPI::CampaignParams::ExternalCampaignParams
-          )
-        )
-      end
-      attr_accessor :campaign_params
+      # The account for which the campaign should be created.
+      sig { returns(String) }
+      attr_accessor :account_id
 
       sig do
         params(
-          campaign_params:
-            T.any(
-              SurgeAPI::CampaignParams::StandardCampaignParams::OrHash,
-              SurgeAPI::CampaignParams::ExternalCampaignParams::OrHash
-            ),
+          account_id: String,
           request_options: SurgeAPI::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
-        # Parameters for creating a new campaign. Either provide full campaign details or
-        # import using a TCR ID.
-        campaign_params:,
+        # The account for which the campaign should be created.
+        account_id:,
         request_options: {}
       )
       end
 
       sig do
         override.returns(
-          {
-            campaign_params:
-              T.any(
-                SurgeAPI::CampaignParams::StandardCampaignParams,
-                SurgeAPI::CampaignParams::ExternalCampaignParams
-              ),
-            request_options: SurgeAPI::RequestOptions
-          }
+          { account_id: String, request_options: SurgeAPI::RequestOptions }
         )
       end
       def to_hash

data/rbi/surge_api/models/campaign_list_params.rbi

@@ -11,6 +11,10 @@ module SurgeAPI
           T.any(SurgeAPI::CampaignListParams, SurgeAPI::Internal::AnyHash)
         end
 
+      # The account ID to list campaigns for.
+      sig { returns(String) }
+      attr_accessor :account_id
+
       # Cursor for forward pagination. Use the next_cursor from a previous response.
       sig { returns(T.nilable(String)) }
       attr_reader :after
@@ -28,12 +32,15 @@ module SurgeAPI
 
       sig do
         params(
+          account_id: String,
           after: String,
           before: String,
           request_options: SurgeAPI::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
+        # The account ID to list campaigns for.
+        account_id:,
         # Cursor for forward pagination. Use the next_cursor from a previous response.
         after: nil,
         # Cursor for backward pagination. Use the previous_cursor from a previous
@@ -46,6 +53,7 @@ module SurgeAPI
       sig do
         override.returns(
           {
+            account_id: String,
             after: String,
             before: String,
             request_options: SurgeAPI::RequestOptions

data/rbi/surge_api/models/campaign_retrieve_params.rbi

@@ -11,15 +11,28 @@ module SurgeAPI
           T.any(SurgeAPI::CampaignRetrieveParams, SurgeAPI::Internal::AnyHash)
         end
 
+      # The ID of the campaign to retrieve.
+      sig { returns(String) }
+      attr_accessor :id
+
       sig do
-        params(request_options: SurgeAPI::RequestOptions::OrHash).returns(
-          T.attached_class
-        )
+        params(
+          id: String,
+          request_options: SurgeAPI::RequestOptions::OrHash
+        ).returns(T.attached_class)
       end
-      def self.new(request_options: {})
+      def self.new(
+        # The ID of the campaign to retrieve.
+        id:,
+        request_options: {}
+      )
       end
 
-      sig { override.returns({ request_options: SurgeAPI::RequestOptions }) }
+      sig do
+        override.returns(
+          { id: String, request_options: SurgeAPI::RequestOptions }
+        )
+      end
       def to_hash
       end
     end

data/rbi/surge_api/models/campaign_update_params.rbi

@@ -11,46 +11,26 @@ module SurgeAPI
           T.any(SurgeAPI::CampaignUpdateParams, SurgeAPI::Internal::AnyHash)
         end
 
-      # Parameters for creating a new campaign. Either provide full campaign details or
-      # import using a TCR ID.
-      sig do
-        returns(
-          T.any(
-            SurgeAPI::CampaignParams::StandardCampaignParams,
-            SurgeAPI::CampaignParams::ExternalCampaignParams
-          )
-        )
-      end
-      attr_accessor :campaign_params
+      # The ID of the campaign to update.
+      sig { returns(String) }
+      attr_accessor :id
 
       sig do
         params(
-          campaign_params:
-            T.any(
-              SurgeAPI::CampaignParams::StandardCampaignParams::OrHash,
-              SurgeAPI::CampaignParams::ExternalCampaignParams::OrHash
-            ),
+          id: String,
           request_options: SurgeAPI::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
-        # Parameters for creating a new campaign. Either provide full campaign details or
-        # import using a TCR ID.
-        campaign_params:,
+        # The ID of the campaign to update.
+        id:,
         request_options: {}
       )
       end
 
       sig do
         override.returns(
-          {
-            campaign_params:
-              T.any(
-                SurgeAPI::CampaignParams::StandardCampaignParams,
-                SurgeAPI::CampaignParams::ExternalCampaignParams
-              ),
-            request_options: SurgeAPI::RequestOptions
-          }
+          { id: String, request_options: SurgeAPI::RequestOptions }
         )
       end
       def to_hash

data/rbi/surge_api/models/contact_create_params.rbi

@@ -11,6 +11,10 @@ module SurgeAPI
           T.any(SurgeAPI::ContactCreateParams, SurgeAPI::Internal::AnyHash)
         end
 
+      # The account for which the contact should be created.
+      sig { returns(String) }
+      attr_accessor :account_id
+
       # The contact's phone number in E.164 format.
       sig { returns(String) }
       attr_accessor :phone_number
@@ -45,6 +49,7 @@ module SurgeAPI
 
       sig do
         params(
+          account_id: String,
           phone_number: String,
           email: String,
           first_name: String,
@@ -54,6 +59,8 @@ module SurgeAPI
         ).returns(T.attached_class)
       end
       def self.new(
+        # The account for which the contact should be created.
+        account_id:,
         # The contact's phone number in E.164 format.
         phone_number:,
         # The contact's email address.
@@ -71,6 +78,7 @@ module SurgeAPI
       sig do
         override.returns(
           {
+            account_id: String,
             phone_number: String,
             email: String,
             first_name: String,

data/rbi/surge_api/models/contact_list_params.rbi

@@ -11,6 +11,10 @@ module SurgeAPI
           T.any(SurgeAPI::ContactListParams, SurgeAPI::Internal::AnyHash)
         end
 
+      # The account ID to list contacts for.
+      sig { returns(String) }
+      attr_accessor :account_id
+
       # Cursor for forward pagination. Use the next_cursor from a previous response.
       sig { returns(T.nilable(String)) }
       attr_reader :after
@@ -28,12 +32,15 @@ module SurgeAPI
 
       sig do
         params(
+          account_id: String,
           after: String,
           before: String,
           request_options: SurgeAPI::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
+        # The account ID to list contacts for.
+        account_id:,
         # Cursor for forward pagination. Use the next_cursor from a previous response.
         after: nil,
         # Cursor for backward pagination. Use the previous_cursor from a previous
@@ -46,6 +53,7 @@ module SurgeAPI
       sig do
         override.returns(
           {
+            account_id: String,
             after: String,
             before: String,
             request_options: SurgeAPI::RequestOptions

data/rbi/surge_api/models/contact_retrieve_params.rbi

@@ -11,15 +11,28 @@ module SurgeAPI
           T.any(SurgeAPI::ContactRetrieveParams, SurgeAPI::Internal::AnyHash)
         end
 
+      # The ID of the contact to retrieve.
+      sig { returns(String) }
+      attr_accessor :id
+
       sig do
-        params(request_options: SurgeAPI::RequestOptions::OrHash).returns(
-          T.attached_class
-        )
+        params(
+          id: String,
+          request_options: SurgeAPI::RequestOptions::OrHash
+        ).returns(T.attached_class)
       end
-      def self.new(request_options: {})
+      def self.new(
+        # The ID of the contact to retrieve.
+        id:,
+        request_options: {}
+      )
       end
 
-      sig { override.returns({ request_options: SurgeAPI::RequestOptions }) }
+      sig do
+        override.returns(
+          { id: String, request_options: SurgeAPI::RequestOptions }
+        )
+      end
       def to_hash
       end
     end

data/rbi/surge_api/models/contact_update_params.rbi

@@ -11,6 +11,10 @@ module SurgeAPI
           T.any(SurgeAPI::ContactUpdateParams, SurgeAPI::Internal::AnyHash)
         end
 
+      # The ID of the contact to update.
+      sig { returns(String) }
+      attr_accessor :id
+
       # The contact's phone number in E.164 format.
       sig { returns(String) }
       attr_accessor :phone_number
@@ -45,6 +49,7 @@ module SurgeAPI
 
       sig do
         params(
+          id: String,
           phone_number: String,
           email: String,
           first_name: String,
@@ -54,6 +59,8 @@ module SurgeAPI
         ).returns(T.attached_class)
       end
       def self.new(
+        # The ID of the contact to update.
+        id:,
         # The contact's phone number in E.164 format.
         phone_number:,
         # The contact's email address.
@@ -71,6 +78,7 @@ module SurgeAPI
       sig do
         override.returns(
           {
+            id: String,
             phone_number: String,
             email: String,
             first_name: String,

data/rbi/surge_api/models/message.rbi

@@ -159,6 +159,8 @@ module SurgeAPI
           IMAGE =
             T.let(:image, SurgeAPI::Message::Attachment::Type::TaggedSymbol)
           LINK = T.let(:link, SurgeAPI::Message::Attachment::Type::TaggedSymbol)
+          CONTACT =
+            T.let(:contact, SurgeAPI::Message::Attachment::Type::TaggedSymbol)
           VIDEO =
             T.let(:video, SurgeAPI::Message::Attachment::Type::TaggedSymbol)
 

data/rbi/surge_api/models/message_create_params.rbi

@@ -11,48 +11,26 @@ module SurgeAPI
           T.any(SurgeAPI::MessageCreateParams, SurgeAPI::Internal::AnyHash)
         end
 
-      # Payload for creating a message. Either an attachment or the body must be given.
-      # You can specify the recipient either using the 'conversation' parameter or the
-      # 'to'/'from' parameters, but not both.
-      sig do
-        returns(
-          T.any(
-            SurgeAPI::MessageParams::MessageParamsWithConversation,
-            SurgeAPI::MessageParams::SimpleMessageParams
-          )
-        )
-      end
-      attr_accessor :message_params
+      # The account from which the message should be sent.
+      sig { returns(String) }
+      attr_accessor :account_id
 
       sig do
         params(
-          message_params:
-            T.any(
-              SurgeAPI::MessageParams::MessageParamsWithConversation::OrHash,
-              SurgeAPI::MessageParams::SimpleMessageParams::OrHash
-            ),
+          account_id: String,
           request_options: SurgeAPI::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
-        # Payload for creating a message. Either an attachment or the body must be given.
-        # You can specify the recipient either using the 'conversation' parameter or the
-        # 'to'/'from' parameters, but not both.
-        message_params:,
+        # The account from which the message should be sent.
+        account_id:,
         request_options: {}
       )
       end
 
       sig do
         override.returns(
-          {
-            message_params:
-              T.any(
-                SurgeAPI::MessageParams::MessageParamsWithConversation,
-                SurgeAPI::MessageParams::SimpleMessageParams
-              ),
-            request_options: SurgeAPI::RequestOptions
-          }
+          { account_id: String, request_options: SurgeAPI::RequestOptions }
         )
       end
       def to_hash

data/rbi/surge_api/models/message_delivered_webhook_event.rbi

@@ -329,6 +329,11 @@ module SurgeAPI
                 :link,
                 SurgeAPI::MessageDeliveredWebhookEvent::Data::Attachment::Type::TaggedSymbol
               )
+            CONTACT =
+              T.let(
+                :contact,
+                SurgeAPI::MessageDeliveredWebhookEvent::Data::Attachment::Type::TaggedSymbol
+              )
             VIDEO =
               T.let(
                 :video,

data/rbi/surge_api/models/message_failed_webhook_event.rbi

@@ -333,6 +333,11 @@ module SurgeAPI
                 :link,
                 SurgeAPI::MessageFailedWebhookEvent::Data::Attachment::Type::TaggedSymbol
               )
+            CONTACT =
+              T.let(
+                :contact,
+                SurgeAPI::MessageFailedWebhookEvent::Data::Attachment::Type::TaggedSymbol
+              )
             VIDEO =
               T.let(
                 :video,

data/rbi/surge_api/models/message_list_params.rbi

@@ -11,6 +11,10 @@ module SurgeAPI
           T.any(SurgeAPI::MessageListParams, SurgeAPI::Internal::AnyHash)
         end
 
+      # The account ID to list messages for.
+      sig { returns(String) }
+      attr_accessor :account_id
+
       # Cursor for forward pagination. Use the next_cursor from a previous response.
       sig { returns(T.nilable(String)) }
       attr_reader :after
@@ -28,12 +32,15 @@ module SurgeAPI
 
       sig do
         params(
+          account_id: String,
           after: String,
           before: String,
           request_options: SurgeAPI::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
+        # The account ID to list messages for.
+        account_id:,
         # Cursor for forward pagination. Use the next_cursor from a previous response.
         after: nil,
         # Cursor for backward pagination. Use the previous_cursor from a previous
@@ -46,6 +53,7 @@ module SurgeAPI
       sig do
         override.returns(
           {
+            account_id: String,
             after: String,
             before: String,
             request_options: SurgeAPI::RequestOptions