twilio-ruby 5.50.0 → 5.54.1

data/lib/twilio-ruby/rest/messaging/v1/service/us_app_to_person_usecase.rb

@@ -0,0 +1,125 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Messaging < Domain
+      class V1 < Version
+        class ServiceContext < InstanceContext
+          ##
+          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+          class UsAppToPersonUsecaseList < ListResource
+            ##
+            # Initialize the UsAppToPersonUsecaseList
+            # @param [Version] version Version that contains the resource
+            # @param [String] messaging_service_sid The unique string that we created to
+            #   identify the Service resource.
+            # @return [UsAppToPersonUsecaseList] UsAppToPersonUsecaseList
+            def initialize(version, messaging_service_sid: nil)
+              super(version)
+
+              # Path Solution
+              @solution = {messaging_service_sid: messaging_service_sid}
+              @uri = "/Services/#{@solution[:messaging_service_sid]}/Compliance/Usa2p/Usecases"
+            end
+
+            ##
+            # Fetch the UsAppToPersonUsecaseInstance
+            # @return [UsAppToPersonUsecaseInstance] Fetched UsAppToPersonUsecaseInstance
+            def fetch
+              payload = @version.fetch('GET', @uri)
+
+              UsAppToPersonUsecaseInstance.new(
+                  @version,
+                  payload,
+                  messaging_service_sid: @solution[:messaging_service_sid],
+              )
+            end
+
+            ##
+            # Provide a user friendly representation
+            def to_s
+              '#<Twilio.Messaging.V1.UsAppToPersonUsecaseList>'
+            end
+          end
+
+          ##
+          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+          class UsAppToPersonUsecasePage < Page
+            ##
+            # Initialize the UsAppToPersonUsecasePage
+            # @param [Version] version Version that contains the resource
+            # @param [Response] response Response from the API
+            # @param [Hash] solution Path solution for the resource
+            # @return [UsAppToPersonUsecasePage] UsAppToPersonUsecasePage
+            def initialize(version, response, solution)
+              super(version, response)
+
+              # Path Solution
+              @solution = solution
+            end
+
+            ##
+            # Build an instance of UsAppToPersonUsecaseInstance
+            # @param [Hash] payload Payload response from the API
+            # @return [UsAppToPersonUsecaseInstance] UsAppToPersonUsecaseInstance
+            def get_instance(payload)
+              UsAppToPersonUsecaseInstance.new(
+                  @version,
+                  payload,
+                  messaging_service_sid: @solution[:messaging_service_sid],
+              )
+            end
+
+            ##
+            # Provide a user friendly representation
+            def to_s
+              '<Twilio.Messaging.V1.UsAppToPersonUsecasePage>'
+            end
+          end
+
+          ##
+          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+          class UsAppToPersonUsecaseInstance < InstanceResource
+            ##
+            # Initialize the UsAppToPersonUsecaseInstance
+            # @param [Version] version Version that contains the resource
+            # @param [Hash] payload payload that contains response from Twilio
+            # @param [String] messaging_service_sid The unique string that we created to
+            #   identify the Service resource.
+            # @return [UsAppToPersonUsecaseInstance] UsAppToPersonUsecaseInstance
+            def initialize(version, payload, messaging_service_sid: nil)
+              super(version)
+
+              # Marshaled Properties
+              @properties = {'us_app_to_person_usecases' => payload['us_app_to_person_usecases'], }
+            end
+
+            ##
+            # @return [Array[Hash]] Human readable A2P Use Case details
+            def us_app_to_person_usecases
+              @properties['us_app_to_person_usecases']
+            end
+
+            ##
+            # Provide a user friendly representation
+            def to_s
+              "<Twilio.Messaging.V1.UsAppToPersonUsecaseInstance>"
+            end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              "<Twilio.Messaging.V1.UsAppToPersonUsecaseInstance>"
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,111 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Messaging < Domain
+      class V1 < Version
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class UsecaseList < ListResource
+          ##
+          # Initialize the UsecaseList
+          # @param [Version] version Version that contains the resource
+          # @return [UsecaseList] UsecaseList
+          def initialize(version)
+            super(version)
+
+            # Path Solution
+            @solution = {}
+            @uri = "/Services/Usecases"
+          end
+
+          ##
+          # Fetch the UsecaseInstance
+          # @return [UsecaseInstance] Fetched UsecaseInstance
+          def fetch
+            payload = @version.fetch('GET', @uri)
+
+            UsecaseInstance.new(@version, payload, )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '#<Twilio.Messaging.V1.UsecaseList>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class UsecasePage < Page
+          ##
+          # Initialize the UsecasePage
+          # @param [Version] version Version that contains the resource
+          # @param [Response] response Response from the API
+          # @param [Hash] solution Path solution for the resource
+          # @return [UsecasePage] UsecasePage
+          def initialize(version, response, solution)
+            super(version, response)
+
+            # Path Solution
+            @solution = solution
+          end
+
+          ##
+          # Build an instance of UsecaseInstance
+          # @param [Hash] payload Payload response from the API
+          # @return [UsecaseInstance] UsecaseInstance
+          def get_instance(payload)
+            UsecaseInstance.new(@version, payload, )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '<Twilio.Messaging.V1.UsecasePage>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class UsecaseInstance < InstanceResource
+          ##
+          # Initialize the UsecaseInstance
+          # @param [Version] version Version that contains the resource
+          # @param [Hash] payload payload that contains response from Twilio
+          # @return [UsecaseInstance] UsecaseInstance
+          def initialize(version, payload)
+            super(version)
+
+            # Marshaled Properties
+            @properties = {'usecases' => payload['usecases'], }
+          end
+
+          ##
+          # @return [Array[Hash]] Human readable Messaging Service Use Case details
+          def usecases
+            @properties['usecases']
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            "<Twilio.Messaging.V1.UsecaseInstance>"
+          end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            "<Twilio.Messaging.V1.UsecaseInstance>"
+          end
+        end
+      end
+    end
+  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/v2/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/supersim/v1/sim.rb

@@ -25,6 +25,22 @@ module Twilio
             @uri = "/Sims"
           end
 
+          ##
+          # Create the SimInstance
+          # @param [String] iccid The
+          #   {ICCID}[https://en.wikipedia.org/wiki/Subscriber_identity_module#ICCID] of the
+          #   Super SIM to be added to your Account.
+          # @param [String] registration_code The 10-digit code required to claim the Super
+          #   SIM for your Account.
+          # @return [SimInstance] Created SimInstance
+          def create(iccid: nil, registration_code: nil)
+            data = Twilio::Values.of({'Iccid' => iccid, 'RegistrationCode' => registration_code, })
+
+            payload = @version.create('POST', @uri, data: data)
+
+            SimInstance.new(@version, payload, )
+          end
+
           ##
           # Lists SimInstance records from the API as a list.
           # Unlike stream(), this operation is eager and will load `limit` records into

data/lib/twilio-ruby/rest/supersim/v1/sms_command.rb

@@ -53,8 +53,8 @@ module Twilio
           # Lists SmsCommandInstance records from the API as a list.
           # Unlike stream(), this operation is eager and will load `limit` records into
           # memory before returning.
-          # @param [String] sim The SID or unique name of the Sim that SMS Command was sent
-          #   to or from.
+          # @param [String] sim The SID or unique name of the Sim resource that SMS Command
+          #   was sent to or from.
           # @param [sms_command.Status] status The status of the SMS Command. Can be:
           #   `queued`, `sent`, `delivered`, `received` or `failed`. See the {SMS Command
           #   Status
@@ -85,8 +85,8 @@ module Twilio
           # Streams SmsCommandInstance records from the API as an Enumerable.
           # This operation lazily loads records as efficiently as possible until the limit
           # is reached.
-          # @param [String] sim The SID or unique name of the Sim that SMS Command was sent
-          #   to or from.
+          # @param [String] sim The SID or unique name of the Sim resource that SMS Command
+          #   was sent to or from.
           # @param [sms_command.Status] status The status of the SMS Command. Can be:
           #   `queued`, `sent`, `delivered`, `received` or `failed`. See the {SMS Command
           #   Status
@@ -128,8 +128,8 @@ module Twilio
           ##
           # Retrieve a single page of SmsCommandInstance records from the API.
           # Request is executed immediately.
-          # @param [String] sim The SID or unique name of the Sim that SMS Command was sent
-          #   to or from.
+          # @param [String] sim The SID or unique name of the Sim resource that SMS Command
+          #   was sent to or from.
           # @param [sms_command.Status] status The status of the SMS Command. Can be:
           #   `queued`, `sent`, `delivered`, `received` or `failed`. See the {SMS Command
           #   Status

data/lib/twilio-ruby/rest/taskrouter/v1/workspace.rb

@@ -120,17 +120,16 @@ module Twilio
           #   collect data for reporting. See {Workspace
           #   Events}[https://www.twilio.com/docs/taskrouter/api/event] for more information.
           # @param [String] events_filter The list of Workspace events for which to call
-          #   event_callback_url. For example if
-          #   `EventsFilter=task.created,task.canceled,worker.activity.update`, then
-          #   TaskRouter will call event_callback_url only when a task is created, canceled,
-          #   or a Worker activity is updated.
+          #   event_callback_url. For example, if `EventsFilter=task.created, task.canceled,
+          #   worker.activity.update`, then TaskRouter will call event_callback_url only when
+          #   a task is created, canceled, or a Worker activity is updated.
           # @param [Boolean] multi_task_enabled Whether to enable multi-tasking. Can be:
           #   `true` to enable multi-tasking, or `false` to disable it. The default is
           #   `false`. Multi-tasking allows Workers to handle multiple Tasks simultaneously.
           #   When enabled (`true`), each Worker can receive parallel reservations up to the
           #   per-channel maximums defined in the Workers section. Otherwise, each Worker will
           #   only receive a new reservation when the previous task is completed. Learn more
-          #   at [Multitasking][https://www.twilio.com/docs/taskrouter/multitasking].
+          #   at {Multitasking}[https://www.twilio.com/docs/taskrouter/multitasking].
           # @param [String] template An available template name. Can be: `NONE` or `FIFO`
           #   and the default is `NONE`. Pre-configures the Workspace with the Workflow and
           #   Activities specified in the template. `NONE` will create a Workspace with only a
@@ -139,8 +138,8 @@ module Twilio
           #   which can be useful when you are getting started with TaskRouter.
           # @param [workspace.QueueOrder] prioritize_queue_order The type of TaskQueue to
           #   prioritize when Workers are receiving Tasks from both types of TaskQueues. Can
-          #   be: `LIFO` or `FIFO` and the default is `FIFO`. For more information, see [Queue
-          #   Ordering][https://www.twilio.com/docs/taskrouter/queue-ordering-last-first-out-lifo].
+          #   be: `LIFO` or `FIFO` and the default is `FIFO`. For more information, see {Queue
+          #   Ordering}[https://www.twilio.com/docs/taskrouter/queue-ordering-last-first-out-lifo].
           # @return [WorkspaceInstance] Created WorkspaceInstance
           def create(friendly_name: nil, event_callback_url: :unset, events_filter: :unset, multi_task_enabled: :unset, template: :unset, prioritize_queue_order: :unset)
             data = Twilio::Values.of({
@@ -249,13 +248,13 @@ module Twilio
           #   When enabled (`true`), each Worker can receive parallel reservations up to the
           #   per-channel maximums defined in the Workers section. Otherwise, each Worker will
           #   only receive a new reservation when the previous task is completed. Learn more
-          #   at [Multitasking][https://www.twilio.com/docs/taskrouter/multitasking].
+          #   at {Multitasking}[https://www.twilio.com/docs/taskrouter/multitasking].
           # @param [String] timeout_activity_sid The SID of the Activity that will be
           #   assigned to a Worker when a Task reservation times out without a response.
           # @param [workspace.QueueOrder] prioritize_queue_order The type of TaskQueue to
           #   prioritize when Workers are receiving Tasks from both types of TaskQueues. Can
-          #   be: `LIFO` or `FIFO` and the default is `FIFO`. For more information, see [Queue
-          #   Ordering][https://www.twilio.com/docs/taskrouter/queue-ordering-last-first-out-lifo].
+          #   be: `LIFO` or `FIFO` and the default is `FIFO`. For more information, see {Queue
+          #   Ordering}[https://www.twilio.com/docs/taskrouter/queue-ordering-last-first-out-lifo].
           # @return [WorkspaceInstance] Updated WorkspaceInstance
           def update(default_activity_sid: :unset, event_callback_url: :unset, events_filter: :unset, friendly_name: :unset, multi_task_enabled: :unset, timeout_activity_sid: :unset, prioritize_queue_order: :unset)
             data = Twilio::Values.of({
@@ -608,13 +607,13 @@ module Twilio
           #   When enabled (`true`), each Worker can receive parallel reservations up to the
           #   per-channel maximums defined in the Workers section. Otherwise, each Worker will
           #   only receive a new reservation when the previous task is completed. Learn more
-          #   at [Multitasking][https://www.twilio.com/docs/taskrouter/multitasking].
+          #   at {Multitasking}[https://www.twilio.com/docs/taskrouter/multitasking].
           # @param [String] timeout_activity_sid The SID of the Activity that will be
           #   assigned to a Worker when a Task reservation times out without a response.
           # @param [workspace.QueueOrder] prioritize_queue_order The type of TaskQueue to
           #   prioritize when Workers are receiving Tasks from both types of TaskQueues. Can
-          #   be: `LIFO` or `FIFO` and the default is `FIFO`. For more information, see [Queue
-          #   Ordering][https://www.twilio.com/docs/taskrouter/queue-ordering-last-first-out-lifo].
+          #   be: `LIFO` or `FIFO` and the default is `FIFO`. For more information, see {Queue
+          #   Ordering}[https://www.twilio.com/docs/taskrouter/queue-ordering-last-first-out-lifo].
           # @return [WorkspaceInstance] Updated WorkspaceInstance
           def update(default_activity_sid: :unset, event_callback_url: :unset, events_filter: :unset, friendly_name: :unset, multi_task_enabled: :unset, timeout_activity_sid: :unset, prioritize_queue_order: :unset)
             context.update(

data/lib/twilio-ruby/rest/taskrouter/v1/workspace/task.rb

@@ -337,7 +337,11 @@ module Twilio
             # @param [String] task_channel When MultiTasking is enabled, specify the
             #   TaskChannel with the task to update. Can be the TaskChannel's SID or its
             #   `unique_name`, such as `voice`, `sms`, or `default`.
-            # @param [String] if_match The If-Match HTTP request header
+            # @param [String] if_match If provided, applies this mutation if (and only if) the
+            #   {ETag}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/ETag] header of
+            #   the Task matches the provided value. This matches the semantics of (and is
+            #   implemented with) the HTTP {If-Match
+            #   header}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/If-Match].
             # @return [TaskInstance] Updated TaskInstance
             def update(attributes: :unset, assignment_status: :unset, reason: :unset, priority: :unset, task_channel: :unset, if_match: :unset)
               data = Twilio::Values.of({
@@ -356,9 +360,16 @@ module Twilio
 
             ##
             # Delete the TaskInstance
+            # @param [String] if_match If provided, deletes this Task if (and only if) the
+            #   {ETag}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/ETag] header of
+            #   the Task matches the provided value. This matches the semantics of (and is
+            #   implemented with) the HTTP {If-Match
+            #   header}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/If-Match].
             # @return [Boolean] true if delete succeeds, false otherwise
-            def delete
-               @version.delete('DELETE', @uri)
+            def delete(if_match: :unset)
+              headers = Twilio::Values.of({'If-Match' => if_match, })
+
+               @version.delete('DELETE', @uri, headers: headers)
             end
 
             ##
@@ -600,7 +611,11 @@ module Twilio
             # @param [String] task_channel When MultiTasking is enabled, specify the
             #   TaskChannel with the task to update. Can be the TaskChannel's SID or its
             #   `unique_name`, such as `voice`, `sms`, or `default`.
-            # @param [String] if_match The If-Match HTTP request header
+            # @param [String] if_match If provided, applies this mutation if (and only if) the
+            #   {ETag}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/ETag] header of
+            #   the Task matches the provided value. This matches the semantics of (and is
+            #   implemented with) the HTTP {If-Match
+            #   header}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/If-Match].
             # @return [TaskInstance] Updated TaskInstance
             def update(attributes: :unset, assignment_status: :unset, reason: :unset, priority: :unset, task_channel: :unset, if_match: :unset)
               context.update(
@@ -615,9 +630,14 @@ module Twilio
 
             ##
             # Delete the TaskInstance
+            # @param [String] if_match If provided, deletes this Task if (and only if) the
+            #   {ETag}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/ETag] header of
+            #   the Task matches the provided value. This matches the semantics of (and is
+            #   implemented with) the HTTP {If-Match
+            #   header}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/If-Match].
             # @return [Boolean] true if delete succeeds, false otherwise
-            def delete
-              context.delete
+            def delete(if_match: :unset)
+              context.delete(if_match: if_match, )
             end
 
             ##

data/lib/twilio-ruby/rest/verify/v2/service.rb

@@ -60,8 +60,21 @@ module Twilio
           #   factors. Set the FCM Credential for this service. This will allow to send push
           #   notifications to Android devices. See {Credential
           #   Resource}[https://www.twilio.com/docs/notify/api/credential-resource]
+          # @param [String] totp_issuer Optional configuration for the TOTP factors. Set
+          #   TOTP Issuer for this service. This will allow to configure the issuer of the
+          #   TOTP URI. Defaults to the service friendly name if not provided.
+          # @param [String] totp_time_step Optional configuration for the TOTP factors.
+          #   Defines how often, in seconds, are TOTP codes generated. i.e, a new TOTP code is
+          #   generated every time_step seconds. Must be between 20 and 60 seconds, inclusive.
+          #   Defaults to 30 seconds
+          # @param [String] totp_code_length Optional configuration for the TOTP factors.
+          #   Number of digits for generated TOTP codes. Must be between 3 and 8, inclusive.
+          #   Defaults to 6
+          # @param [String] totp_skew Optional configuration for the TOTP factors. The
+          #   number of time-steps, past and future, that are valid for validation of TOTP
+          #   codes. Must be between 0 and 2, inclusive. Defaults to 1
           # @return [ServiceInstance] Created ServiceInstance
-          def create(friendly_name: nil, code_length: :unset, lookup_enabled: :unset, skip_sms_to_landlines: :unset, dtmf_input_required: :unset, tts_name: :unset, psd2_enabled: :unset, do_not_share_warning_enabled: :unset, custom_code_enabled: :unset, push_include_date: :unset, push_apn_credential_sid: :unset, push_fcm_credential_sid: :unset)
+          def create(friendly_name: nil, code_length: :unset, lookup_enabled: :unset, skip_sms_to_landlines: :unset, dtmf_input_required: :unset, tts_name: :unset, psd2_enabled: :unset, do_not_share_warning_enabled: :unset, custom_code_enabled: :unset, push_include_date: :unset, push_apn_credential_sid: :unset, push_fcm_credential_sid: :unset, totp_issuer: :unset, totp_time_step: :unset, totp_code_length: :unset, totp_skew: :unset)
             data = Twilio::Values.of({
                 'FriendlyName' => friendly_name,
                 'CodeLength' => code_length,
@@ -75,6 +88,10 @@ module Twilio
                 'Push.IncludeDate' => push_include_date,
                 'Push.ApnCredentialSid' => push_apn_credential_sid,
                 'Push.FcmCredentialSid' => push_fcm_credential_sid,
+                'Totp.Issuer' => totp_issuer,
+                'Totp.TimeStep' => totp_time_step,
+                'Totp.CodeLength' => totp_code_length,
+                'Totp.Skew' => totp_skew,
             })
 
             payload = @version.create('POST', @uri, data: data)
@@ -273,8 +290,21 @@ module Twilio
           #   factors. Set the FCM Credential for this service. This will allow to send push
           #   notifications to Android devices. See {Credential
           #   Resource}[https://www.twilio.com/docs/notify/api/credential-resource]
+          # @param [String] totp_issuer Optional configuration for the TOTP factors. Set
+          #   TOTP Issuer for this service. This will allow to configure the issuer of the
+          #   TOTP URI.
+          # @param [String] totp_time_step Optional configuration for the TOTP factors.
+          #   Defines how often, in seconds, are TOTP codes generated. i.e, a new TOTP code is
+          #   generated every time_step seconds. Must be between 20 and 60 seconds, inclusive.
+          #   Defaults to 30 seconds
+          # @param [String] totp_code_length Optional configuration for the TOTP factors.
+          #   Number of digits for generated TOTP codes. Must be between 3 and 8, inclusive.
+          #   Defaults to 6
+          # @param [String] totp_skew Optional configuration for the TOTP factors. The
+          #   number of time-steps, past and future, that are valid for validation of TOTP
+          #   codes. Must be between 0 and 2, inclusive. Defaults to 1
           # @return [ServiceInstance] Updated ServiceInstance
-          def update(friendly_name: :unset, code_length: :unset, lookup_enabled: :unset, skip_sms_to_landlines: :unset, dtmf_input_required: :unset, tts_name: :unset, psd2_enabled: :unset, do_not_share_warning_enabled: :unset, custom_code_enabled: :unset, push_include_date: :unset, push_apn_credential_sid: :unset, push_fcm_credential_sid: :unset)
+          def update(friendly_name: :unset, code_length: :unset, lookup_enabled: :unset, skip_sms_to_landlines: :unset, dtmf_input_required: :unset, tts_name: :unset, psd2_enabled: :unset, do_not_share_warning_enabled: :unset, custom_code_enabled: :unset, push_include_date: :unset, push_apn_credential_sid: :unset, push_fcm_credential_sid: :unset, totp_issuer: :unset, totp_time_step: :unset, totp_code_length: :unset, totp_skew: :unset)
             data = Twilio::Values.of({
                 'FriendlyName' => friendly_name,
                 'CodeLength' => code_length,
@@ -288,6 +318,10 @@ module Twilio
                 'Push.IncludeDate' => push_include_date,
                 'Push.ApnCredentialSid' => push_apn_credential_sid,
                 'Push.FcmCredentialSid' => push_fcm_credential_sid,
+                'Totp.Issuer' => totp_issuer,
+                'Totp.TimeStep' => totp_time_step,
+                'Totp.CodeLength' => totp_code_length,
+                'Totp.Skew' => totp_skew,
             })
 
             payload = @version.update('POST', @uri, data: data)
@@ -449,6 +483,7 @@ module Twilio
                 'do_not_share_warning_enabled' => payload['do_not_share_warning_enabled'],
                 'custom_code_enabled' => payload['custom_code_enabled'],
                 'push' => payload['push'],
+                'totp' => payload['totp'],
                 'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
                 'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
                 'url' => payload['url'],
@@ -543,6 +578,12 @@ module Twilio
             @properties['push']
           end
 
+          ##
+          # @return [Hash] The service level configuration of factor TOTP type.
+          def totp
+            @properties['totp']
+          end
+
           ##
           # @return [Time] The RFC 2822 date and time in GMT when the resource was created
           def date_created
@@ -616,8 +657,21 @@ module Twilio
           #   factors. Set the FCM Credential for this service. This will allow to send push
           #   notifications to Android devices. See {Credential
           #   Resource}[https://www.twilio.com/docs/notify/api/credential-resource]
+          # @param [String] totp_issuer Optional configuration for the TOTP factors. Set
+          #   TOTP Issuer for this service. This will allow to configure the issuer of the
+          #   TOTP URI.
+          # @param [String] totp_time_step Optional configuration for the TOTP factors.
+          #   Defines how often, in seconds, are TOTP codes generated. i.e, a new TOTP code is
+          #   generated every time_step seconds. Must be between 20 and 60 seconds, inclusive.
+          #   Defaults to 30 seconds
+          # @param [String] totp_code_length Optional configuration for the TOTP factors.
+          #   Number of digits for generated TOTP codes. Must be between 3 and 8, inclusive.
+          #   Defaults to 6
+          # @param [String] totp_skew Optional configuration for the TOTP factors. The
+          #   number of time-steps, past and future, that are valid for validation of TOTP
+          #   codes. Must be between 0 and 2, inclusive. Defaults to 1
           # @return [ServiceInstance] Updated ServiceInstance
-          def update(friendly_name: :unset, code_length: :unset, lookup_enabled: :unset, skip_sms_to_landlines: :unset, dtmf_input_required: :unset, tts_name: :unset, psd2_enabled: :unset, do_not_share_warning_enabled: :unset, custom_code_enabled: :unset, push_include_date: :unset, push_apn_credential_sid: :unset, push_fcm_credential_sid: :unset)
+          def update(friendly_name: :unset, code_length: :unset, lookup_enabled: :unset, skip_sms_to_landlines: :unset, dtmf_input_required: :unset, tts_name: :unset, psd2_enabled: :unset, do_not_share_warning_enabled: :unset, custom_code_enabled: :unset, push_include_date: :unset, push_apn_credential_sid: :unset, push_fcm_credential_sid: :unset, totp_issuer: :unset, totp_time_step: :unset, totp_code_length: :unset, totp_skew: :unset)
             context.update(
                 friendly_name: friendly_name,
                 code_length: code_length,
@@ -631,6 +685,10 @@ module Twilio
                 push_include_date: push_include_date,
                 push_apn_credential_sid: push_apn_credential_sid,
                 push_fcm_credential_sid: push_fcm_credential_sid,
+                totp_issuer: totp_issuer,
+                totp_time_step: totp_time_step,
+                totp_code_length: totp_code_length,
+                totp_skew: totp_skew,
             )
           end