twilio-ruby 7.9.0 → 7.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7d7b336bf9b2991bc49c17ca8c21bf48d30404a3
-  data.tar.gz: ebfe33678601bcffdea47d8d9ba87986ba076a57
+  metadata.gz: aa0cf190ca0f4823449dbedfbb9a4fce4db8a647
+  data.tar.gz: 8e15fcae831756870ca472ced2afd7255e6d65f3
 SHA512:
-  metadata.gz: 15e023044c5b7f71d47ca46f950be16a9bf92f9953d7934b8b6e57fcaf70a6119d9130642267e1387330ad57cc8f7bfee405c148e32ce48ace22a45abc9d70e2
-  data.tar.gz: 5038a92dd9a0d1f862d9778854347fe32e539966bee7cdc8d975f366df059543548369fd6dc70f9a1966be5ca5d63d0e09ecee86c88e5405f80a52fec41a8e40
+  metadata.gz: 8aae282d9dce73bae1f96f48cd980dafffdf9533d80aeffc642b89f0dbc349a06be57d86729a22d2d413f981c769d97dcb22d8cd1a4e9e097a3baaec5e3500d6
+  data.tar.gz: f3c4e6604fa484edcfacfd23d7ace977f9cc28922578446399481a368a1f4b7ed4f0ebefd84cd6a8cac2bb76937d9c2d12e0942299938c498df86cf9854ff5c9

data/CHANGES.md

@@ -1,6 +1,98 @@
 twilio-ruby changelog
 =====================
 
+[2026-01-22] Version 7.10.0
+---------------------------
+**Library - Feature**
+- [PR #774](https://github.com/twilio/twilio-ruby/pull/774): Response header. Thanks to [@manisha1997](https://github.com/manisha1997)!
+
+**Library - Chore**
+- [PR #778](https://github.com/twilio/twilio-ruby/pull/778): hotfix. Thanks to [@shrutiburman](https://github.com/shrutiburman)!
+
+**Twiml**
+- Added support for <Uri> and <Headers> inside <Dial><Sip>
+
+**Assistants**
+- AI Assistants v1 release
+
+**Autopilot**
+- Remove Export resource from Autopilot Assistant
+- Add dialogue_sid param to Query list resource
+- Add Restore resource to Autopilot Assistant
+- Add one new property in Query i.e dialogue_sid
+- Add Export resource to Autopilot Assistant.
+- Adds two new properties in Assistant i.e needs_model_build and development_stage
+- Add Webhooks resource to Autopilot Assistant.
+- Introduce `autopilot` subdomain with all resources from `preview.understand`
+
+**Compliance**
+- Added the new InventoryComplianceInsights API under version `/v1`.
+
+**Content**
+- changes for adding v2 endpoints
+
+**Marketplace**
+- Initial transition to Marketplace domain
+
+**Memory**
+- # API Changes
+- ## 2026-01-15
+- No path changes (updated metadata only)
+- ## 2026-01-13
+- **Added 1 new path(s)**:
+- `/v1/Stores/{storeId}/Profiles/{profileId}/ConversationSummaries/{summaryId}` (DeleteProfileConversationSummary)
+- ## 2026-01-12
+- No path changes (updated metadata only)
+- ## 2026-01-12
+- No path changes (updated metadata only)
+- ## 2026-01-12
+- No path changes (updated metadata only)
+- ## 2026-01-12
+- **Added 2 new path(s)**:
+- `/v1/Stores/{storeId}/Profiles/Imports` (ListProfileImportsV2, ImportProfilesV2)
+- `/v1/Stores/{storeId}/Profiles/Imports/{importId}` (GetProfileImportV2)
+- ## 2026-01-13
+- No path changes (updated metadata only)
+- ## 2026-01-07
+- No path changes (updated metadata only)
+- ## 2026-01-05
+- No path changes (updated metadata only)
+- ## 2025-12-17
+- No path changes (updated metadata only)
+- ## 2025-12-17
+- No path changes (updated metadata only)
+- ## 2025-12-17
+- **Added 1 new path(s)**:
+- `/v1/Stores/{storeId}/Profiles/{profileId}/Observations/{observationId}/Revisions` (ListObservationRevisions)
+
+**Sender-ids**
+- Added all v2 sender-id-service endpoints
+
+**Trusthub**
+- Add new delete endpoint for compliance_registration.
+
+**Voice**
+- Add ProvisioningStatus public API endpoints.
+
+**Wise_owl**
+- Init API as open-api spec
+- Updated Get Chat, Send Message and Create Chat to include `contexts` in Message, instead of root Chat
+
+**Www**
+- Port APIs from oauth.twilio.com to www.twilio.com
+
+
+[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.10.0'
 ```
 
 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.10.0
 ```
 
 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/page_metadata.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    # Page Base Class
+    class PageMetadata
+      META_KEYS = [
+        'end',
+        'first_page_uri',
+        'next_page_uri',
+        'last_page_uri',
+        'page',
+        'page_size',
+        'previous_page_uri',
+        'total',
+        'num_pages',
+        'start',
+        'uri'
+      ].freeze
+
+      def initialize(version, response)
+        payload = process_response(response)
+
+        @version = version
+        @payload = payload
+        @solution = {}
+        @records = payload
+      end
+
+      def process_response(response)
+        return response if response.status_code == 200
+
+        raise Twilio::REST::RestError.new('Unable to fetch page', response)
+      end
+
+      def get_key(payload)
+        return 'Resources' if payload['Resources']
+
+        return payload['meta']['key'] if payload['meta'] && payload['meta']['key']
+
+        keys = payload.keys
+        key = keys - META_KEYS
+        return key.first if key.size == 1
+
+        raise Twilio::REST::TwilioError, 'Page Records can not be deserialized'
+      end
+
+      def previous_page_url
+        # rubocop:disable Layout/LineLength
+        return @version.domain.absolute_url(URI.parse(@payload['meta']['previous_page_url']).request_uri) if @payload['meta'] && @payload['meta']['previous_page_url']
+        # rubocop:enable Layout/LineLength
+        return @version.domain.absolute_url(@payload['previous_page_uri']) if @payload['previous_page_uri']
+
+        nil
+      end
+
+      def next_page_url
+        # rubocop:disable Layout/LineLength
+        return @version.domain.absolute_url(URI.parse(@payload.body['meta']['next_page_url']).request_uri) if @payload.body['meta'] && @payload.body['meta']['next_page_url']
+        # rubocop:enable Layout/LineLength
+        return @version.domain.absolute_url(@payload.body['next_page_uri']) if @payload.body['next_page_uri']
+
+        nil
+      end
+
+      def previous_page
+        return nil unless previous_page_url
+
+        @version.domain.request('GET', previous_page_url)
+      end
+
+      def next_page
+        return nil unless next_page_url
+
+        @version.domain.request('GET', next_page_url)
+      end
+
+      def to_s
+        '#<PageMetadata>'
+      end
+    end
+  end
+end

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

@@ -19,5 +19,21 @@ module Twilio
         @version = version
       end
     end
+
+    class InstanceResourceMetadata
+      def initialize(payload, headers, status_code)
+        @payload = payload
+        @headers = headers
+        @status_code = status_code
+      end
+    end
+
+    class InstanceListResource
+      def initialize(version, headers, status_code)
+        @version = version
+        @headers = headers
+        @status_code = status_code
+      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
@@ -48,7 +48,7 @@ module Twilio
 
       def request(method, uri, params = {}, data = {}, headers = {}, auth = nil, timeout = nil)
         url = relative_uri(uri)
-        params = params.delete_if { |_k, v| v.nil? }
+        params.delete_if { |_k, v| v.nil? }
         data = data
         @domain.request(method, url, params, data, headers, auth, timeout)
       end
@@ -157,6 +157,10 @@ module Twilio
         RecordStream.new(page, limit: limit, page_limit: page_limit)
       end
 
+      def stream_with_metadata(page, limit: nil, page_limit: nil)
+        RecordStream.new(page, limit: limit, page_limit: page_limit)
+      end
+
       def create(method, uri, params: {}, data: {}, headers: {}, auth: nil, timeout: nil)
         response = request(method, uri, params, data, headers, auth, timeout)
 
@@ -166,6 +170,71 @@ module Twilio
 
         response.body
       end
+
+      def create_with_metadata(method, uri, params: {}, data: {}, headers: {}, auth: nil, timeout: nil)
+        response = request(method, uri, params, data, headers, auth, timeout)
+
+        if response.status_code < 200 || response.status_code >= 300
+          raise exception(response, 'Unable to create record')
+        end
+
+        response
+      end
+
+      def fetch_with_metadata(method, uri, params: {}, data: {}, headers: {}, auth: nil, timeout: nil)
+        response = request(
+          method,
+          uri,
+          params,
+          data,
+          headers,
+          auth,
+          timeout
+        )
+
+        # Note that 3XX response codes are allowed for fetches.
+        if response.status_code < 200 || response.status_code >= 400
+          raise exception(response, 'Unable to fetch record')
+        end
+
+        response
+      end
+
+      def update_with_metadata(method, uri, params: {}, data: {}, headers: {}, auth: nil, timeout: nil)
+        response = request(
+          method,
+          uri,
+          params,
+          data,
+          headers,
+          auth,
+          timeout
+        )
+
+        if response.status_code < 200 || response.status_code >= 300
+          raise exception(response, 'Unable to update record')
+        end
+
+        response
+      end
+
+      def delete_with_metadata(method, uri, params: {}, data: {}, headers: {}, auth: nil, timeout: nil)
+        response = request(
+          method,
+          uri,
+          params,
+          data,
+          headers,
+          auth,
+          timeout
+        )
+
+        if response.status_code < 200 || response.status_code >= 400
+          raise exception(response, 'Unable to delete record')
+        end
+
+        response
+      end
     end
   end
 end

data/lib/twilio-ruby/rest/accounts/v1/auth_token_promotion.rb

@@ -25,6 +25,7 @@ module Twilio
                     # @return [AuthTokenPromotionList] AuthTokenPromotionList
                     def initialize(version)
                         super(version)
+                        
                         # Path Solution
                         @solution = {  }
                         
@@ -47,6 +48,7 @@ module Twilio
                     # @return [AuthTokenPromotionContext] AuthTokenPromotionContext
                     def initialize(version)
                         super(version)
+                        
 
                         # Path Solution
                         @solution = {  }
@@ -72,6 +74,30 @@ module Twilio
                         )
                     end
 
+                    ##
+                    # Update the AuthTokenPromotionInstanceMetadata
+                    # @return [AuthTokenPromotionInstance] Updated AuthTokenPromotionInstance
+                    def update_with_metadata
+
+                        headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
+                        
+                        
+                        
+                        
+                        
+                        response = @version.update_with_metadata('POST', @uri, headers: headers)
+                        auth_token_promotion_instance = AuthTokenPromotionInstance.new(
+                            @version,
+                            response.body,
+                        )
+                        AuthTokenPromotionInstanceMetadata.new(
+                            @version,
+                            auth_token_promotion_instance,
+                            response.headers,
+                            response.status_code
+                        )
+                    end
+
 
                     ##
                     # Provide a user friendly representation
@@ -88,6 +114,53 @@ module Twilio
                     end
                 end
 
+                class AuthTokenPromotionInstanceMetadata <  InstanceResourceMetadata
+                    ##
+                    # Initializes a new AuthTokenPromotionInstanceMetadata.
+                    # @param [Version] version Version that contains the resource
+                    # @param [}AuthTokenPromotionInstance] auth_token_promotion_instance The instance associated with the metadata.
+                    # @param [Hash] headers Header object with response headers.
+                    # @param [Integer] status_code The HTTP status code of the response.
+                    # @return [AuthTokenPromotionInstanceMetadata] The initialized instance with metadata.
+                    def initialize(version, auth_token_promotion_instance, headers, status_code)
+                        super(version, headers, status_code)
+                        @auth_token_promotion_instance = auth_token_promotion_instance
+                    end
+
+                    def auth_token_promotion
+                        @auth_token_promotion_instance
+                    end
+
+                    def headers
+                        @headers
+                    end
+
+                    def status_code
+                        @status_code
+                    end
+
+                    def to_s
+                      "<Twilio.Api.V2010.AuthTokenPromotionInstanceMetadata status=#{@status_code}>"
+                    end
+                end
+
+                class AuthTokenPromotionListResponse < InstanceListResource
+                    # @param [Array<AuthTokenPromotionInstance>] instance
+                    # @param [Hash{String => Object}] headers
+                    # @param [Integer] status_code
+                    def initialize(version, payload, key)
+                       @auth_token_promotion_instance = payload.body[key].map do |data|
+                        AuthTokenPromotionInstance.new(version, data)
+                       end
+                       @headers = payload.headers
+                       @status_code = payload.status_code
+                    end
+
+                      def auth_token_promotion_instance
+                          @instance
+                      end
+                  end
+
                 class AuthTokenPromotionPage < Page
                     ##
                     # Initialize the AuthTokenPromotionPage
@@ -97,6 +170,7 @@ module Twilio
                     # @return [AuthTokenPromotionPage] AuthTokenPromotionPage
                     def initialize(version, response, solution)
                         super(version, response)
+                        
 
                         # Path Solution
                         @solution = solution
@@ -116,6 +190,66 @@ module Twilio
                         '<Twilio.Accounts.V1.AuthTokenPromotionPage>'
                     end
                 end
+
+                class AuthTokenPromotionPageMetadata < PageMetadata
+                    attr_reader :auth_token_promotion_page
+
+                    def initialize(version, response, solution, limit)
+                        super(version, response)
+                        @auth_token_promotion_page = []
+                        @limit = limit
+                        key = get_key(response.body)
+                        records = 0
+                        while( limit != :unset && records < limit )
+                            @auth_token_promotion_page << AuthTokenPromotionListResponse.new(version, @payload, key, limit - records)
+                            @payload = self.next_page
+                            break unless @payload
+                            records += @payload.body[key].size
+                        end
+                        # Path Solution
+                        @solution = solution
+                    end
+
+                    def each
+                        @auth_token_promotion_page.each do |record|
+                          yield record
+                        end
+                    end
+
+                    def to_s
+                      '<Twilio::REST::Accounts::V1PageMetadata>';
+                    end
+                end
+                class AuthTokenPromotionListResponse < InstanceListResource
+
+                    # @param [Array<AuthTokenPromotionInstance>] instance
+                    # @param [Hash{String => Object}] headers
+                    # @param [Integer] status_code
+                    def initialize(version, payload, key, limit = :unset)
+                      data_list = payload.body[key]
+                      if limit != :unset
+                        data_list = data_list[0, limit]
+                      end
+                      @auth_token_promotion = data_list.map do |data|
+                        AuthTokenPromotionInstance.new(version, data)
+                      end
+                      @headers = payload.headers
+                      @status_code = payload.status_code
+                    end
+
+                    def auth_token_promotion
+                        @auth_token_promotion
+                    end
+
+                    def headers
+                      @headers
+                    end
+
+                    def status_code
+                      @status_code
+                    end
+                end
+
                 class AuthTokenPromotionInstance < InstanceResource
                     ##
                     # Initialize the AuthTokenPromotionInstance
@@ -129,6 +263,7 @@ module Twilio
                     def initialize(version, payload )
                         super(version)
                         
+                        
                         # Marshaled Properties
                         @properties = { 
                             'account_sid' => payload['account_sid'],