twilio-ruby 5.39.2 → 5.60.0

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
@@ -32,10 +30,10 @@ module Twilio
             # Unlike stream(), this operation is eager and will load `limit` records into
             # memory before returning.
             # @param [Time] date_created_from Only show Execution resources starting on or
-            #   after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time, given
+            #   after this {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] date-time, given
             #   as `YYYY-MM-DDThh:mm:ss-hh:mm`.
             # @param [Time] date_created_to Only show Execution resources starting before this
-            #   [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time, given as
+            #   {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] date-time, given as
             #   `YYYY-MM-DDThh:mm:ss-hh:mm`.
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit.  Default is no limit
@@ -58,10 +56,10 @@ module Twilio
             # This operation lazily loads records as efficiently as possible until the limit
             # is reached.
             # @param [Time] date_created_from Only show Execution resources starting on or
-            #   after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time, given
+            #   after this {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] date-time, given
             #   as `YYYY-MM-DDThh:mm:ss-hh:mm`.
             # @param [Time] date_created_to Only show Execution resources starting before this
-            #   [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time, given as
+            #   {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] date-time, given as
             #   `YYYY-MM-DDThh:mm:ss-hh:mm`.
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit. Default is no limit.
@@ -100,10 +98,10 @@ module Twilio
             # Retrieve a single page of ExecutionInstance records from the API.
             # Request is executed immediately.
             # @param [Time] date_created_from Only show Execution resources starting on or
-            #   after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time, given
+            #   after this {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] date-time, given
             #   as `YYYY-MM-DDThh:mm:ss-hh:mm`.
             # @param [Time] date_created_to Only show Execution resources starting before this
-            #   [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time, given as
+            #   {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] date-time, given as
             #   `YYYY-MM-DDThh:mm:ss-hh:mm`.
             # @param [String] page_token PageToken provided by the API
             # @param [Integer] page_number Page Number, this value is simply for client state
@@ -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(

data/lib/twilio-ruby/rest/studio/v2/flow_validate.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 FlowValidateList < ListResource
           ##
           # Initialize the FlowValidateList
@@ -27,10 +25,11 @@ module Twilio
 
           ##
           # Update the FlowValidateInstance
-          # @param [String] friendly_name The friendly_name
-          # @param [flow_validate.Status] status The status
-          # @param [Hash] definition The definition
-          # @param [String] commit_message The commit_message
+          # @param [String] friendly_name The string that you assigned to describe the Flow.
+          # @param [flow_validate.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 of change made in the revision.
           # @return [FlowValidateInstance] Updated FlowValidateInstance
           def update(friendly_name: nil, status: nil, definition: nil, commit_message: :unset)
             data = Twilio::Values.of({
@@ -52,8 +51,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class FlowValidatePage < Page
           ##
           # Initialize the FlowValidatePage
@@ -83,8 +80,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class FlowValidateInstance < InstanceResource
           ##
           # Initialize the FlowValidateInstance
@@ -99,7 +94,7 @@ module Twilio
           end
 
           ##
-          # @return [Boolean] The valid
+          # @return [Boolean] Boolean if the flow definition is valid
           def valid
             @properties['valid']
           end

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

@@ -25,11 +25,12 @@ module Twilio
         # @return [Twilio::REST::Studio::V2::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/supersim/v1/command.rb

@@ -11,7 +11,7 @@ module Twilio
     class Supersim < Domain
       class V1 < Version
         ##
-        # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class CommandList < ListResource
           ##
           # Initialize the CommandList
@@ -28,7 +28,7 @@ module Twilio
           ##
           # Create the CommandInstance
           # @param [String] sim The `sid` or `unique_name` of the
-          #   [SIM](https://www.twilio.com/docs/wireless/api/sim-resource) to send the Command
+          #   {SIM}[https://www.twilio.com/docs/wireless/api/sim-resource] to send the Command
           #   to.
           # @param [String] command The message body of the command.
           # @param [String] callback_method The HTTP method we should use to call
@@ -56,8 +56,8 @@ module Twilio
           # @param [String] sim The SID or unique name of the Sim that Command was sent to
           #   or from.
           # @param [command.Status] status The status of the Command. Can be: `queued`,
-          #   `sent`, `delivered`, `received` or `failed`. See the [Command Status
-          #   Values](https://www.twilio.com/docs/wireless/api/command-resource#status-values)
+          #   `sent`, `delivered`, `received` or `failed`. See the {Command Status
+          #   Values}[https://www.twilio.com/docs/wireless/api/command-resource#status-values]
           #   for a description of each.
           # @param [command.Direction] direction The direction of the Command. Can be
           #   `to_sim` or `from_sim`. The value of `to_sim` is synonymous with the term
@@ -87,8 +87,8 @@ module Twilio
           # @param [String] sim The SID or unique name of the Sim that Command was sent to
           #   or from.
           # @param [command.Status] status The status of the Command. Can be: `queued`,
-          #   `sent`, `delivered`, `received` or `failed`. See the [Command Status
-          #   Values](https://www.twilio.com/docs/wireless/api/command-resource#status-values)
+          #   `sent`, `delivered`, `received` or `failed`. See the {Command Status
+          #   Values}[https://www.twilio.com/docs/wireless/api/command-resource#status-values]
           #   for a description of each.
           # @param [command.Direction] direction The direction of the Command. Can be
           #   `to_sim` or `from_sim`. The value of `to_sim` is synonymous with the term
@@ -129,8 +129,8 @@ module Twilio
           # @param [String] sim The SID or unique name of the Sim that Command was sent to
           #   or from.
           # @param [command.Status] status The status of the Command. Can be: `queued`,
-          #   `sent`, `delivered`, `received` or `failed`. See the [Command Status
-          #   Values](https://www.twilio.com/docs/wireless/api/command-resource#status-values)
+          #   `sent`, `delivered`, `received` or `failed`. See the {Command Status
+          #   Values}[https://www.twilio.com/docs/wireless/api/command-resource#status-values]
           #   for a description of each.
           # @param [command.Direction] direction The direction of the Command. Can be
           #   `to_sim` or `from_sim`. The value of `to_sim` is synonymous with the term
@@ -176,7 +176,7 @@ module Twilio
         end
 
         ##
-        # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class CommandPage < Page
           ##
           # Initialize the CommandPage
@@ -207,7 +207,7 @@ module Twilio
         end
 
         ##
-        # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class CommandContext < InstanceContext
           ##
           # Initialize the CommandContext
@@ -247,7 +247,7 @@ module Twilio
         end
 
         ##
-        # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class CommandInstance < InstanceResource
           ##
           # Initialize the CommandInstance