surge_api 0.14.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4ab96cd22457002ccedc81712121dba63dbae5e4cf07727d9b993b92fd0969b0
-  data.tar.gz: 1eb78284fdc3b52214c58857cd45cc36133b344e95a10066dbd4b2b89636354d
+  metadata.gz: 46beb8f51bbd1bbf30a337fd8f1bebec392a3e283b06663859e8c6fbc4418806
+  data.tar.gz: dd34d84097ceff18e2b17111d1513fa701d20079d4d90329f816eb3e89d14938
 SHA512:
-  metadata.gz: 66e8cbb2c329875bd0eada2097083f37de865d9909c421cd8a40b05b003f6c79f2ed4bb0137ac2f77d8159077499f12371c0a59dd4a47316fc02fb4d3eb37f4d
-  data.tar.gz: 51690c17e967f65a50ecde699f3ebd40b88dbc67bf53add883b147698c4fcb8e2477a12f346d4beb93d7d9ceda221b57c3e9a9604a0e3903eea2c954bc5b2fd1
+  metadata.gz: 6cf4a3222dd600709a14d8e718bb8bf04a9fd15650575914c136d11cb073e0d78724859e182b450ba7550fa46dfa8a2b3345e5e1175365477f9df729b992e385
+  data.tar.gz: ccb9085d52e5c8930568f9a511d6f6fe41e6f12f0aafacf515f201dde5c51d5ad04cb0d8341f4b7074eb7089e4c97dd69d35868ee9349c891abd5b588b522471

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.16.0 (2026-04-22)
+
+Full Changelog: [v0.15.0...v0.16.0](https://github.com/surgeapi/ruby-sdk/compare/v0.15.0...v0.16.0)
+
+### Features
+
+* **api:** add endpoint to get attachment file ([5475d91](https://github.com/surgeapi/ruby-sdk/commit/5475d91e283e6afb974243f11a259e9990471f88))
+* **api:** add message to link.followed events ([1c36d5c](https://github.com/surgeapi/ruby-sdk/commit/1c36d5c6c21eb866aa5489ce0b70b01bfd01a9e4))
+* **api:** add name to phone numbers ([ee71d0d](https://github.com/surgeapi/ruby-sdk/commit/ee71d0dcec71388ed0af4132759072cca94e11f0))
+
+## 0.15.0 (2026-04-06)
+
+Full Changelog: [v0.14.0...v0.15.0](https://github.com/surgeapi/ruby-sdk/compare/v0.14.0...v0.15.0)
+
+### Features
+
+* **api:** create an audience ([817fd30](https://github.com/surgeapi/ruby-sdk/commit/817fd3063e6346d452062fb720b42495f030d1e9))
+* **api:** require terms_and_conditions_url for campaigns ([859ee36](https://github.com/surgeapi/ruby-sdk/commit/859ee3658653d0c0dfee2b7d6118e4adf7cb9c46))
+* **api:** update a campaign ([b22a5e4](https://github.com/surgeapi/ruby-sdk/commit/b22a5e438e80654d4ea05572d4e54c32594eba22))
+
 ## 0.14.0 (2026-04-01)
 
 Full Changelog: [v0.13.0...v0.14.0](https://github.com/surgeapi/ruby-sdk/compare/v0.13.0...v0.14.0)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "surge_api", "~> 0.14.0"
+gem "surge_api", "~> 0.16.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/surge_api/client.rb

@@ -21,6 +21,9 @@ module SurgeAPI
     # @return [SurgeAPI::Resources::Accounts]
     attr_reader :accounts
 
+    # @return [SurgeAPI::Resources::Attachments]
+    attr_reader :attachments
+
     # @return [SurgeAPI::Resources::Audiences]
     attr_reader :audiences
 
@@ -99,6 +102,7 @@ module SurgeAPI
       )
 
       @accounts = SurgeAPI::Resources::Accounts.new(client: self)
+      @attachments = SurgeAPI::Resources::Attachments.new(client: self)
       @audiences = SurgeAPI::Resources::Audiences.new(client: self)
       @blasts = SurgeAPI::Resources::Blasts.new(client: self)
       @campaigns = SurgeAPI::Resources::Campaigns.new(client: self)

data/lib/surge_api/models/attachment_get_file_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Models
+    # @see SurgeAPI::Resources::Attachments#get_file
+    class AttachmentGetFileParams < SurgeAPI::Internal::Type::BaseModel
+      extend SurgeAPI::Internal::Type::RequestParameters::Converter
+      include SurgeAPI::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [SurgeAPI::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/surge_api/models/attachment_get_file_response.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Models
+    # @see SurgeAPI::Resources::Attachments#get_file
+    class AttachmentGetFileResponse < SurgeAPI::Internal::Type::BaseModel
+      # @!attribute error
+      #   An error response
+      #
+      #   @return [SurgeAPI::Models::Error]
+      required :error, -> { SurgeAPI::Error }
+
+      # @!method initialize(error:)
+      #   An error response
+      #
+      #   @param error [SurgeAPI::Models::Error] An error response
+    end
+  end
+end

data/lib/surge_api/models/audience_create_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Models
+    # @see SurgeAPI::Resources::Audiences#create
+    class AudienceCreateParams < SurgeAPI::Internal::Type::BaseModel
+      extend SurgeAPI::Internal::Type::RequestParameters::Converter
+      include SurgeAPI::Internal::Type::RequestParameters
+
+      # @!attribute name
+      #   The audience name.
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!method initialize(name:, request_options: {})
+      #   @param name [String] The audience name.
+      #
+      #   @param request_options [SurgeAPI::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/surge_api/models/audience_create_response.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Models
+    # @see SurgeAPI::Resources::Audiences#create
+    class AudienceCreateResponse < SurgeAPI::Internal::Type::BaseModel
+      # @!attribute id
+      #   Unique identifier for the object.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute name
+      #   A name to identify this Audience. This name will only be visible within Surge.
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!method initialize(id:, name:)
+      #   A group of contacts used for targeting messages.
+      #
+      #   @param id [String] Unique identifier for the object.
+      #
+      #   @param name [String] A name to identify this Audience. This name will only be visible within Surge.
+    end
+  end
+end

data/lib/surge_api/models/campaign_params.rb

@@ -50,6 +50,15 @@ module SurgeAPI
         #   @return [String]
         required :privacy_policy_url, String
 
+        # @!attribute terms_and_conditions_url
+        #   The URL of the terms and conditions presented to end users when they opt in to
+        #   messaging. These terms and conditions may be shared among all of a platform's
+        #   customers if they're the terms that are presented to end users when they opt in
+        #   to messaging.
+        #
+        #   @return [String]
+        required :terms_and_conditions_url, String
+
         # @!attribute use_cases
         #   A list containing 1-5 types of messages that will be sent with this campaign.
         #
@@ -122,16 +131,7 @@ module SurgeAPI
         #   @return [String, nil]
         optional :link_sample, String
 
-        # @!attribute terms_and_conditions_url
-        #   The URL of the terms and conditions presented to end users when they opt in to
-        #   messaging. These terms and conditions may be shared among all of a platform's
-        #   customers if they're the terms that are presented to end users when they opt in
-        #   to messaging.
-        #
-        #   @return [String, nil]
-        optional :terms_and_conditions_url, String
-
-        # @!method initialize(consent_flow:, description:, message_samples:, privacy_policy_url:, use_cases:, volume:, includes: nil, link_sample: nil, terms_and_conditions_url: nil)
+        # @!method initialize(consent_flow:, description:, message_samples:, privacy_policy_url:, terms_and_conditions_url:, use_cases:, volume:, includes: nil, link_sample: nil)
         #   Some parameter documentations has been truncated, see
         #   {SurgeAPI::Models::CampaignParams::StandardCampaignParams} for more details.
         #
@@ -145,6 +145,8 @@ module SurgeAPI
         #
         #   @param privacy_policy_url [String] The URL of the privacy policy for the brand in question. This may be a shared pr
         #
+        #   @param terms_and_conditions_url [String] The URL of the terms and conditions presented to end users when they opt in to m
+        #
         #   @param use_cases [Array<Symbol, SurgeAPI::Models::CampaignParams::StandardCampaignParams::UseCase>] A list containing 1-5 types of messages that will be sent with this campaign.
         #
         #   @param volume [Symbol, SurgeAPI::Models::CampaignParams::StandardCampaignParams::Volume] This will be one of the following:
@@ -152,8 +154,6 @@ module SurgeAPI
         #   @param includes [Array<Symbol, SurgeAPI::Models::CampaignParams::StandardCampaignParams::Include>] A list of properties that this campaign should include. These properties can be
         #
         #   @param link_sample [String] A sample link that might be sent by this campaign. If links from other domains a
-        #
-        #   @param terms_and_conditions_url [String] The URL of the terms and conditions presented to end users when they opt in to m
 
         module UseCase
           extend SurgeAPI::Internal::Type::Enum

data/lib/surge_api/models/campaign_update_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Models
+    # @see SurgeAPI::Resources::Campaigns#update
+    class CampaignUpdateParams < SurgeAPI::Internal::Type::BaseModel
+      extend SurgeAPI::Internal::Type::RequestParameters::Converter
+      include SurgeAPI::Internal::Type::RequestParameters
+
+      # @!attribute campaign_params
+      #   Parameters for creating a new campaign. Either provide full campaign details or
+      #   import using a TCR ID.
+      #
+      #   @return [SurgeAPI::Models::CampaignParams::StandardCampaignParams, SurgeAPI::Models::CampaignParams::ExternalCampaignParams]
+      required :campaign_params, union: -> { SurgeAPI::CampaignParams }
+
+      # @!method initialize(campaign_params:, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {SurgeAPI::Models::CampaignUpdateParams} for more details.
+      #
+      #   @param campaign_params [SurgeAPI::Models::CampaignParams::StandardCampaignParams, SurgeAPI::Models::CampaignParams::ExternalCampaignParams] Parameters for creating a new campaign. Either provide full campaign details or
+      #
+      #   @param request_options [SurgeAPI::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/surge_api/models/link_followed_webhook_event.rb

@@ -44,11 +44,19 @@ module SurgeAPI
         #   @return [String]
         required :id, String
 
+        # @!attribute message
+        #   A Message is a communication sent to a Contact.
+        #
+        #   @return [SurgeAPI::Models::Message, nil]
+        required :message, -> { SurgeAPI::Message }, nil?: true
+
         # @!attribute message_id
-        #   The unique identifier for the message that contained the link
+        #   @deprecated Use `message.id` instead.
         #
-        #   @return [String]
-        required :message_id, String
+        #   Deprecated. The unique identifier for the message that contained the link.
+        #
+        #   @return [String, nil]
+        required :message_id, String, nil?: true
 
         # @!attribute url
         #   The original URL that was shortened
@@ -56,12 +64,14 @@ module SurgeAPI
         #   @return [String]
         required :url, String
 
-        # @!method initialize(id:, message_id:, url:)
+        # @!method initialize(id:, message:, message_id:, url:)
         #   The data associated with the event
         #
         #   @param id [String] The unique identifier for the link
         #
-        #   @param message_id [String] The unique identifier for the message that contained the link
+        #   @param message [SurgeAPI::Models::Message, nil] A Message is a communication sent to a Contact.
+        #
+        #   @param message_id [String, nil] Deprecated. The unique identifier for the message that contained the link.
         #
         #   @param url [String] The original URL that was shortened
       end

data/lib/surge_api/models/message.rb

@@ -139,6 +139,12 @@ module SurgeAPI
           #   @return [String]
           required :id, String
 
+          # @!attribute name
+          #   A human-readable name for the phone number
+          #
+          #   @return [String, nil]
+          required :name, String, nil?: true
+
           # @!attribute number
           #   The canonical format of the phone number.
           #
@@ -151,11 +157,13 @@ module SurgeAPI
           #   @return [Symbol, SurgeAPI::Models::Message::Conversation::PhoneNumber::Type]
           required :type, enum: -> { SurgeAPI::Message::Conversation::PhoneNumber::Type }
 
-          # @!method initialize(id:, number:, type:)
+          # @!method initialize(id:, name:, number:, type:)
           #   This is the phone number tied to the Surge account.
           #
           #   @param id [String] Unique identifier for the phone number
           #
+          #   @param name [String, nil] A human-readable name for the phone number
+          #
           #   @param number [String] The canonical format of the phone number.
           #
           #   @param type [Symbol, SurgeAPI::Models::Message::Conversation::PhoneNumber::Type] Whether the phone number is local, toll-free, or short code

data/lib/surge_api/models/phone_number.rb

@@ -16,6 +16,12 @@ module SurgeAPI
       #   @return [String, nil]
       required :campaign_id, String, nil?: true
 
+      # @!attribute name
+      #   A human-readable name for the phone number
+      #
+      #   @return [String, nil]
+      required :name, String, nil?: true
+
       # @!attribute number
       #   The phone number in E.164 format
       #
@@ -28,13 +34,15 @@ module SurgeAPI
       #   @return [Symbol, SurgeAPI::Models::PhoneNumber::Type]
       required :type, enum: -> { SurgeAPI::PhoneNumber::Type }
 
-      # @!method initialize(id:, campaign_id:, number:, type:)
+      # @!method initialize(id:, campaign_id:, name:, number:, type:)
       #   A phone number that can be used to send and receive messages and calls
       #
       #   @param id [String] Unique identifier for the phone number
       #
       #   @param campaign_id [String, nil] The unique identifier of the campaign this phone number is attached to, if any
       #
+      #   @param name [String, nil] A human-readable name for the phone number
+      #
       #   @param number [String] The phone number in E.164 format
       #
       #   @param type [Symbol, SurgeAPI::Models::PhoneNumber::Type] Whether the phone number is local, toll-free, or short code

data/lib/surge_api/models/phone_number_attached_to_campaign_webhook_event.rb

@@ -54,6 +54,12 @@ module SurgeAPI
         #   @return [String]
         required :campaign_id, String
 
+        # @!attribute name
+        #   A human-readable name for the phone number
+        #
+        #   @return [String, nil]
+        required :name, String, nil?: true
+
         # @!attribute number
         #   The phone number in E.164 format
         #
@@ -66,13 +72,15 @@ module SurgeAPI
         #   @return [Symbol, SurgeAPI::Models::PhoneNumberAttachedToCampaignWebhookEvent::Data::Type]
         required :type, enum: -> { SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent::Data::Type }
 
-        # @!method initialize(id:, campaign_id:, number:, type:)
+        # @!method initialize(id:, campaign_id:, name:, number:, type:)
         #   The data associated with the event
         #
         #   @param id [String] The unique identifier for the phone number
         #
         #   @param campaign_id [String] The unique identifier of the campaign this phone number is attached to
         #
+        #   @param name [String, nil] A human-readable name for the phone number
+        #
         #   @param number [String] The phone number in E.164 format
         #
         #   @param type [Symbol, SurgeAPI::Models::PhoneNumberAttachedToCampaignWebhookEvent::Data::Type] Whether the phone number is local, toll-free, or short code

data/lib/surge_api/models/phone_number_purchase_params.rb

@@ -28,6 +28,13 @@ module SurgeAPI
       #   @return [Float, nil]
       optional :longitude, Float
 
+      # @!attribute name
+      #   A human-readable name for the phone number. If not provided, defaults to the
+      #   formatted phone number.
+      #
+      #   @return [String, nil]
+      optional :name, String
+
       # @!attribute type
       #   Whether the phone number is local or toll-free. Can be omitted if area_code or
       #   latitude/longitude are provided.
@@ -35,7 +42,7 @@ module SurgeAPI
       #   @return [Symbol, SurgeAPI::Models::PhoneNumberPurchaseParams::Type, nil]
       optional :type, enum: -> { SurgeAPI::PhoneNumberPurchaseParams::Type }
 
-      # @!method initialize(area_code: nil, latitude: nil, longitude: nil, type: nil, request_options: {})
+      # @!method initialize(area_code: nil, latitude: nil, longitude: nil, name: nil, type: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {SurgeAPI::Models::PhoneNumberPurchaseParams} for more details.
       #
@@ -45,6 +52,8 @@ module SurgeAPI
       #
       #   @param longitude [Float] Longitude to search for nearby phone numbers. Must be used with latitude. If pro
       #
+      #   @param name [String] A human-readable name for the phone number. If not provided, defaults to the for
+      #
       #   @param type [Symbol, SurgeAPI::Models::PhoneNumberPurchaseParams::Type] Whether the phone number is local or toll-free. Can be omitted if area_code or l
       #
       #   @param request_options [SurgeAPI::RequestOptions, Hash{Symbol=>Object}]

data/lib/surge_api/models.rb

@@ -51,8 +51,12 @@ module SurgeAPI
 
   AccountUpdateParams = SurgeAPI::Models::AccountUpdateParams
 
+  AttachmentGetFileParams = SurgeAPI::Models::AttachmentGetFileParams
+
   AudienceAddContactParams = SurgeAPI::Models::AudienceAddContactParams
 
+  AudienceCreateParams = SurgeAPI::Models::AudienceCreateParams
+
   AudienceListContactsParams = SurgeAPI::Models::AudienceListContactsParams
 
   Blast = SurgeAPI::Models::Blast
@@ -73,6 +77,8 @@ module SurgeAPI
 
   CampaignRetrieveParams = SurgeAPI::Models::CampaignRetrieveParams
 
+  CampaignUpdateParams = SurgeAPI::Models::CampaignUpdateParams
+
   Contact = SurgeAPI::Models::Contact
 
   ContactCreateParams = SurgeAPI::Models::ContactCreateParams

data/lib/surge_api/resources/attachments.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Resources
+    class Attachments
+      # Redirects to a signed URL where the attachment file can be downloaded. URL is
+      # short-lived, so redirect should be followed immediately.
+      #
+      # @overload get_file(attachment_id, request_options: {})
+      #
+      # @param attachment_id [String] The ID of the attachment.
+      #
+      # @param request_options [SurgeAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [SurgeAPI::Models::AttachmentGetFileResponse]
+      #
+      # @see SurgeAPI::Models::AttachmentGetFileParams
+      def get_file(attachment_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["attachments/%1$s/file", attachment_id],
+          model: SurgeAPI::Models::AttachmentGetFileResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [SurgeAPI::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/surge_api/resources/audiences.rb

@@ -3,6 +3,30 @@
 module SurgeAPI
   module Resources
     class Audiences
+      # Creates a new audience.
+      #
+      # @overload create(account_id, name:, request_options: {})
+      #
+      # @param account_id [String] The account for which the audience should be created.
+      #
+      # @param name [String] The audience name.
+      #
+      # @param request_options [SurgeAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [SurgeAPI::Models::AudienceCreateResponse]
+      #
+      # @see SurgeAPI::Models::AudienceCreateParams
+      def create(account_id, params)
+        parsed, options = SurgeAPI::AudienceCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["accounts/%1$s/audiences", account_id],
+          body: parsed,
+          model: SurgeAPI::Models::AudienceCreateResponse,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {SurgeAPI::Models::AudienceAddContactParams} for more details.
       #

data/lib/surge_api/resources/campaigns.rb

@@ -55,6 +55,41 @@ module SurgeAPI
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {SurgeAPI::Models::CampaignUpdateParams} for more details.
+      #
+      # Updates a campaign that has not yet been approved. This can be used to fix
+      # issues flagged during review and resubmit the campaign. Returns an error if the
+      # campaign is currently in review, has already been approved, or has been
+      # deactivated.
+      #
+      # @overload update(id, campaign_params:, request_options: {})
+      #
+      # @param id [String] The ID of the campaign to update.
+      #
+      # @param campaign_params [SurgeAPI::CampaignParams] Parameters for creating a new campaign. Either provide full campaign details or
+      #
+      # @param request_options [SurgeAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [SurgeAPI::Models::Campaign]
+      #
+      # @see SurgeAPI::Models::CampaignUpdateParams
+      def update(id, params)
+        parsed, options = SurgeAPI::CampaignUpdateParams.dump_request(params)
+        case parsed
+        in {campaign_params: Hash => union, **rest}
+          parsed = {**rest, **union}
+        else
+        end
+        @client.request(
+          method: :patch,
+          path: ["campaigns/%1$s", id],
+          body: parsed,
+          model: SurgeAPI::Campaign,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {SurgeAPI::Models::CampaignListParams} for more details.
       #

data/lib/surge_api/resources/phone_numbers.rb

@@ -40,7 +40,7 @@ module SurgeAPI
       # Purchase a new phone number for the account. You can specify search criteria or
       # let the system select a random number.
       #
-      # @overload purchase(account_id, area_code: nil, latitude: nil, longitude: nil, type: nil, request_options: {})
+      # @overload purchase(account_id, area_code: nil, latitude: nil, longitude: nil, name: nil, type: nil, request_options: {})
       #
       # @param account_id [String] The account for which the phone number should be created.
       #
@@ -50,6 +50,8 @@ module SurgeAPI
       #
       # @param longitude [Float] Longitude to search for nearby phone numbers. Must be used with latitude. If pro
       #
+      # @param name [String] A human-readable name for the phone number. If not provided, defaults to the for
+      #
       # @param type [Symbol, SurgeAPI::Models::PhoneNumberPurchaseParams::Type] Whether the phone number is local or toll-free. Can be omitted if area_code or l
       #
       # @param request_options [SurgeAPI::RequestOptions, Hash{Symbol=>Object}, nil]

data/lib/surge_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SurgeAPI
-  VERSION = "0.14.0"
+  VERSION = "0.16.0"
 end

data/lib/surge_api.rb

@@ -61,7 +61,11 @@ require_relative "surge_api/models/account_create_params"
 require_relative "surge_api/models/account_retrieve_status_params"
 require_relative "surge_api/models/account_status"
 require_relative "surge_api/models/account_update_params"
+require_relative "surge_api/models/attachment_get_file_params"
+require_relative "surge_api/models/attachment_get_file_response"
 require_relative "surge_api/models/audience_add_contact_params"
+require_relative "surge_api/models/audience_create_params"
+require_relative "surge_api/models/audience_create_response"
 require_relative "surge_api/models/audience_list_contacts_params"
 require_relative "surge_api/models/blast"
 require_relative "surge_api/models/blast_create_params"
@@ -71,6 +75,7 @@ require_relative "surge_api/models/campaign_approved_webhook_event"
 require_relative "surge_api/models/campaign_create_params"
 require_relative "surge_api/models/campaign_list_params"
 require_relative "surge_api/models/campaign_retrieve_params"
+require_relative "surge_api/models/campaign_update_params"
 require_relative "surge_api/models/contact"
 require_relative "surge_api/models/contact_create_params"
 require_relative "surge_api/models/contact_list_params"
@@ -120,6 +125,7 @@ require_relative "surge_api/models/voicemail_received_webhook_event"
 require_relative "surge_api/models/webhook_unwrap_params"
 require_relative "surge_api/models"
 require_relative "surge_api/resources/accounts"
+require_relative "surge_api/resources/attachments"
 require_relative "surge_api/resources/audiences"
 require_relative "surge_api/resources/blasts"
 require_relative "surge_api/resources/campaigns"

data/rbi/surge_api/client.rbi

@@ -16,6 +16,9 @@ module SurgeAPI
     sig { returns(SurgeAPI::Resources::Accounts) }
     attr_reader :accounts
 
+    sig { returns(SurgeAPI::Resources::Attachments) }
+    attr_reader :attachments
+
     sig { returns(SurgeAPI::Resources::Audiences) }
     attr_reader :audiences
 

data/rbi/surge_api/models/attachment_get_file_params.rbi

@@ -0,0 +1,27 @@
+# typed: strong
+
+module SurgeAPI
+  module Models
+    class AttachmentGetFileParams < SurgeAPI::Internal::Type::BaseModel
+      extend SurgeAPI::Internal::Type::RequestParameters::Converter
+      include SurgeAPI::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(SurgeAPI::AttachmentGetFileParams, SurgeAPI::Internal::AnyHash)
+        end
+
+      sig do
+        params(request_options: SurgeAPI::RequestOptions::OrHash).returns(
+          T.attached_class
+        )
+      end
+      def self.new(request_options: {})
+      end
+
+      sig { override.returns({ request_options: SurgeAPI::RequestOptions }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/surge_api/models/attachment_get_file_response.rbi

@@ -0,0 +1,34 @@
+# typed: strong
+
+module SurgeAPI
+  module Models
+    class AttachmentGetFileResponse < SurgeAPI::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            SurgeAPI::Models::AttachmentGetFileResponse,
+            SurgeAPI::Internal::AnyHash
+          )
+        end
+
+      # An error response
+      sig { returns(SurgeAPI::Error) }
+      attr_reader :error
+
+      sig { params(error: SurgeAPI::Error::OrHash).void }
+      attr_writer :error
+
+      # An error response
+      sig { params(error: SurgeAPI::Error::OrHash).returns(T.attached_class) }
+      def self.new(
+        # An error response
+        error:
+      )
+      end
+
+      sig { override.returns({ error: SurgeAPI::Error }) }
+      def to_hash
+      end
+    end
+  end
+end