twilio-ruby 5.57.0 → 5.58.2

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/taskrouter/v1/workspace/activity.rb

@@ -282,6 +282,7 @@ module Twilio
                   'sid' => payload['sid'],
                   'workspace_sid' => payload['workspace_sid'],
                   'url' => payload['url'],
+                  'links' => payload['links'],
               }
 
               # Context
@@ -348,6 +349,12 @@ module Twilio
               @properties['url']
             end
 
+            ##
+            # @return [String] The links
+            def links
+              @properties['links']
+            end
+
             ##
             # Fetch the ActivityInstance
             # @return [ActivityInstance] Fetched ActivityInstance

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

@@ -124,12 +124,14 @@ module Twilio
           #   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].
+          #   `true` to enable multi-tasking, or `false` to disable it. However, all
+          #   workspaces should be created as multi-tasking. The default is `true`.
+          #   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. In single-tasking mode
+          #   (legacy mode), 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].
           # @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
@@ -243,17 +245,21 @@ module Twilio
           #   the Workspace resource. For example: `Sales Call Center` or `Customer Support
           #   Team`.
           # @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].
+          #   `true` to enable multi-tasking, or `false` to disable it. However, all
+          #   workspaces should be maintained as multi-tasking. There is no default when
+          #   omitting this parameter. A multi-tasking Workspace can't be updated to
+          #   single-tasking unless it is not a Flex Project and another (legacy)
+          #   single-tasking Workspace exists. Multi-tasking allows Workers to handle multiple
+          #   Tasks simultaneously. In multi-tasking mode, each Worker can receive parallel
+          #   reservations up to the per-channel maximums defined in the Workers section. In
+          #   single-tasking mode (legacy mode), 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].
           # @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
+          #   be: `LIFO` or `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)
@@ -602,17 +608,21 @@ module Twilio
           #   the Workspace resource. For example: `Sales Call Center` or `Customer Support
           #   Team`.
           # @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].
+          #   `true` to enable multi-tasking, or `false` to disable it. However, all
+          #   workspaces should be maintained as multi-tasking. There is no default when
+          #   omitting this parameter. A multi-tasking Workspace can't be updated to
+          #   single-tasking unless it is not a Flex Project and another (legacy)
+          #   single-tasking Workspace exists. Multi-tasking allows Workers to handle multiple
+          #   Tasks simultaneously. In multi-tasking mode, each Worker can receive parallel
+          #   reservations up to the per-channel maximums defined in the Workers section. In
+          #   single-tasking mode (legacy mode), 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].
           # @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
+          #   be: `LIFO` or `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/lib/twilio-ruby/rest/verify/v2/service/entity/challenge/notification.rb

@@ -21,7 +21,9 @@ module Twilio
                 # @param [Version] version Version that contains the resource
                 # @param [String] service_sid The unique SID identifier of the Service.
                 # @param [String] identity Customer unique identity for the Entity owner of the
-                #   Challenge. This value must be between 8 and 64 characters long.
+                #   Challenge. This identifier should be immutable, not PII, length between 8 and 64
+                #   characters, and generated by your external system, such as your user's UUID,
+                #   GUID, or SID. It can only contain dash (-) separated alphanumeric characters.
                 # @param [String] challenge_sid The unique SID identifier of the Challenge.
                 # @return [NotificationList] NotificationList
                 def initialize(version, service_sid: nil, identity: nil, challenge_sid: nil)
@@ -106,7 +108,9 @@ module Twilio
                 # @param [Hash] payload payload that contains response from Twilio
                 # @param [String] service_sid The unique SID identifier of the Service.
                 # @param [String] identity Customer unique identity for the Entity owner of the
-                #   Challenge. This value must be between 8 and 64 characters long.
+                #   Challenge. This identifier should be immutable, not PII, length between 8 and 64
+                #   characters, and generated by your external system, such as your user's UUID,
+                #   GUID, or SID. It can only contain dash (-) separated alphanumeric characters.
                 # @param [String] challenge_sid The unique SID identifier of the Challenge.
                 # @return [NotificationInstance] NotificationInstance
                 def initialize(version, payload, service_sid: nil, identity: nil, challenge_sid: nil)

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

@@ -20,7 +20,9 @@ module Twilio
               # @param [Version] version Version that contains the resource
               # @param [String] service_sid The unique SID identifier of the Service.
               # @param [String] identity Customer unique identity for the Entity owner of the
-              #   Challenge. This value must be between 8 and 64 characters long.
+              #   Challenge. This identifier should be immutable, not PII, length between 8 and 64
+              #   characters, and generated by your external system, such as your user's UUID,
+              #   GUID, or SID. It can only contain dash (-) separated alphanumeric characters.
               # @return [ChallengeList] ChallengeList
               def initialize(version, service_sid: nil, identity: nil)
                 super(version)
@@ -81,6 +83,9 @@ module Twilio
               # @param [String] factor_sid The unique SID identifier of the Factor.
               # @param [challenge.ChallengeStatuses] status The Status of the Challenges to
               #   fetch. One of `pending`, `expired`, `approved` or `denied`.
+              # @param [challenge.ListOrders] order The desired sort order of the Challenges
+              #   list. One of `asc` or `desc` for ascending and descending respectively. Defaults
+              #   to `asc`.
               # @param [Integer] limit Upper limit for the number of records to return. stream()
               #    guarantees to never return more than limit.  Default is no limit
               # @param [Integer] page_size Number of records to fetch per request, when
@@ -88,8 +93,14 @@ module Twilio
               #    but a limit is defined, stream() will attempt to read the limit with the most
               #    efficient page size, i.e. min(limit, 1000)
               # @return [Array] Array of up to limit results
-              def list(factor_sid: :unset, status: :unset, limit: nil, page_size: nil)
-                self.stream(factor_sid: factor_sid, status: status, limit: limit, page_size: page_size).entries
+              def list(factor_sid: :unset, status: :unset, order: :unset, limit: nil, page_size: nil)
+                self.stream(
+                    factor_sid: factor_sid,
+                    status: status,
+                    order: order,
+                    limit: limit,
+                    page_size: page_size
+                ).entries
               end
 
               ##
@@ -99,6 +110,9 @@ module Twilio
               # @param [String] factor_sid The unique SID identifier of the Factor.
               # @param [challenge.ChallengeStatuses] status The Status of the Challenges to
               #   fetch. One of `pending`, `expired`, `approved` or `denied`.
+              # @param [challenge.ListOrders] order The desired sort order of the Challenges
+              #   list. One of `asc` or `desc` for ascending and descending respectively. Defaults
+              #   to `asc`.
               # @param [Integer] limit Upper limit for the number of records to return. stream()
               #    guarantees to never return more than limit. Default is no limit.
               # @param [Integer] page_size Number of records to fetch per request, when
@@ -106,10 +120,15 @@ module Twilio
               #    but a limit is defined, stream() will attempt to read the limit with the most
               #    efficient page size, i.e. min(limit, 1000)
               # @return [Enumerable] Enumerable that will yield up to limit results
-              def stream(factor_sid: :unset, status: :unset, limit: nil, page_size: nil)
+              def stream(factor_sid: :unset, status: :unset, order: :unset, limit: nil, page_size: nil)
                 limits = @version.read_limits(limit, page_size)
 
-                page = self.page(factor_sid: factor_sid, status: status, page_size: limits[:page_size], )
+                page = self.page(
+                    factor_sid: factor_sid,
+                    status: status,
+                    order: order,
+                    page_size: limits[:page_size],
+                )
 
                 @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
               end
@@ -134,14 +153,18 @@ module Twilio
               # @param [String] factor_sid The unique SID identifier of the Factor.
               # @param [challenge.ChallengeStatuses] status The Status of the Challenges to
               #   fetch. One of `pending`, `expired`, `approved` or `denied`.
+              # @param [challenge.ListOrders] order The desired sort order of the Challenges
+              #   list. One of `asc` or `desc` for ascending and descending respectively. Defaults
+              #   to `asc`.
               # @param [String] page_token PageToken provided by the API
               # @param [Integer] page_number Page Number, this value is simply for client state
               # @param [Integer] page_size Number of records to return, defaults to 50
               # @return [Page] Page of ChallengeInstance
-              def page(factor_sid: :unset, status: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
+              def page(factor_sid: :unset, status: :unset, order: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
                 params = Twilio::Values.of({
                     'FactorSid' => factor_sid,
                     'Status' => status,
+                    'Order' => order,
                     'PageToken' => page_token,
                     'Page' => page_number,
                     'PageSize' => page_size,
@@ -215,10 +238,10 @@ module Twilio
               # Initialize the ChallengeContext
               # @param [Version] version Version that contains the resource
               # @param [String] service_sid The unique SID identifier of the Service.
-              # @param [String] identity The unique external identifier for the Entity of the
-              #   Service. This identifier should be immutable, not PII, and generated by your
-              #   external system, such as your user's UUID, GUID, or SID. This value must be
-              #   between 8 and 64 characters long.
+              # @param [String] identity Customer unique identity for the Entity owner of the
+              #   Challenges. This identifier should be immutable, not PII, length between 8 and
+              #   64 characters, and generated by your external system, such as your user's UUID,
+              #   GUID, or SID. It can only contain dash (-) separated alphanumeric characters.
               # @param [String] sid A 34 character string that uniquely identifies this
               #   Challenge.
               # @return [ChallengeContext] ChallengeContext
@@ -310,7 +333,9 @@ module Twilio
               # @param [Hash] payload payload that contains response from Twilio
               # @param [String] service_sid The unique SID identifier of the Service.
               # @param [String] identity Customer unique identity for the Entity owner of the
-              #   Challenge. This value must be between 8 and 64 characters long.
+              #   Challenge. This identifier should be immutable, not PII, length between 8 and 64
+              #   characters, and generated by your external system, such as your user's UUID,
+              #   GUID, or SID. It can only contain dash (-) separated alphanumeric characters.
               # @param [String] sid A 34 character string that uniquely identifies this
               #   Challenge.
               # @return [ChallengeInstance] ChallengeInstance

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

@@ -19,10 +19,10 @@ module Twilio
               # Initialize the FactorList
               # @param [Version] version Version that contains the resource
               # @param [String] service_sid The unique SID identifier of the Service.
-              # @param [String] identity The unique external identifier for the Entity of the
-              #   Service. This identifier should be immutable, not PII, and generated by your
-              #   external system, such as your user's UUID, GUID, or SID. This value must be
-              #   between 8 and 64 characters long.
+              # @param [String] identity Customer unique identity for the Entity owner of the
+              #   Factor. This identifier should be immutable, not PII, length between 8 and 64
+              #   characters, and generated by your external system, such as your user's UUID,
+              #   GUID, or SID. It can only contain dash (-) separated alphanumeric characters.
               # @return [FactorList] FactorList
               def initialize(version, service_sid: nil, identity: nil)
                 super(version)
@@ -163,7 +163,9 @@ module Twilio
               # @param [Version] version Version that contains the resource
               # @param [String] service_sid The unique SID identifier of the Service.
               # @param [String] identity Customer unique identity for the Entity owner of the
-              #   Factor. This value must be between 8 and 64 characters long.
+              #   Factor. This identifier should be immutable, not PII, length between 8 and 64
+              #   characters, and generated by your external system, such as your user's UUID,
+              #   GUID, or SID. It can only contain dash (-) separated alphanumeric characters.
               # @param [String] sid A 34 character string that uniquely identifies this Factor.
               # @return [FactorContext] FactorContext
               def initialize(version, service_sid, identity, sid)
@@ -264,10 +266,10 @@ module Twilio
               # @param [Version] version Version that contains the resource
               # @param [Hash] payload payload that contains response from Twilio
               # @param [String] service_sid The unique SID identifier of the Service.
-              # @param [String] identity The unique external identifier for the Entity of the
-              #   Service. This identifier should be immutable, not PII, and generated by your
-              #   external system, such as your user's UUID, GUID, or SID. This value must be
-              #   between 8 and 64 characters long.
+              # @param [String] identity Customer unique identity for the Entity owner of the
+              #   Factor. This identifier should be immutable, not PII, length between 8 and 64
+              #   characters, and generated by your external system, such as your user's UUID,
+              #   GUID, or SID. It can only contain dash (-) separated alphanumeric characters.
               # @param [String] sid A 34 character string that uniquely identifies this Factor.
               # @return [FactorInstance] FactorInstance
               def initialize(version, payload, service_sid: nil, identity: nil, sid: nil)

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

@@ -19,10 +19,10 @@ module Twilio
               # Initialize the NewFactorList
               # @param [Version] version Version that contains the resource
               # @param [String] service_sid The unique SID identifier of the Service.
-              # @param [String] identity The unique external identifier for the Entity of the
-              #   Service. This identifier should be immutable, not PII, and generated by your
-              #   external system, such as your user's UUID, GUID, or SID. This value must be
-              #   between 8 and 64 characters long.
+              # @param [String] identity Customer unique identity for the Entity owner of the
+              #   Factor. This identifier should be immutable, not PII, length between 8 and 64
+              #   characters, and generated by your external system, such as your user's UUID,
+              #   GUID, or SID. It can only contain dash (-) separated alphanumeric characters.
               # @return [NewFactorList] NewFactorList
               def initialize(version, service_sid: nil, identity: nil)
                 super(version)
@@ -175,10 +175,10 @@ module Twilio
               # @param [Version] version Version that contains the resource
               # @param [Hash] payload payload that contains response from Twilio
               # @param [String] service_sid The unique SID identifier of the Service.
-              # @param [String] identity The unique external identifier for the Entity of the
-              #   Service. This identifier should be immutable, not PII, and generated by your
-              #   external system, such as your user's UUID, GUID, or SID. This value must be
-              #   between 8 and 64 characters long.
+              # @param [String] identity Customer unique identity for the Entity owner of the
+              #   Factor. This identifier should be immutable, not PII, length between 8 and 64
+              #   characters, and generated by your external system, such as your user's UUID,
+              #   GUID, or SID. It can only contain dash (-) separated alphanumeric characters.
               # @return [NewFactorInstance] NewFactorInstance
               def initialize(version, payload, service_sid: nil, identity: nil)
                 super(version)

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

@@ -32,7 +32,7 @@ module Twilio
             # @param [String] identity The unique external identifier for the Entity of the
             #   Service. This identifier should be immutable, not PII, length between 8 and 64
             #   characters, and generated by your external system, such as your user's UUID,
-            #   GUID, or SID.
+            #   GUID, or SID. It can only contain dash (-) separated alphanumeric characters.
             # @return [EntityInstance] Created EntityInstance
             def create(identity: nil)
               data = Twilio::Values.of({'Identity' => identity, })
@@ -168,7 +168,9 @@ module Twilio
             # @param [Version] version Version that contains the resource
             # @param [String] service_sid The unique SID identifier of the Service.
             # @param [String] identity The unique external identifier for the Entity of the
-            #   Service
+            #   Service. This identifier should be immutable, not PII, length between 8 and 64
+            #   characters, and generated by your external system, such as your user's UUID,
+            #   GUID, or SID. It can only contain dash (-) separated alphanumeric characters.
             # @return [EntityContext] EntityContext
             def initialize(version, service_sid, identity)
               super(version)
@@ -288,7 +290,9 @@ module Twilio
             # @param [Hash] payload payload that contains response from Twilio
             # @param [String] service_sid The unique SID identifier of the Service.
             # @param [String] identity The unique external identifier for the Entity of the
-            #   Service
+            #   Service. This identifier should be immutable, not PII, length between 8 and 64
+            #   characters, and generated by your external system, such as your user's UUID,
+            #   GUID, or SID. It can only contain dash (-) separated alphanumeric characters.
             # @return [EntityInstance] EntityInstance
             def initialize(version, payload, service_sid: nil, identity: nil)
               super(version)

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

@@ -37,13 +37,17 @@ module Twilio
             # @param [String] webhook_url The URL associated with this Webhook.
             # @param [webhook.Status] status The webhook status. Default value is `enabled`.
             #   One of: `enabled` or `disabled`
+            # @param [webhook.Version] version The webhook version. Default value is `v2`
+            #   which includes all the latest fields. Version `v1` is legacy and may be removed
+            #   in the future.
             # @return [WebhookInstance] Created WebhookInstance
-            def create(friendly_name: nil, event_types: nil, webhook_url: nil, status: :unset)
+            def create(friendly_name: nil, event_types: nil, webhook_url: nil, status: :unset, version: :unset)
               data = Twilio::Values.of({
                   'FriendlyName' => friendly_name,
                   'EventTypes' => Twilio.serialize_list(event_types) { |e| e },
                   'WebhookUrl' => webhook_url,
                   'Status' => status,
+                  'Version' => version,
               })
 
               payload = @version.create('POST', @uri, data: data)
@@ -197,13 +201,17 @@ module Twilio
             # @param [String] webhook_url The URL associated with this Webhook.
             # @param [webhook.Status] status The webhook status. Default value is `enabled`.
             #   One of: `enabled` or `disabled`
+            # @param [webhook.Version] version The webhook version. Default value is `v2`
+            #   which includes all the latest fields. Version `v1` is legacy and may be removed
+            #   in the future.
             # @return [WebhookInstance] Updated WebhookInstance
-            def update(friendly_name: :unset, event_types: :unset, webhook_url: :unset, status: :unset)
+            def update(friendly_name: :unset, event_types: :unset, webhook_url: :unset, status: :unset, version: :unset)
               data = Twilio::Values.of({
                   'FriendlyName' => friendly_name,
                   'EventTypes' => Twilio.serialize_list(event_types) { |e| e },
                   'WebhookUrl' => webhook_url,
                   'Status' => status,
+                  'Version' => version,
               })
 
               payload = @version.update('POST', @uri, data: data)
@@ -264,6 +272,7 @@ module Twilio
                   'friendly_name' => payload['friendly_name'],
                   'event_types' => payload['event_types'],
                   'status' => payload['status'],
+                  'version' => payload['version'],
                   'webhook_url' => payload['webhook_url'],
                   'webhook_method' => payload['webhook_method'],
                   'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
@@ -323,6 +332,12 @@ module Twilio
               @properties['status']
             end
 
+            ##
+            # @return [webhook.Version] The webhook version
+            def version
+              @properties['version']
+            end
+
             ##
             # @return [String] The URL associated with this Webhook.
             def webhook_url
@@ -336,13 +351,13 @@ module Twilio
             end
 
             ##
-            # @return [Time] The RFC 2822 date and time in GMT when the resource was created
+            # @return [Time] The ISO 8601 date and time in GMT when the resource was created
             def date_created
               @properties['date_created']
             end
 
             ##
-            # @return [Time] The RFC 2822 date and time in GMT when the resource was last updated
+            # @return [Time] The ISO 8601 date and time in GMT when the resource was last updated
             def date_updated
               @properties['date_updated']
             end
@@ -363,13 +378,17 @@ module Twilio
             # @param [String] webhook_url The URL associated with this Webhook.
             # @param [webhook.Status] status The webhook status. Default value is `enabled`.
             #   One of: `enabled` or `disabled`
+            # @param [webhook.Version] version The webhook version. Default value is `v2`
+            #   which includes all the latest fields. Version `v1` is legacy and may be removed
+            #   in the future.
             # @return [WebhookInstance] Updated WebhookInstance
-            def update(friendly_name: :unset, event_types: :unset, webhook_url: :unset, status: :unset)
+            def update(friendly_name: :unset, event_types: :unset, webhook_url: :unset, status: :unset, version: :unset)
               context.update(
                   friendly_name: friendly_name,
                   event_types: event_types,
                   webhook_url: webhook_url,
                   status: status,
+                  version: version,
               )
             end