twilio-ruby 7.9.0 → 7.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7d7b336bf9b2991bc49c17ca8c21bf48d30404a3
-  data.tar.gz: ebfe33678601bcffdea47d8d9ba87986ba076a57
+  metadata.gz: ee948f47784c5d49ae7243b9b002376870a6ddc3
+  data.tar.gz: 69e8b52f1c5cdde77e96325e87c988f28ca0cd12
 SHA512:
-  metadata.gz: 15e023044c5b7f71d47ca46f950be16a9bf92f9953d7934b8b6e57fcaf70a6119d9130642267e1387330ad57cc8f7bfee405c148e32ce48ace22a45abc9d70e2
-  data.tar.gz: 5038a92dd9a0d1f862d9778854347fe32e539966bee7cdc8d975f366df059543548369fd6dc70f9a1966be5ca5d63d0e09ecee86c88e5405f80a52fec41a8e40
+  metadata.gz: ccf16209bbd92b3cbe393fca56a34c4ac835f83f6a2076990cd4049ba997163c253204a18bf36164bcc12cbb927d70f29a82c156f3adf081007a0f62b4eb9e83
+  data.tar.gz: 741e65880219e81c967263cd5293e693a06af02b45a53de8e9cf52d3638d05df499a1f22273f751893e4b6324d7feaa547f236890b8266266fc951d1c2c8e044

data/CHANGES.md

@@ -1,6 +1,17 @@
 twilio-ruby changelog
 =====================
 
+[2026-01-07] Version 7.9.1
+--------------------------
+**Library - Chore**
+- [PR #772](https://github.com/twilio/twilio-ruby/pull/772): Token Pagination support. Thanks to [@manisha1997](https://github.com/manisha1997)!
+- [PR #773](https://github.com/twilio/twilio-ruby/pull/773): custom error response redesign. Thanks to [@manisha1997](https://github.com/manisha1997)!
+
+**Api**
+- Added optional parameter `clientNotificationUrl` for create call api
+- Added optional parameter `clientNotificationUrl` for create participant api
+
+
 [2025-12-17] Version 7.9.0
 --------------------------
 **Library - Chore**

data/README.md

@@ -39,13 +39,13 @@ This library supports the following Ruby implementations:
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 7.9.0'
+gem 'twilio-ruby', '~> 7.9.1'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 7.9.0
+gem install twilio-ruby -v 7.9.1
 ```
 
 To build and install the development branch yourself from the latest source:

data/lib/twilio-ruby/framework/rest/api_v1_version.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require_relative 'version'
+require_relative 'error'
+
+module Twilio
+  module REST
+    class ApiV1Version < Version
+      attr_accessor :api_version
+
+      def initialize(domain, version)
+        super(domain)
+        @version = version.version
+        @api_version = 'v1'
+      end
+
+      def exception(response, _)
+        RestErrorV10.new(response.body)
+      end
+    end
+  end
+end

data/lib/twilio-ruby/framework/rest/error.rb

@@ -35,5 +35,32 @@ module Twilio
 
     class ObsoleteError < StandardError
     end
+
+    class RestErrorV10 < TwilioError
+      attr_accessor :code, :message, :http_status_code, :params, :user_error
+
+      def initialize(response)
+        @code = response['code']
+        @message = response['message']
+        @http_status_code = response['httpsStatusCode']
+        @params = response['params']
+        @user_error = response['userError']
+      end
+
+      def to_s
+        message
+      end
+
+      private
+
+      def format_message(initial_message)
+        message_response = "[HTTP #{status_code}] #{code} : #{initial_message}"
+        message_response += "\n#{message}" if message
+        message_response += "\n#{http_status_code}" if http_status_code
+        message_response += "\n#{params}" if params
+        message_response += "\n#{user_error}" if user_error
+        message_response + "\n\n"
+      end
+    end
   end
 end

data/lib/twilio-ruby/framework/rest/token_page.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class TokenPage < Page
+      attr_accessor :key, :page_size, :url
+
+      def initialize(version, response)
+        super(version, response)
+
+        @client = @version.domain.client.http_client
+        @url = ''
+        if @client.last_request
+          full_url = @client.last_request.url
+          uri = URI.parse(full_url)
+          @url = uri.path
+          @params = @client.last_request.params
+        end
+        @page_size = @payload['meta'] && @payload['meta']['pageSize']
+        @next_token = @payload['meta'] && @payload['meta']['nextToken']
+        @previous_token = @payload['meta'] && @payload['meta']['previousToken']
+      end
+
+      def previous_token
+        @payload['meta'] && @payload['meta']['previousToken']
+      end
+
+      def previous_page
+        cached_url = previous_page_url
+        return nil unless cached_url
+
+        response = @version.domain.request('GET', cached_url, @params)
+
+        self.class.new(@version, response, @solution)
+      end
+
+      def next_token
+        @payload['meta'] && @payload['meta']['nextToken']
+      end
+
+      def previous_page_url
+        return nil if previous_token.nil?
+
+        @params['pageToken'] = previous_token
+        @version.domain.absolute_url(@url)
+      end
+
+      def next_page_url
+        token = next_token
+        return nil if token.nil? || token.to_s.empty?
+
+        @params['pageToken'] = token
+        @version.domain.absolute_url(@url)
+      end
+
+      def next_page
+        cached_url = next_page_url
+        return nil unless cached_url
+
+        response = @version.domain.request('GET', cached_url, @params)
+
+        self.class.new(@version, response, @solution)
+      end
+
+      def load_page(payload)
+        @key ||= payload['meta'] && payload['meta']['key']
+        return @payload[@key] if @key && @payload[@key]
+
+        raise Twilio::REST::TwilioError, 'Page Records can not be deserialized'
+      end
+    end
+  end
+end

data/lib/twilio-ruby/framework/rest/version.rb

@@ -3,7 +3,7 @@
 module Twilio
   module REST
     class Version
-      attr_accessor :domain
+      attr_accessor :domain, :version
 
       class RecordStream
         include Enumerable

data/lib/twilio-ruby/rest/api/v2010/account/call.rb

@@ -66,6 +66,7 @@ module Twilio
                     # @param [String] call_token A token string needed to invoke a forwarded call. A call_token is generated when an incoming call is received on a Twilio number. Pass an incoming call's call_token value to a forwarded call via the call_token parameter when creating a new call. A forwarded call should bear the same CallerID of the original incoming call.
                     # @param [String] recording_track The audio track to record for the call. Can be: `inbound`, `outbound` or `both`. The default is `both`. `inbound` records the audio that is received by Twilio. `outbound` records the audio that is generated from Twilio. `both` records the audio that is received and generated by Twilio.
                     # @param [String] time_limit The maximum duration of the call in seconds. Constraints depend on account and configuration.
+                    # @param [String] client_notification_url The URL that we should use to deliver `push call notification`.
                     # @param [String] url The absolute URL that returns the TwiML instructions for the call. We will call this URL using the `method` when the call connects. For more information, see the [Url Parameter](https://www.twilio.com/docs/voice/make-calls#specify-a-url-parameter) section in [Making Calls](https://www.twilio.com/docs/voice/make-calls).
                     # @param [String] twiml TwiML instructions for the call Twilio will use without fetching Twiml from url parameter. If both `twiml` and `url` are provided then `twiml` parameter will be ignored. Max 4000 characters.
                     # @param [String] application_sid The SID of the Application resource that will handle the call, if the call will be handled by an application.
@@ -103,6 +104,7 @@ module Twilio
                         call_token: :unset, 
                         recording_track: :unset, 
                         time_limit: :unset, 
+                        client_notification_url: :unset, 
                         url: :unset, 
                         twiml: :unset, 
                         application_sid: :unset
@@ -141,6 +143,7 @@ module Twilio
                             'CallToken' => call_token,
                             'RecordingTrack' => recording_track,
                             'TimeLimit' => time_limit,
+                            'ClientNotificationUrl' => client_notification_url,
                             'Url' => url,
                             'Twiml' => twiml,
                             'ApplicationSid' => application_sid,

data/lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb

@@ -83,6 +83,7 @@ module Twilio
                     # @param [String] amd_status_callback_method The HTTP method we should use when calling the `amd_status_callback` URL. Can be: `GET` or `POST` and the default is `POST`.
                     # @param [String] trim Whether to trim any leading and trailing silence from the participant recording. Can be: `trim-silence` or `do-not-trim` and the default is `trim-silence`.
                     # @param [String] call_token A token string needed to invoke a forwarded call. A call_token is generated when an incoming call is received on a Twilio number. Pass an incoming call's call_token value to a forwarded call via the call_token parameter when creating a new call. A forwarded call should bear the same CallerID of the original incoming call.
+                    # @param [String] client_notification_url The URL that we should use to deliver `push call notification`.
                     # @param [String] caller_display_name The name that populates the display name in the From header. Must be between 2 and 255 characters. Only applicable for calls to sip address.
                     # @return [ParticipantInstance] Created ParticipantInstance
                     def create(
@@ -134,6 +135,7 @@ module Twilio
                         amd_status_callback_method: :unset, 
                         trim: :unset, 
                         call_token: :unset, 
+                        client_notification_url: :unset, 
                         caller_display_name: :unset
                     )
 
@@ -186,6 +188,7 @@ module Twilio
                             'AmdStatusCallbackMethod' => amd_status_callback_method,
                             'Trim' => trim,
                             'CallToken' => call_token,
+                            'ClientNotificationUrl' => client_notification_url,
                             'CallerDisplayName' => caller_display_name,
                         })
 

data/lib/twilio-ruby/rest/messaging/v1/tollfree_verification.rb

@@ -67,6 +67,8 @@ module Twilio
                     # @param [String] terms_and_conditions_url The URL to the terms and conditions for the business or organization.
                     # @param [Boolean] age_gated_content Indicates if the content is age gated.
                     # @param [Array[String]] opt_in_keywords List of keywords that users can text in to opt in to receive messages.
+                    # @param [VettingProvider] vetting_provider 
+                    # @param [String] vetting_id The unique ID of the vetting
                     # @return [TollfreeVerificationInstance] Created TollfreeVerificationInstance
                     def create(
                         business_name: nil, 
@@ -103,7 +105,9 @@ module Twilio
                         privacy_policy_url: :unset, 
                         terms_and_conditions_url: :unset, 
                         age_gated_content: :unset, 
-                        opt_in_keywords: :unset
+                        opt_in_keywords: :unset, 
+                        vetting_provider: :unset, 
+                        vetting_id: :unset
                     )
 
                         data = Twilio::Values.of({
@@ -142,6 +146,8 @@ module Twilio
                             'TermsAndConditionsUrl' => terms_and_conditions_url,
                             'AgeGatedContent' => age_gated_content,
                             'OptInKeywords' => Twilio.serialize_list(opt_in_keywords) { |e| e },
+                            'VettingProvider' => vetting_provider,
+                            'VettingId' => vetting_id,
                         })
 
                         headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
@@ -366,6 +372,8 @@ module Twilio
                     # @param [String] terms_and_conditions_url The URL to the terms and conditions for the business or organization.
                     # @param [Boolean] age_gated_content Indicates if the content is age gated.
                     # @param [Array[String]] opt_in_keywords List of keywords that users can text in to opt in to receive messages.
+                    # @param [VettingProvider] vetting_provider 
+                    # @param [String] vetting_id The unique ID of the vetting
                     # @return [TollfreeVerificationInstance] Updated TollfreeVerificationInstance
                     def update(
                         business_name: :unset, 
@@ -400,7 +408,9 @@ module Twilio
                         privacy_policy_url: :unset, 
                         terms_and_conditions_url: :unset, 
                         age_gated_content: :unset, 
-                        opt_in_keywords: :unset
+                        opt_in_keywords: :unset, 
+                        vetting_provider: :unset, 
+                        vetting_id: :unset
                     )
 
                         data = Twilio::Values.of({
@@ -437,6 +447,8 @@ module Twilio
                             'TermsAndConditionsUrl' => terms_and_conditions_url,
                             'AgeGatedContent' => age_gated_content,
                             'OptInKeywords' => Twilio.serialize_list(opt_in_keywords) { |e| e },
+                            'VettingProvider' => vetting_provider,
+                            'VettingId' => vetting_id,
                         })
 
                         headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
@@ -562,6 +574,9 @@ module Twilio
                             'rejection_reasons' => payload['rejection_reasons'],
                             'resource_links' => payload['resource_links'],
                             'external_reference_id' => payload['external_reference_id'],
+                            'vetting_id' => payload['vetting_id'],
+                            'vetting_provider' => payload['vetting_provider'],
+                            'vetting_id_expiration' => Twilio.deserialize_iso8601_datetime(payload['vetting_id_expiration']),
                         }
 
                         # Context
@@ -880,6 +895,24 @@ module Twilio
                         @properties['external_reference_id']
                     end
                     
+                    ##
+                    # @return [String] 
+                    def vetting_id
+                        @properties['vetting_id']
+                    end
+                    
+                    ##
+                    # @return [VettingProvider] 
+                    def vetting_provider
+                        @properties['vetting_provider']
+                    end
+                    
+                    ##
+                    # @return [Time] 
+                    def vetting_id_expiration
+                        @properties['vetting_id_expiration']
+                    end
+                    
                     ##
                     # Delete the TollfreeVerificationInstance
                     # @return [Boolean] True if delete succeeds, false otherwise
@@ -931,6 +964,8 @@ module Twilio
                     # @param [String] terms_and_conditions_url The URL to the terms and conditions for the business or organization.
                     # @param [Boolean] age_gated_content Indicates if the content is age gated.
                     # @param [Array[String]] opt_in_keywords List of keywords that users can text in to opt in to receive messages.
+                    # @param [VettingProvider] vetting_provider 
+                    # @param [String] vetting_id The unique ID of the vetting
                     # @return [TollfreeVerificationInstance] Updated TollfreeVerificationInstance
                     def update(
                         business_name: :unset, 
@@ -965,7 +1000,9 @@ module Twilio
                         privacy_policy_url: :unset, 
                         terms_and_conditions_url: :unset, 
                         age_gated_content: :unset, 
-                        opt_in_keywords: :unset
+                        opt_in_keywords: :unset, 
+                        vetting_provider: :unset, 
+                        vetting_id: :unset
                     )
 
                         context.update(
@@ -1002,6 +1039,8 @@ module Twilio
                             terms_and_conditions_url: terms_and_conditions_url, 
                             age_gated_content: age_gated_content, 
                             opt_in_keywords: opt_in_keywords, 
+                            vetting_provider: vetting_provider, 
+                            vetting_id: vetting_id, 
                         )
                     end
 

data/lib/twilio-ruby/version.rb

@@ -1,3 +1,3 @@
 module Twilio
-    VERSION = '7.9.0'
+    VERSION = '7.9.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: twilio-ruby
 version: !ruby/object:Gem::Version
-  version: 7.9.0
+  version: 7.9.1
 platform: ruby
 authors:
 - Twilio API Team
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-12-17 00:00:00.000000000 Z
+date: 2026-01-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jwt
@@ -238,12 +238,14 @@ files:
 - lib/twilio-ruby/credential/orgs_credential_provider.rb
 - lib/twilio-ruby/framework/request.rb
 - lib/twilio-ruby/framework/response.rb
+- lib/twilio-ruby/framework/rest/api_v1_version.rb
 - lib/twilio-ruby/framework/rest/domain.rb
 - lib/twilio-ruby/framework/rest/error.rb
 - lib/twilio-ruby/framework/rest/helper.rb
 - lib/twilio-ruby/framework/rest/obsolete_client.rb
 - lib/twilio-ruby/framework/rest/page.rb
 - lib/twilio-ruby/framework/rest/resource.rb
+- lib/twilio-ruby/framework/rest/token_page.rb
 - lib/twilio-ruby/framework/rest/version.rb
 - lib/twilio-ruby/framework/serialize.rb
 - lib/twilio-ruby/framework/values.rb