twilio-ruby 5.45.0 → 5.60.0

data/lib/twilio-ruby/rest/pricing/v2.rb

@@ -15,9 +15,46 @@ module Twilio
         def initialize(domain)
           super
           @version = 'v2'
+          @countries = nil
+          @numbers = nil
           @voice = nil
         end
 
+        ##
+        # @param [String] iso_country The {ISO country
+        #   code}[https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] of the origin-based
+        #   voice pricing information to fetch.
+        # @return [Twilio::REST::Pricing::V2::CountryContext] if iso_country was passed.
+        # @return [Twilio::REST::Pricing::V2::CountryList]
+        def countries(iso_country=:unset)
+          if iso_country.nil?
+              raise ArgumentError, 'iso_country cannot be nil'
+          end
+          if iso_country == :unset
+              @countries ||= CountryList.new self
+          else
+              CountryContext.new(self, iso_country)
+          end
+        end
+
+        ##
+        # @param [String] destination_number The destination phone number, in
+        #   {E.164}[https://www.twilio.com/docs/glossary/what-e164] format, for which to
+        #   fetch the origin-based voice pricing information. E.164 format consists of a +
+        #   followed by the country code and subscriber number.
+        # @return [Twilio::REST::Pricing::V2::NumberContext] if destination_number was passed.
+        # @return [Twilio::REST::Pricing::V2::NumberList]
+        def numbers(destination_number=:unset)
+          if destination_number.nil?
+              raise ArgumentError, 'destination_number cannot be nil'
+          end
+          if destination_number == :unset
+              @numbers ||= NumberList.new self
+          else
+              NumberContext.new(self, destination_number)
+          end
+        end
+
         ##
         # @return [Twilio::REST::Pricing::V2::VoiceContext]
         def voice

data/lib/twilio-ruby/rest/pricing.rb

@@ -53,6 +53,25 @@ module Twilio
         self.v2.voice()
       end
 
+      ##
+      # @param [String] iso_country The {ISO country
+      #   code}[https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2].
+      # @return [Twilio::REST::Pricing::V2::CountryInstance] if iso_country was passed.
+      # @return [Twilio::REST::Pricing::V2::CountryList]
+      def countries(iso_country=:unset)
+        self.v2.countries(iso_country)
+      end
+
+      ##
+      # @param [String] destination_number The destination phone number in
+      #   {E.164}[https://www.twilio.com/docs/glossary/what-e164] format, which consists
+      #   of a + followed by the country code and subscriber number.
+      # @return [Twilio::REST::Pricing::V2::NumberInstance] if destination_number was passed.
+      # @return [Twilio::REST::Pricing::V2::NumberList]
+      def numbers(destination_number=:unset)
+        self.v2.numbers(destination_number)
+      end
+
       ##
       # Provide a user friendly representation
       def to_s

data/lib/twilio-ruby/rest/proxy/v1/service/session/participant/message_interaction.rb

@@ -37,7 +37,7 @@ module Twilio
                 ##
                 # Create the MessageInteractionInstance
                 # @param [String] body The message to send to the participant
-                # @param [String] media_url Reserved. Not currently supported.
+                # @param [Array[String]] media_url Reserved. Not currently supported.
                 # @return [MessageInteractionInstance] Created MessageInteractionInstance
                 def create(body: :unset, media_url: :unset)
                   data = Twilio::Values.of({'Body' => body, 'MediaUrl' => Twilio.serialize_list(media_url) { |e| e }, })

data/lib/twilio-ruby/rest/proxy/v1/service/session/participant.rb

@@ -378,7 +378,7 @@ module Twilio
               end
 
               ##
-              # @return [String] The phone number of the Participant
+              # @return [String] The phone number or channel identifier of the Participant
               def identifier
                 @properties['identifier']
               end

data/lib/twilio-ruby/rest/proxy/v1/service/session.rb

@@ -125,7 +125,7 @@ module Twilio
             # @param [session.Status] status The initial status of the Session. Can be:
             #   `open`, `in-progress`, `closed`, `failed`, or `unknown`. The default is `open`
             #   on create.
-            # @param [Hash] participants The Participant objects to include in the new
+            # @param [Array[Hash]] participants The Participant objects to include in the new
             #   session.
             # @param [Boolean] fail_on_participant_conflict [Experimental] For accounts with
             #   the ProxyAllowParticipantConflict account flag, setting to true enables

data/lib/twilio-ruby/rest/proxy/v1.rb

@@ -25,11 +25,12 @@ module Twilio
         # @return [Twilio::REST::Proxy::V1::ServiceList]
         def services(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @services ||= ServiceList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @services ||= ServiceList.new self
           else
-            ServiceContext.new(self, sid)
+              ServiceContext.new(self, sid)
           end
         end
 

data/lib/twilio-ruby/rest/serverless/v1/service/build.rb

@@ -110,19 +110,22 @@ module Twilio
 
             ##
             # Create the BuildInstance
-            # @param [String] asset_versions The list of Asset Version resource SIDs to
+            # @param [Array[String]] asset_versions The list of Asset Version resource SIDs to
             #   include in the Build.
-            # @param [String] function_versions The list of the Function Version resource SIDs
-            #   to include in the Build.
+            # @param [Array[String]] function_versions The list of the Function Version
+            #   resource SIDs to include in the Build.
             # @param [String] dependencies A list of objects that describe the Dependencies
             #   included in the Build. Each object contains the `name` and `version` of the
             #   dependency.
+            # @param [String] runtime The Runtime version that will be used to run the Build
+            #   resource when it is deployed.
             # @return [BuildInstance] Created BuildInstance
-            def create(asset_versions: :unset, function_versions: :unset, dependencies: :unset)
+            def create(asset_versions: :unset, function_versions: :unset, dependencies: :unset, runtime: :unset)
               data = Twilio::Values.of({
                   'AssetVersions' => Twilio.serialize_list(asset_versions) { |e| e },
                   'FunctionVersions' => Twilio.serialize_list(function_versions) { |e| e },
                   'Dependencies' => dependencies,
+                  'Runtime' => runtime,
               })
 
               payload = @version.create('POST', @uri, data: data)
@@ -251,6 +254,7 @@ module Twilio
                   'asset_versions' => payload['asset_versions'],
                   'function_versions' => payload['function_versions'],
                   'dependencies' => payload['dependencies'],
+                  'runtime' => payload['runtime'],
                   'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
                   'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
                   'url' => payload['url'],
@@ -298,23 +302,29 @@ module Twilio
             end
 
             ##
-            # @return [Hash] The list of Asset Version resource SIDs that are included in the Build
+            # @return [Array[Hash]] The list of Asset Version resource SIDs that are included in the Build
             def asset_versions
               @properties['asset_versions']
             end
 
             ##
-            # @return [Hash] The list of Function Version resource SIDs that are included in the Build
+            # @return [Array[Hash]] The list of Function Version resource SIDs that are included in the Build
             def function_versions
               @properties['function_versions']
             end
 
             ##
-            # @return [Hash] A list of objects that describe the Dependencies included in the Build
+            # @return [Array[Hash]] A list of objects that describe the Dependencies included in the Build
             def dependencies
               @properties['dependencies']
             end
 
+            ##
+            # @return [build.Runtime] The Runtime version that will be used to run the Build.
+            def runtime
+              @properties['runtime']
+            end
+
             ##
             # @return [Time] The ISO 8601 date and time in GMT when the Build resource was created
             def date_created

data/lib/twilio-ruby/rest/serverless/v1/service/environment.rb

@@ -369,7 +369,7 @@ module Twilio
             end
 
             ##
-            # @return [String] The base domain name for all Functions and Assets deployed in the Environment
+            # @return [String] The domain name for all Functions and Assets deployed in the Environment
             def domain_name
               @properties['domain_name']
             end

data/lib/twilio-ruby/rest/serverless/v1/service.rb

@@ -335,6 +335,7 @@ module Twilio
                 'unique_name' => payload['unique_name'],
                 'include_credentials' => payload['include_credentials'],
                 'ui_editable' => payload['ui_editable'],
+                'domain_base' => payload['domain_base'],
                 'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
                 'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
                 'url' => payload['url'],
@@ -393,6 +394,12 @@ module Twilio
             @properties['ui_editable']
           end
 
+          ##
+          # @return [String] The base domain name for this Service, which is a combination of the unique name and a randomly generated string
+          def domain_base
+            @properties['domain_base']
+          end
+
           ##
           # @return [Time] The ISO 8601 date and time in GMT when the Service resource was created
           def date_created

data/lib/twilio-ruby/rest/serverless/v1.rb

@@ -24,11 +24,12 @@ module Twilio
         # @return [Twilio::REST::Serverless::V1::ServiceList]
         def services(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @services ||= ServiceList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @services ||= ServiceList.new self
           else
-            ServiceContext.new(self, sid)
+              ServiceContext.new(self, sid)
           end
         end
 

data/lib/twilio-ruby/rest/studio/v1/flow/execution.rb

@@ -140,7 +140,7 @@ module Twilio
             #   available as variable `{{contact.channel.address}}`.
             # @param [String] from The Twilio phone number to send messages or initiate calls
             #   from during the Flow's Execution. Available as variable
-            #   `{{flow.channel.address}}`.
+            #   `{{flow.channel.address}}`. For SMS, this can also be a Messaging Service SID.
             # @param [Hash] parameters JSON data that will be added to the Flow's context and
             #   that can be accessed as variables inside your Flow. For example, if you pass in
             #   `Parameters={"name":"Zeke"}`, a widget in your Flow can reference the variable

data/lib/twilio-ruby/rest/studio/v1.rb

@@ -24,11 +24,12 @@ module Twilio
         # @return [Twilio::REST::Studio::V1::FlowList]
         def flows(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @flows ||= FlowList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @flows ||= FlowList.new self
           else
-            FlowContext.new(self, sid)
+              FlowContext.new(self, sid)
           end
         end
 

data/lib/twilio-ruby/rest/studio/v2/flow/execution/execution_context.rb

@@ -12,8 +12,6 @@ module Twilio
       class V2 < Version
         class FlowContext < InstanceContext
           class ExecutionContext < InstanceContext
-            ##
-            # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
             class ExecutionContextList < ListResource
               ##
               # Initialize the ExecutionContextList
@@ -35,8 +33,6 @@ module Twilio
               end
             end
 
-            ##
-            # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
             class ExecutionContextPage < Page
               ##
               # Initialize the ExecutionContextPage
@@ -71,8 +67,6 @@ module Twilio
               end
             end
 
-            ##
-            # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
             class ExecutionContextContext < InstanceContext
               ##
               # Initialize the ExecutionContextContext
@@ -118,8 +112,6 @@ module Twilio
               end
             end
 
-            ##
-            # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
             class ExecutionContextInstance < InstanceResource
               ##
               # Initialize the ExecutionContextInstance

data/lib/twilio-ruby/rest/studio/v2/flow/execution/execution_step/execution_step_context.rb

@@ -13,8 +13,6 @@ module Twilio
         class FlowContext < InstanceContext
           class ExecutionContext < InstanceContext
             class ExecutionStepContext < InstanceContext
-              ##
-              # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
               class ExecutionStepContextList < ListResource
                 ##
                 # Initialize the ExecutionStepContextList
@@ -38,8 +36,6 @@ module Twilio
                 end
               end
 
-              ##
-              # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
               class ExecutionStepContextPage < Page
                 ##
                 # Initialize the ExecutionStepContextPage
@@ -75,8 +71,6 @@ module Twilio
                 end
               end
 
-              ##
-              # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
               class ExecutionStepContextContext < InstanceContext
                 ##
                 # Initialize the ExecutionStepContextContext
@@ -124,8 +118,6 @@ module Twilio
                 end
               end
 
-              ##
-              # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
               class ExecutionStepContextInstance < InstanceResource
                 ##
                 # Initialize the ExecutionStepContextInstance

data/lib/twilio-ruby/rest/studio/v2/flow/execution/execution_step.rb

@@ -12,8 +12,6 @@ module Twilio
       class V2 < Version
         class FlowContext < InstanceContext
           class ExecutionContext < InstanceContext
-            ##
-            # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
             class ExecutionStepList < ListResource
               ##
               # Initialize the ExecutionStepList
@@ -116,8 +114,6 @@ module Twilio
               end
             end
 
-            ##
-            # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
             class ExecutionStepPage < Page
               ##
               # Initialize the ExecutionStepPage
@@ -152,8 +148,6 @@ module Twilio
               end
             end
 
-            ##
-            # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
             class ExecutionStepContext < InstanceContext
               ##
               # Initialize the ExecutionStepContext
@@ -217,8 +211,6 @@ module Twilio
               end
             end
 
-            ##
-            # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
             class ExecutionStepInstance < InstanceResource
               ##
               # Initialize the ExecutionStepInstance

data/lib/twilio-ruby/rest/studio/v2/flow/execution.rb

@@ -11,8 +11,6 @@ module Twilio
     class Studio < Domain
       class V2 < Version
         class FlowContext < InstanceContext
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class ExecutionList < ListResource
             ##
             # Initialize the ExecutionList
@@ -142,7 +140,7 @@ module Twilio
             #   available as variable `{{contact.channel.address}}`.
             # @param [String] from The Twilio phone number to send messages or initiate calls
             #   from during the Flow's Execution. Available as variable
-            #   `{{flow.channel.address}}`.
+            #   `{{flow.channel.address}}`. For SMS, this can also be a Messaging Service SID.
             # @param [Hash] parameters JSON data that will be added to the Flow's context and
             #   that can be accessed as variables inside your Flow. For example, if you pass in
             #   `Parameters={"name":"Zeke"}`, a widget in your Flow can reference the variable
@@ -169,8 +167,6 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class ExecutionPage < Page
             ##
             # Initialize the ExecutionPage
@@ -200,8 +196,6 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class ExecutionContext < InstanceContext
             ##
             # Initialize the ExecutionContext
@@ -296,8 +290,6 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class ExecutionInstance < InstanceResource
             ##
             # Initialize the ExecutionInstance

data/lib/twilio-ruby/rest/studio/v2/flow/flow_revision.rb

@@ -11,8 +11,6 @@ module Twilio
     class Studio < Domain
       class V2 < Version
         class FlowContext < InstanceContext
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class FlowRevisionList < ListResource
             ##
             # Initialize the FlowRevisionList
@@ -115,8 +113,6 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class FlowRevisionPage < Page
             ##
             # Initialize the FlowRevisionPage
@@ -146,8 +142,6 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class FlowRevisionContext < InstanceContext
             ##
             # Initialize the FlowRevisionContext
@@ -188,8 +182,6 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class FlowRevisionInstance < InstanceResource
             ##
             # Initialize the FlowRevisionInstance
@@ -272,7 +264,7 @@ module Twilio
             end
 
             ##
-            # @return [String] Description on change made in the revision
+            # @return [String] Description of change made in the revision
             def commit_message
               @properties['commit_message']
             end
@@ -284,7 +276,7 @@ module Twilio
             end
 
             ##
-            # @return [Hash] List of error in the flow definition
+            # @return [Array[Hash]] List of error in the flow definition
             def errors
               @properties['errors']
             end

data/lib/twilio-ruby/rest/studio/v2/flow/test_user.rb

@@ -11,13 +11,11 @@ module Twilio
     class Studio < Domain
       class V2 < Version
         class FlowContext < InstanceContext
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class FlowTestUserList < ListResource
             ##
             # Initialize the FlowTestUserList
             # @param [Version] version Version that contains the resource
-            # @param [String] sid The sid
+            # @param [String] sid Unique identifier of the flow.
             # @return [FlowTestUserList] FlowTestUserList
             def initialize(version, sid: nil)
               super(version)
@@ -33,8 +31,6 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class FlowTestUserPage < Page
             ##
             # Initialize the FlowTestUserPage
@@ -64,13 +60,11 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class FlowTestUserContext < InstanceContext
             ##
             # Initialize the FlowTestUserContext
             # @param [Version] version Version that contains the resource
-            # @param [String] sid The sid
+            # @param [String] sid Unique identifier of the flow.
             # @return [FlowTestUserContext] FlowTestUserContext
             def initialize(version, sid)
               super(version)
@@ -91,7 +85,8 @@ module Twilio
 
             ##
             # Update the FlowTestUserInstance
-            # @param [String] test_users The test_users
+            # @param [Array[String]] test_users List of test user identities that can test
+            #   draft versions of the flow.
             # @return [FlowTestUserInstance] Updated FlowTestUserInstance
             def update(test_users: nil)
               data = Twilio::Values.of({'TestUsers' => Twilio.serialize_list(test_users) { |e| e }, })
@@ -116,14 +111,12 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class FlowTestUserInstance < InstanceResource
             ##
             # Initialize the FlowTestUserInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] sid The sid
+            # @param [String] sid Unique identifier of the flow.
             # @return [FlowTestUserInstance] FlowTestUserInstance
             def initialize(version, payload, sid: nil)
               super(version)
@@ -152,19 +145,19 @@ module Twilio
             end
 
             ##
-            # @return [String] The sid
+            # @return [String] Unique identifier of the flow.
             def sid
               @properties['sid']
             end
 
             ##
-            # @return [String] The test_users
+            # @return [Array[String]] List of test user identities that can test draft versions of the flow.
             def test_users
               @properties['test_users']
             end
 
             ##
-            # @return [String] The url
+            # @return [String] The URL of this resource.
             def url
               @properties['url']
             end
@@ -178,7 +171,8 @@ module Twilio
 
             ##
             # Update the FlowTestUserInstance
-            # @param [String] test_users The test_users
+            # @param [Array[String]] test_users List of test user identities that can test
+            #   draft versions of the flow.
             # @return [FlowTestUserInstance] Updated FlowTestUserInstance
             def update(test_users: nil)
               context.update(test_users: test_users, )

data/lib/twilio-ruby/rest/studio/v2/flow.rb

@@ -10,8 +10,6 @@ module Twilio
   module REST
     class Studio < Domain
       class V2 < Version
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class FlowList < ListResource
           ##
           # Initialize the FlowList
@@ -31,7 +29,7 @@ module Twilio
           # @param [flow.Status] status The status of the Flow. Can be: `draft` or
           #   `published`.
           # @param [Hash] definition JSON representation of flow definition.
-          # @param [String] commit_message Description on change made in the revision.
+          # @param [String] commit_message Description of change made in the revision.
           # @return [FlowInstance] Created FlowInstance
           def create(friendly_name: nil, status: nil, definition: nil, commit_message: :unset)
             data = Twilio::Values.of({
@@ -133,8 +131,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class FlowPage < Page
           ##
           # Initialize the FlowPage
@@ -164,8 +160,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class FlowContext < InstanceContext
           ##
           # Initialize the FlowContext
@@ -191,7 +185,7 @@ module Twilio
           #   `published`.
           # @param [String] friendly_name The string that you assigned to describe the Flow.
           # @param [Hash] definition JSON representation of flow definition.
-          # @param [String] commit_message Description on change made in the revision.
+          # @param [String] commit_message Description of change made in the revision.
           # @return [FlowInstance] Updated FlowInstance
           def update(status: nil, friendly_name: :unset, definition: :unset, commit_message: :unset)
             data = Twilio::Values.of({
@@ -281,8 +275,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class FlowInstance < InstanceResource
           ##
           # Initialize the FlowInstance
@@ -365,7 +357,7 @@ module Twilio
           end
 
           ##
-          # @return [String] Description on change made in the revision
+          # @return [String] Description of change made in the revision
           def commit_message
             @properties['commit_message']
           end
@@ -377,13 +369,13 @@ module Twilio
           end
 
           ##
-          # @return [Hash] List of error in the flow definition
+          # @return [Array[Hash]] List of error in the flow definition
           def errors
             @properties['errors']
           end
 
           ##
-          # @return [Hash] List of warnings in the flow definition
+          # @return [Array[Hash]] List of warnings in the flow definition
           def warnings
             @properties['warnings']
           end
@@ -424,7 +416,7 @@ module Twilio
           #   `published`.
           # @param [String] friendly_name The string that you assigned to describe the Flow.
           # @param [Hash] definition JSON representation of flow definition.
-          # @param [String] commit_message Description on change made in the revision.
+          # @param [String] commit_message Description of change made in the revision.
           # @return [FlowInstance] Updated FlowInstance
           def update(status: nil, friendly_name: :unset, definition: :unset, commit_message: :unset)
             context.update(