twilio-ruby 5.28.0 → 5.29.0

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

@@ -28,6 +28,15 @@ module Twilio
         @v1 ||= V1.new self
       end
 
+      ##
+      # @param [String] sid The unique string that we created to identify the
+      #   Composition resource.
+      # @return [Twilio::REST::Video::V1::CompositionInstance] if sid was passed.
+      # @return [Twilio::REST::Video::V1::CompositionList]
+      def compositions(sid=:unset)
+        self.v1.compositions(sid)
+      end
+
       ##
       # @param [String] sid The unique string that we created to identify the
       #   CompositionHook resource.
@@ -58,15 +67,6 @@ module Twilio
         self.v1.recording_settings()
       end
 
-      ##
-      # @param [String] sid The unique string that we created to identify the
-      #   Composition resource.
-      # @return [Twilio::REST::Video::V1::CompositionInstance] if sid was passed.
-      # @return [Twilio::REST::Video::V1::CompositionList]
-      def compositions(sid=:unset)
-        self.v1.compositions(sid)
-      end
-
       ##
       # @param [String] sid The unique string that we created to identify the Room
       #   resource.

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

@@ -15,14 +15,28 @@ module Twilio
         def initialize(domain)
           super
           @version = 'v1'
+          @compositions = nil
           @composition_hooks = nil
           @composition_settings = nil
           @recordings = nil
           @recording_settings = nil
-          @compositions = nil
           @rooms = nil
         end
 
+        ##
+        # @param [String] sid The SID of the Composition resource to fetch.
+        # @return [Twilio::REST::Video::V1::CompositionContext] if sid was passed.
+        # @return [Twilio::REST::Video::V1::CompositionList]
+        def compositions(sid=:unset)
+          if sid.nil?
+            raise ArgumentError, 'sid cannot be nil'
+          elsif sid == :unset
+            @compositions ||= CompositionList.new self
+          else
+            CompositionContext.new(self, sid)
+          end
+        end
+
         ##
         # @param [String] sid The SID of the CompositionHook resource to fetch.
         # @return [Twilio::REST::Video::V1::CompositionHookContext] if sid was passed.
@@ -63,20 +77,6 @@ module Twilio
           @recording_settings ||= RecordingSettingsContext.new self
         end
 
-        ##
-        # @param [String] sid The SID of the Composition resource to fetch.
-        # @return [Twilio::REST::Video::V1::CompositionContext] if sid was passed.
-        # @return [Twilio::REST::Video::V1::CompositionList]
-        def compositions(sid=:unset)
-          if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @compositions ||= CompositionList.new self
-          else
-            CompositionContext.new(self, sid)
-          end
-        end
-
         ##
         # @param [String] sid The SID of the Room resource to fetch.
         # @return [Twilio::REST::Video::V1::RoomContext] if sid was passed.

data/lib/twilio-ruby/rest/voice/v1/dialing_permissions.rb

@@ -32,7 +32,8 @@ module Twilio
           ##
           # Access the countries
           # @param [String] iso_code The [ISO country
-          #   code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
+          #   code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the
+          #   DialingPermissions Country resource to fetch
           # @return [CountryList]
           # @return [CountryContext] if iso_code was passed.
           def countries(iso_code=:unset)

data/lib/twilio-ruby/rest/voice/v1/dialing_permissions/country.rb

@@ -224,7 +224,8 @@ module Twilio
             # Initialize the CountryContext
             # @param [Version] version Version that contains the resource
             # @param [String] iso_code The [ISO country
-            #   code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
+            #   code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the
+            #   DialingPermissions Country resource to fetch
             # @return [CountryContext] CountryContext
             def initialize(version, iso_code)
               super(version)
@@ -287,7 +288,8 @@ module Twilio
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
             # @param [String] iso_code The [ISO country
-            #   code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
+            #   code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the
+            #   DialingPermissions Country resource to fetch
             # @return [CountryInstance] CountryInstance
             def initialize(version, payload, iso_code: nil)
               super(version)
@@ -328,13 +330,13 @@ module Twilio
             end
 
             ##
-            # @return [String] Name of the country
+            # @return [String] The name of the country
             def name
               @properties['name']
             end
 
             ##
-            # @return [String] Name of the continent
+            # @return [String] The name of the continent in which the country is located
             def continent
               @properties['continent']
             end
@@ -346,19 +348,19 @@ module Twilio
             end
 
             ##
-            # @return [Boolean] `true`, if dialing to low-risk numbers is enabled, else `false`
+            # @return [Boolean] Whether dialing to low-risk numbers is enabled
             def low_risk_numbers_enabled
               @properties['low_risk_numbers_enabled']
             end
 
             ##
-            # @return [Boolean] `true`, if dialing to high-risk special services numbers is enabled, else `false`
+            # @return [Boolean] Whether dialing to high-risk special services numbers is enabled
             def high_risk_special_numbers_enabled
               @properties['high_risk_special_numbers_enabled']
             end
 
             ##
-            # @return [Boolean] `true`, if dialing to high-risk toll fraud numbers is enabled, else `false`
+            # @return [Boolean] Whether dialing to high-risk toll fraud numbers is enabled, else `false`
             def high_risk_tollfraud_numbers_enabled
               @properties['high_risk_tollfraud_numbers_enabled']
             end

data/lib/twilio-ruby/rest/voice/v1/dialing_permissions/settings.rb

@@ -95,7 +95,7 @@ module Twilio
 
             ##
             # Update the SettingsInstance
-            # @param [Boolean] dialing_permissions_inheritance `true` for this sub-account to
+            # @param [Boolean] dialing_permissions_inheritance `true` for the sub-account to
             #   inherit voice dialing permissions from the Master Project; otherwise `false`.
             # @return [SettingsInstance] Updated SettingsInstance
             def update(dialing_permissions_inheritance: :unset)
@@ -159,7 +159,7 @@ module Twilio
             end
 
             ##
-            # @return [Boolean] `true` if this sub-account will inherit voice dialing permissions from the Master Project; otherwise `false`
+            # @return [Boolean] `true` if the sub-account will inherit voice dialing permissions from the Master Project; otherwise `false`
             def dialing_permissions_inheritance
               @properties['dialing_permissions_inheritance']
             end
@@ -179,7 +179,7 @@ module Twilio
 
             ##
             # Update the SettingsInstance
-            # @param [Boolean] dialing_permissions_inheritance `true` for this sub-account to
+            # @param [Boolean] dialing_permissions_inheritance `true` for the sub-account to
             #   inherit voice dialing permissions from the Master Project; otherwise `false`.
             # @return [SettingsInstance] Updated SettingsInstance
             def update(dialing_permissions_inheritance: :unset)

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

@@ -28,6 +28,12 @@ module Twilio
         @v1 ||= V1.new self
       end
 
+      ##
+      # @return [Twilio::REST::Wireless::V1::UsageRecordInstance]
+      def usage_records
+        self.v1.usage_records()
+      end
+
       ##
       # @param [String] sid The unique string that we created to identify the Command
       #   resource.
@@ -46,12 +52,6 @@ module Twilio
         self.v1.rate_plans(sid)
       end
 
-      ##
-      # @return [Twilio::REST::Wireless::V1::UsageRecordInstance]
-      def usage_records
-        self.v1.usage_records()
-      end
-
       ##
       # @param [String] sid The unique string that we created to identify the Sim
       #   resource.

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

@@ -15,12 +15,18 @@ module Twilio
         def initialize(domain)
           super
           @version = 'v1'
+          @usage_records = nil
           @commands = nil
           @rate_plans = nil
-          @usage_records = nil
           @sims = nil
         end
 
+        ##
+        # @return [Twilio::REST::Wireless::V1::UsageRecordContext]
+        def usage_records
+          @usage_records ||= UsageRecordList.new self
+        end
+
         ##
         # @param [String] sid The SID of the Command resource to fetch.
         # @return [Twilio::REST::Wireless::V1::CommandContext] if sid was passed.
@@ -50,13 +56,7 @@ module Twilio
         end
 
         ##
-        # @return [Twilio::REST::Wireless::V1::UsageRecordContext]
-        def usage_records
-          @usage_records ||= UsageRecordList.new self
-        end
-
-        ##
-        # @param [String] sid The SID of the Sim resource to fetch.
+        # @param [String] sid The SID or the `unique_name` of the Sim resource to fetch.
         # @return [Twilio::REST::Wireless::V1::SimContext] if sid was passed.
         # @return [Twilio::REST::Wireless::V1::SimList]
         def sims(sid=:unset)

data/lib/twilio-ruby/rest/wireless/v1/command.rb

@@ -28,7 +28,7 @@ module Twilio
           # 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
-          #   resources](https://www.twilio.com/docs/wireless/api/sim) to read.
+          #   resources](https://www.twilio.com/docs/wireless/api/sim-resource) to read.
           # @param [command.Status] status The status of the resources to read. Can be:
           #   `queued`, `sent`, `delivered`, `received`, or `failed`.
           # @param [command.Direction] direction Only return Commands with this direction
@@ -58,7 +58,7 @@ module Twilio
           # 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
-          #   resources](https://www.twilio.com/docs/wireless/api/sim) to read.
+          #   resources](https://www.twilio.com/docs/wireless/api/sim-resource) to read.
           # @param [command.Status] status The status of the resources to read. Can be:
           #   `queued`, `sent`, `delivered`, `received`, or `failed`.
           # @param [command.Direction] direction Only return Commands with this direction
@@ -104,7 +104,7 @@ module Twilio
           # Retrieve a single page of CommandInstance records from the API.
           # Request is executed immediately.
           # @param [String] sim The `sid` or `unique_name` of the [Sim
-          #   resources](https://www.twilio.com/docs/wireless/api/sim) to read.
+          #   resources](https://www.twilio.com/docs/wireless/api/sim-resource) to read.
           # @param [command.Status] status The status of the resources to read. Can be:
           #   `queued`, `sent`, `delivered`, `received`, or `failed`.
           # @param [command.Direction] direction Only return Commands with this direction
@@ -152,7 +152,8 @@ module Twilio
           # @param [String] command The message body of the Command. Can be plain text in
           #   text mode or a Base64 encoded byte string in binary mode.
           # @param [String] sim The `sid` or `unique_name` of the
-          #   [SIM](https://www.twilio.com/docs/wireless/api/sim) to send the Command to.
+          #   [SIM](https://www.twilio.com/docs/wireless/api/sim-resource) to send the Command
+          #   to.
           # @param [String] callback_method The HTTP method we use to call `callback_url`.
           #   Can be: `POST` or `GET`, and the default is `POST`.
           # @param [String] callback_url The URL we call using the `callback_url` when the

data/lib/twilio-ruby/rest/wireless/v1/rate_plan.rb

@@ -123,13 +123,13 @@ module Twilio
           # @param [String] data_metering The model used to meter data usage. Can be: `payg`
           #   and `quota-1`, `quota-10`, and `quota-50`. Learn more about the available [data
           #   metering
-          #   models](https://www.twilio.com/docs/wireless/api/rate-plan#payg-vs-quota-data-plans).
+          #   models](https://www.twilio.com/docs/wireless/api/rateplan-resource#payg-vs-quota-data-plans).
           # @param [Boolean] messaging_enabled Whether SIMs can make, send, and receive SMS
-          #   using [Commands](https://www.twilio.com/docs/wireless/api/commands).
+          #   using [Commands](https://www.twilio.com/docs/wireless/api/command-resource).
           # @param [Boolean] voice_enabled Whether SIMs can make and receive voice calls.
           # @param [Boolean] national_roaming_enabled Whether SIMs can roam on networks
           #   other than the home network (T-Mobile USA) in the United States. See [national
-          #   roaming](https://www.twilio.com/docs/wireless/api/rate-plan#national-roaming).
+          #   roaming](https://www.twilio.com/docs/wireless/api/rateplan-resource#national-roaming).
           # @param [String] international_roaming The list of services that SIMs capable of
           #   using GPRS/3G/4G/LTE data connectivity can use outside of the United States. Can
           #   be: `data`, `voice`, and `messaging`.
@@ -138,8 +138,7 @@ module Twilio
           #   non-home networks in the United States. The metering period begins the day of
           #   activation and ends on the same day in the following month. Can be up to 2TB.
           #   See [national
-          #   roaming](https://www.twilio.com/docs/wireless/api/rate-plan#national-roaming)
-          #   for more info.
+          #   roaming](https://www.twilio.com/docs/wireless/api/rateplan-resource#national-roaming) for more info.
           # @param [String] international_roaming_data_limit The total data usage (download
           #   and upload combined) in Megabytes that the Network allows during one month when
           #   roaming outside the United States. Can be up to 2TB.

data/lib/twilio-ruby/rest/wireless/v1/sim.rb

@@ -28,14 +28,14 @@ module Twilio
           # Unlike stream(), this operation is eager and will load `limit` records into
           # memory before returning.
           # @param [sim.Status] status Only return Sim resources with this status.
-          # @param [String] iccid Only return Sim resources with this ICCID. Currently this
-          #   should be a list with maximum size 1.
-          # @param [String] rate_plan The `sid` or `unique_name` of the [RatePlan
-          #   resource](https://www.twilio.com/docs/wireless/api/rate-plan) used by the Sim
-          #   resources to read.
+          # @param [String] iccid Only return Sim resources with this ICCID. This will
+          #   return a list with a maximum size of 1.
+          # @param [String] rate_plan The SID or unique name of a [RatePlan
+          #   resource](https://www.twilio.com/docs/wireless/api/rateplan-resource). Only
+          #   return Sim resources assigned to this RatePlan resource.
           # @param [String] e_id Deprecated.
           # @param [String] sim_registration_code Only return Sim resources with this
-          #   registration code.
+          #   registration code. This will return a list with a maximum size of 1.
           # @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
@@ -60,14 +60,14 @@ module Twilio
           # This operation lazily loads records as efficiently as possible until the limit
           # is reached.
           # @param [sim.Status] status Only return Sim resources with this status.
-          # @param [String] iccid Only return Sim resources with this ICCID. Currently this
-          #   should be a list with maximum size 1.
-          # @param [String] rate_plan The `sid` or `unique_name` of the [RatePlan
-          #   resource](https://www.twilio.com/docs/wireless/api/rate-plan) used by the Sim
-          #   resources to read.
+          # @param [String] iccid Only return Sim resources with this ICCID. This will
+          #   return a list with a maximum size of 1.
+          # @param [String] rate_plan The SID or unique name of a [RatePlan
+          #   resource](https://www.twilio.com/docs/wireless/api/rateplan-resource). Only
+          #   return Sim resources assigned to this RatePlan resource.
           # @param [String] e_id Deprecated.
           # @param [String] sim_registration_code Only return Sim resources with this
-          #   registration code.
+          #   registration code. This will return a list with a maximum size of 1.
           # @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
@@ -108,14 +108,14 @@ module Twilio
           # Retrieve a single page of SimInstance records from the API.
           # Request is executed immediately.
           # @param [sim.Status] status Only return Sim resources with this status.
-          # @param [String] iccid Only return Sim resources with this ICCID. Currently this
-          #   should be a list with maximum size 1.
-          # @param [String] rate_plan The `sid` or `unique_name` of the [RatePlan
-          #   resource](https://www.twilio.com/docs/wireless/api/rate-plan) used by the Sim
-          #   resources to read.
+          # @param [String] iccid Only return Sim resources with this ICCID. This will
+          #   return a list with a maximum size of 1.
+          # @param [String] rate_plan The SID or unique name of a [RatePlan
+          #   resource](https://www.twilio.com/docs/wireless/api/rateplan-resource). Only
+          #   return Sim resources assigned to this RatePlan resource.
           # @param [String] e_id Deprecated.
           # @param [String] sim_registration_code Only return Sim resources with this
-          #   registration code.
+          #   registration code. This will return a list with a maximum size of 1.
           # @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
@@ -192,7 +192,7 @@ module Twilio
           ##
           # Initialize the SimContext
           # @param [Version] version Version that contains the resource
-          # @param [String] sid The SID of the Sim resource to fetch.
+          # @param [String] sid The SID or the `unique_name` of the Sim resource to fetch.
           # @return [SimContext] SimContext
           def initialize(version, sid)
             super(version)
@@ -226,51 +226,58 @@ module Twilio
           # @param [String] unique_name An application-defined string that uniquely
           #   identifies the resource. It can be used in place of the `sid` in the URL path to
           #   address the resource.
-          # @param [String] callback_method The HTTP method we use to call `callback_url`.
-          #   Can be: `POST` or `GET`, and the default is `POST`.
-          # @param [String] callback_url The URL we call using the `callback_url` when the
-          #   SIM has finished updating. When the SIM transitions from `new` to `ready` or
-          #   from any status to `deactivated`, we call this URL when the status changes to an
-          #   intermediate status (`ready` or `deactivated`) and again when the status changes
-          #   to its final status (`active` or `canceled`).
+          # @param [String] callback_method The HTTP method we should use to call
+          #   `callback_url`. Can be: `POST` or `GET`. The default is `POST`.
+          # @param [String] callback_url The URL we should call using the `callback_url`
+          #   when the SIM has finished updating. When the SIM transitions from `new` to
+          #   `ready` or from any status to `deactivated`, we call this URL when the status
+          #   changes to an intermediate status (`ready` or `deactivated`) and again when the
+          #   status changes to its final status (`active` or `canceled`).
           # @param [String] friendly_name A descriptive string that you create to describe
-          #   the resource. It does not need to be unique.
-          # @param [String] rate_plan The `sid` or `unique_name` of the [RatePlan
-          #   resource](https://www.twilio.com/docs/wireless/api/rate-plan) that this SIM
-          #   should use.
-          # @param [sim.Status] status The new status of the resource. Can be: `ready`,
-          #   `active`, `suspended` or `deactivated`; however the SIM might support additional
-          #   values.
-          # @param [String] commands_callback_method The HTTP method we use to call
-          #   `commands_callback_url`.  Can be: `POST` or `GET`, and the default is `POST`.
-          # @param [String] commands_callback_url The URL we call using the
-          #   `commands_callback_method` when the SIM originates a
-          #   [Command](https://www.twilio.com/docs/wireless/api/commands). Your server should
-          #   respond with an HTTP status code in the 200 range; any response body is ignored.
-          # @param [String] sms_fallback_method The HTTP method we use to call
-          #   `sms_fallback_url`. Can be: `GET` or `POST`.
-          # @param [String] sms_fallback_url The URL we call using the `sms_fallback_method`
-          #   when an error occurs while retrieving or executing the TwiML requested from
-          #   `sms_url`.
-          # @param [String] sms_method The HTTP method we use to call `sms_url`. Can be:
-          #   `GET` or `POST`.
-          # @param [String] sms_url The URL we call using the `sms_method` when the
+          #   the Sim resource. It does not need to be unique.
+          # @param [String] rate_plan The SID or unique name of the [RatePlan
+          #   resource](https://www.twilio.com/docs/wireless/api/rateplan-resource) to which
+          #   the Sim resource should be assigned.
+          # @param [sim.Status] status The new status of the Sim resource. Can be: `ready`,
+          #   `active`, `suspended`, or `deactivated`.
+          # @param [String] commands_callback_method The HTTP method we should use to call
+          #   `commands_callback_url`. Can be: `POST` or `GET`. The default is `POST`.
+          # @param [String] commands_callback_url The URL we should call using the
+          #   `commands_callback_method` when the SIM sends a
+          #   [Command](https://www.twilio.com/docs/wireless/api/command-resource). Your
+          #   server should respond with an HTTP status code in the 200 range; any response
+          #   body is ignored.
+          # @param [String] sms_fallback_method The HTTP method we should use to call
+          #   `sms_fallback_url`. Can be: `GET` or `POST`. Default is `POST`.
+          # @param [String] sms_fallback_url The URL we should call using the
+          #   `sms_fallback_method` when an error occurs while retrieving or executing the
+          #   TwiML requested from `sms_url`.
+          # @param [String] sms_method The HTTP method we should use to call `sms_url`. Can
+          #   be: `GET` or `POST`. Default is `POST`.
+          # @param [String] sms_url The URL we should call using the `sms_method` when the
           #   SIM-connected device sends an SMS message that is not a
-          #   [Command](https://www.twilio.com/docs/wireless/api/commands).
-          # @param [String] voice_fallback_method The HTTP method we use to call
+          #   [Command](https://www.twilio.com/docs/wireless/api/command-resource).
+          # @param [String] voice_fallback_method The HTTP method we should use to call
           #   `voice_fallback_url`. Can be: `GET` or `POST`.
-          # @param [String] voice_fallback_url The URL we call using the
+          # @param [String] voice_fallback_url The URL we should call using the
           #   `voice_fallback_method` when an error occurs while retrieving or executing the
           #   TwiML requested from `voice_url`.
-          # @param [String] voice_method The HTTP method we use when we call `voice_url`.
-          #   Can be: `GET` or `POST`.
-          # @param [String] voice_url The URL we call using the `voice_method` when the
-          #   SIM-connected device makes a voice call.
+          # @param [String] voice_method The HTTP method we should use when we call
+          #   `voice_url`. Can be: `GET` or `POST`.
+          # @param [String] voice_url The URL we should call using the `voice_method` when
+          #   the SIM-connected device makes a voice call.
           # @param [sim.ResetStatus] reset_status Initiate a connectivity reset on the SIM.
           #   Set to `resetting` to initiate a connectivity reset on the SIM. No other value
           #   is valid.
+          # @param [String] account_sid The SID of the
+          #   [Account](https://www.twilio.com/docs/iam/api/account) to which the Sim resource
+          #   should belong. The Account SID can only be that of the requesting Account or
+          #   that of a [Subaccount](https://www.twilio.com/docs/iam/api/subaccounts) of the
+          #   requesting Account. Only valid when the Sim resource's status is `new`. For more
+          #   information, see the [Move SIMs between Subaccounts
+          #   documentation](https://www.twilio.com/docs/wireless/api/sim-resource#move-sims-between-subaccounts).
           # @return [SimInstance] Updated SimInstance
-          def update(unique_name: :unset, callback_method: :unset, callback_url: :unset, friendly_name: :unset, rate_plan: :unset, status: :unset, commands_callback_method: :unset, commands_callback_url: :unset, sms_fallback_method: :unset, sms_fallback_url: :unset, sms_method: :unset, sms_url: :unset, voice_fallback_method: :unset, voice_fallback_url: :unset, voice_method: :unset, voice_url: :unset, reset_status: :unset)
+          def update(unique_name: :unset, callback_method: :unset, callback_url: :unset, friendly_name: :unset, rate_plan: :unset, status: :unset, commands_callback_method: :unset, commands_callback_url: :unset, sms_fallback_method: :unset, sms_fallback_url: :unset, sms_method: :unset, sms_url: :unset, voice_fallback_method: :unset, voice_fallback_url: :unset, voice_method: :unset, voice_url: :unset, reset_status: :unset, account_sid: :unset)
             data = Twilio::Values.of({
                 'UniqueName' => unique_name,
                 'CallbackMethod' => callback_method,
@@ -289,6 +296,7 @@ module Twilio
                 'VoiceMethod' => voice_method,
                 'VoiceUrl' => voice_url,
                 'ResetStatus' => reset_status,
+                'AccountSid' => account_sid,
             })
 
             payload = @version.update(
@@ -351,7 +359,7 @@ module Twilio
           # Initialize the SimInstance
           # @param [Version] version Version that contains the resource
           # @param [Hash] payload payload that contains response from Twilio
-          # @param [String] sid The SID of the Sim resource to fetch.
+          # @param [String] sid The SID or the `unique_name` of the Sim resource to fetch.
           # @return [SimInstance] SimInstance
           def initialize(version, payload, sid: nil)
             super(version)
@@ -401,7 +409,7 @@ module Twilio
           end
 
           ##
-          # @return [String] The unique string that identifies the resource
+          # @return [String] The unique string that identifies the Sim resource
           def sid
             @properties['sid']
           end
@@ -413,19 +421,19 @@ module Twilio
           end
 
           ##
-          # @return [String] The SID of the Account that created the resource
+          # @return [String] The SID of the Account to which the Sim resource belongs
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [String] The SID of the RatePlan resource configured for this SIM
+          # @return [String] The SID of the RatePlan resource to which the Sim resource is assigned.
           def rate_plan_sid
             @properties['rate_plan_sid']
           end
 
           ##
-          # @return [String] The string that you assigned to describe the resource
+          # @return [String] The string that you assigned to describe the Sim resource
           def friendly_name
             @properties['friendly_name']
           end
@@ -443,7 +451,7 @@ module Twilio
           end
 
           ##
-          # @return [sim.Status] The status of the SIM
+          # @return [sim.Status] The status of the Sim resource
           def status
             @properties['status']
           end
@@ -521,7 +529,7 @@ module Twilio
           end
 
           ##
-          # @return [Time] The ISO 8601 date and time in GMT when the resource was last updated
+          # @return [Time] The ISO 8601 date and time in GMT when the Sim resource was last updated
           def date_updated
             @properties['date_updated']
           end
@@ -556,51 +564,58 @@ module Twilio
           # @param [String] unique_name An application-defined string that uniquely
           #   identifies the resource. It can be used in place of the `sid` in the URL path to
           #   address the resource.
-          # @param [String] callback_method The HTTP method we use to call `callback_url`.
-          #   Can be: `POST` or `GET`, and the default is `POST`.
-          # @param [String] callback_url The URL we call using the `callback_url` when the
-          #   SIM has finished updating. When the SIM transitions from `new` to `ready` or
-          #   from any status to `deactivated`, we call this URL when the status changes to an
-          #   intermediate status (`ready` or `deactivated`) and again when the status changes
-          #   to its final status (`active` or `canceled`).
+          # @param [String] callback_method The HTTP method we should use to call
+          #   `callback_url`. Can be: `POST` or `GET`. The default is `POST`.
+          # @param [String] callback_url The URL we should call using the `callback_url`
+          #   when the SIM has finished updating. When the SIM transitions from `new` to
+          #   `ready` or from any status to `deactivated`, we call this URL when the status
+          #   changes to an intermediate status (`ready` or `deactivated`) and again when the
+          #   status changes to its final status (`active` or `canceled`).
           # @param [String] friendly_name A descriptive string that you create to describe
-          #   the resource. It does not need to be unique.
-          # @param [String] rate_plan The `sid` or `unique_name` of the [RatePlan
-          #   resource](https://www.twilio.com/docs/wireless/api/rate-plan) that this SIM
-          #   should use.
-          # @param [sim.Status] status The new status of the resource. Can be: `ready`,
-          #   `active`, `suspended` or `deactivated`; however the SIM might support additional
-          #   values.
-          # @param [String] commands_callback_method The HTTP method we use to call
-          #   `commands_callback_url`.  Can be: `POST` or `GET`, and the default is `POST`.
-          # @param [String] commands_callback_url The URL we call using the
-          #   `commands_callback_method` when the SIM originates a
-          #   [Command](https://www.twilio.com/docs/wireless/api/commands). Your server should
-          #   respond with an HTTP status code in the 200 range; any response body is ignored.
-          # @param [String] sms_fallback_method The HTTP method we use to call
-          #   `sms_fallback_url`. Can be: `GET` or `POST`.
-          # @param [String] sms_fallback_url The URL we call using the `sms_fallback_method`
-          #   when an error occurs while retrieving or executing the TwiML requested from
-          #   `sms_url`.
-          # @param [String] sms_method The HTTP method we use to call `sms_url`. Can be:
-          #   `GET` or `POST`.
-          # @param [String] sms_url The URL we call using the `sms_method` when the
+          #   the Sim resource. It does not need to be unique.
+          # @param [String] rate_plan The SID or unique name of the [RatePlan
+          #   resource](https://www.twilio.com/docs/wireless/api/rateplan-resource) to which
+          #   the Sim resource should be assigned.
+          # @param [sim.Status] status The new status of the Sim resource. Can be: `ready`,
+          #   `active`, `suspended`, or `deactivated`.
+          # @param [String] commands_callback_method The HTTP method we should use to call
+          #   `commands_callback_url`. Can be: `POST` or `GET`. The default is `POST`.
+          # @param [String] commands_callback_url The URL we should call using the
+          #   `commands_callback_method` when the SIM sends a
+          #   [Command](https://www.twilio.com/docs/wireless/api/command-resource). Your
+          #   server should respond with an HTTP status code in the 200 range; any response
+          #   body is ignored.
+          # @param [String] sms_fallback_method The HTTP method we should use to call
+          #   `sms_fallback_url`. Can be: `GET` or `POST`. Default is `POST`.
+          # @param [String] sms_fallback_url The URL we should call using the
+          #   `sms_fallback_method` when an error occurs while retrieving or executing the
+          #   TwiML requested from `sms_url`.
+          # @param [String] sms_method The HTTP method we should use to call `sms_url`. Can
+          #   be: `GET` or `POST`. Default is `POST`.
+          # @param [String] sms_url The URL we should call using the `sms_method` when the
           #   SIM-connected device sends an SMS message that is not a
-          #   [Command](https://www.twilio.com/docs/wireless/api/commands).
-          # @param [String] voice_fallback_method The HTTP method we use to call
+          #   [Command](https://www.twilio.com/docs/wireless/api/command-resource).
+          # @param [String] voice_fallback_method The HTTP method we should use to call
           #   `voice_fallback_url`. Can be: `GET` or `POST`.
-          # @param [String] voice_fallback_url The URL we call using the
+          # @param [String] voice_fallback_url The URL we should call using the
           #   `voice_fallback_method` when an error occurs while retrieving or executing the
           #   TwiML requested from `voice_url`.
-          # @param [String] voice_method The HTTP method we use when we call `voice_url`.
-          #   Can be: `GET` or `POST`.
-          # @param [String] voice_url The URL we call using the `voice_method` when the
-          #   SIM-connected device makes a voice call.
+          # @param [String] voice_method The HTTP method we should use when we call
+          #   `voice_url`. Can be: `GET` or `POST`.
+          # @param [String] voice_url The URL we should call using the `voice_method` when
+          #   the SIM-connected device makes a voice call.
           # @param [sim.ResetStatus] reset_status Initiate a connectivity reset on the SIM.
           #   Set to `resetting` to initiate a connectivity reset on the SIM. No other value
           #   is valid.
+          # @param [String] account_sid The SID of the
+          #   [Account](https://www.twilio.com/docs/iam/api/account) to which the Sim resource
+          #   should belong. The Account SID can only be that of the requesting Account or
+          #   that of a [Subaccount](https://www.twilio.com/docs/iam/api/subaccounts) of the
+          #   requesting Account. Only valid when the Sim resource's status is `new`. For more
+          #   information, see the [Move SIMs between Subaccounts
+          #   documentation](https://www.twilio.com/docs/wireless/api/sim-resource#move-sims-between-subaccounts).
           # @return [SimInstance] Updated SimInstance
-          def update(unique_name: :unset, callback_method: :unset, callback_url: :unset, friendly_name: :unset, rate_plan: :unset, status: :unset, commands_callback_method: :unset, commands_callback_url: :unset, sms_fallback_method: :unset, sms_fallback_url: :unset, sms_method: :unset, sms_url: :unset, voice_fallback_method: :unset, voice_fallback_url: :unset, voice_method: :unset, voice_url: :unset, reset_status: :unset)
+          def update(unique_name: :unset, callback_method: :unset, callback_url: :unset, friendly_name: :unset, rate_plan: :unset, status: :unset, commands_callback_method: :unset, commands_callback_url: :unset, sms_fallback_method: :unset, sms_fallback_url: :unset, sms_method: :unset, sms_url: :unset, voice_fallback_method: :unset, voice_fallback_url: :unset, voice_method: :unset, voice_url: :unset, reset_status: :unset, account_sid: :unset)
             context.update(
                 unique_name: unique_name,
                 callback_method: callback_method,
@@ -619,6 +634,7 @@ module Twilio
                 voice_method: voice_method,
                 voice_url: voice_url,
                 reset_status: reset_status,
+                account_sid: account_sid,
             )
           end