twilio-ruby 5.27.0 → 5.27.1

data/lib/twilio-ruby/rest/notify/v1/service/binding.rb

@@ -33,8 +33,8 @@ module Twilio
             # Retrieve a single page of BindingInstance records from the API.
             # Request is executed immediately.
             # @param [String] identity The `identity` value that uniquely identifies the new
-            #   resource's [User](https://www.twilio.com/docs/chat/rest/users) within the
-            #   [Service](https://www.twilio.com/docs/notify/api/service-resource). Up to 20
+            #   resource's [User](https://www.twilio.com/docs/chat/rest/user-resource) within
+            #   the [Service](https://www.twilio.com/docs/notify/api/service-resource). Up to 20
             #   Bindings can be created for the same Identity in a given Service.
             # @param [binding.BindingType] binding_type The transport technology to use for
             #   the Binding. Can be: `apn`, `fcm`, `gcm`, `sms`, or `facebook-messenger`.
@@ -87,8 +87,8 @@ module Twilio
             # @param [Date] end_date Only include usage that occurred on or before this date.
             #   Specify the date in GMT and format as `YYYY-MM-DD`.
             # @param [String] identity The
-            #   [User](https://www.twilio.com/docs/chat/rest/users)'s `identity` value of the
-            #   resources to read.
+            #   [User](https://www.twilio.com/docs/chat/rest/user-resource)'s `identity` value
+            #   of the resources to read.
             # @param [String] tag Only list Bindings that have all of the specified Tags. The
             #   following implicit tags are available: `all`, `apn`, `fcm`, `gcm`, `sms`,
             #   `facebook-messenger`. Up to 5 tags are allowed.
@@ -119,8 +119,8 @@ module Twilio
             # @param [Date] end_date Only include usage that occurred on or before this date.
             #   Specify the date in GMT and format as `YYYY-MM-DD`.
             # @param [String] identity The
-            #   [User](https://www.twilio.com/docs/chat/rest/users)'s `identity` value of the
-            #   resources to read.
+            #   [User](https://www.twilio.com/docs/chat/rest/user-resource)'s `identity` value
+            #   of the resources to read.
             # @param [String] tag Only list Bindings that have all of the specified Tags. The
             #   following implicit tags are available: `all`, `apn`, `fcm`, `gcm`, `sms`,
             #   `facebook-messenger`. Up to 5 tags are allowed.
@@ -167,8 +167,8 @@ module Twilio
             # @param [Date] end_date Only include usage that occurred on or before this date.
             #   Specify the date in GMT and format as `YYYY-MM-DD`.
             # @param [String] identity The
-            #   [User](https://www.twilio.com/docs/chat/rest/users)'s `identity` value of the
-            #   resources to read.
+            #   [User](https://www.twilio.com/docs/chat/rest/user-resource)'s `identity` value
+            #   of the resources to read.
             # @param [String] tag Only list Bindings that have all of the specified Tags. The
             #   following implicit tags are available: `all`, `apn`, `fcm`, `gcm`, `sms`,
             #   `facebook-messenger`. Up to 5 tags are allowed.

data/lib/twilio-ruby/rest/notify/v1/service/notification.rb

@@ -81,7 +81,7 @@ module Twilio
             # @param [Hash] gcm The GCM-specific payload that overrides corresponding
             #   attributes in the generic payload for GCM Bindings.  This property maps to the
             #   root JSON dictionary. See the [GCM
-            #   documentation](https://developers.google.com/cloud-messaging/http-server-ref)
+            #   documentation](https://firebase.google.com/docs/cloud-messaging/http-server-ref)
             #   for more details. Target parameters `to`, `registration_ids`, and
             #   `notification_key` are not allowed. We reserve keys that start with `twi_` for
             #   future use. Custom keys that start with `twi_` are not allowed. GCM also
@@ -108,8 +108,8 @@ module Twilio
             #   request entity should not exceed 1MB. This is typically sufficient for 10,000
             #   phone numbers.
             # @param [String] identity The `identity` value that uniquely identifies the new
-            #   resource's [User](https://www.twilio.com/docs/chat/rest/users) within the
-            #   [Service](https://www.twilio.com/docs/notify/api/service-resource). Delivery
+            #   resource's [User](https://www.twilio.com/docs/chat/rest/user-resource) within
+            #   the [Service](https://www.twilio.com/docs/notify/api/service-resource). Delivery
             #   will be attempted only to Bindings with an Identity in this list. No more than
             #   20 items are allowed in this list.
             # @param [String] tag A tag that selects the Bindings to notify. Repeat this

data/lib/twilio-ruby/rest/preview/trusted_comms/branded_call.rb

@@ -28,15 +28,15 @@ module Twilio
           ##
           # Retrieve a single page of BrandedCallInstance records from the API.
           # Request is executed immediately.
-          # @param [String] from The phone number to use as the caller id, given in E.164
-          #   format (https://en.wikipedia.org/wiki/E.164). It must be a Twilio number that
+          # @param [String] from The phone number to use as the caller id, given in [E.164
+          #   format](https://en.wikipedia.org/wiki/E.164). It must be a Twilio number that
           #   has been set up as a Branded Number in the Business Profile section for your
           #   account.
-          # @param [String] to The terminating Phone Number, given in E.164 format
-          #   (https://en.wikipedia.org/wiki/E.164).
+          # @param [String] to The terminating Phone Number, given in [E.164
+          #   format](https://en.wikipedia.org/wiki/E.164).
           # @param [String] reason The business reason for this phone call that will appear
-          #   in the terminating device's screen.
-          # @param [String] call_sid The call_sid
+          #   in the terminating device's screen. Max 50 characters.
+          # @param [String] call_sid The Call sid this Branded Call should link to.
           # @return [BrandedCallInstance] Newly created BrandedCallInstance
           def create(from: nil, to: nil, reason: nil, call_sid: :unset)
             data = Twilio::Values.of({'From' => from, 'To' => to, 'Reason' => reason, 'CallSid' => call_sid, })

data/lib/twilio-ruby/rest/preview/trusted_comms/device.rb

@@ -29,7 +29,7 @@ module Twilio
           # Retrieve a single page of DeviceInstance records from the API.
           # Request is executed immediately.
           # @param [String] phone_number The end user Phone Number linked to the device,
-          #   given in E.164 format (https://en.wikipedia.org/wiki/E.164). The SDK or partner
+          #   given in [E.164 format](https://en.wikipedia.org/wiki/E.164). The SDK or partner
           #   app is responsible of verifying this phone number veracity.
           # @param [String] push_token The Push Token for this Phone Number, linked to the
           #   correct SDK's application, certificate and keys.

data/lib/twilio-ruby/rest/preview/trusted_comms/phone_call.rb

@@ -28,86 +28,86 @@ module Twilio
           ##
           # Retrieve a single page of PhoneCallInstance records from the API.
           # Request is executed immediately.
-          # @param [String] from The phone number to use as the caller id, given in E.164
-          #   format (https://en.wikipedia.org/wiki/E.164). It must be a Twilio number that
+          # @param [String] from The phone number to use as the caller id, given in [E.164
+          #   format](https://en.wikipedia.org/wiki/E.164). It must be a Twilio number that
           #   has been set up as a Branded Number in the Business Profile section for your
           #   account.
-          # @param [String] to The terminating Phone Number, given in E.164 format
-          #   (https://en.wikipedia.org/wiki/E.164).
+          # @param [String] to The terminating Phone Number, given in [E.164
+          #   format](https://en.wikipedia.org/wiki/E.164).
           # @param [String] reason The business reason for this phone call that will appear
-          #   in the terminating device's screen.
+          #   in the terminating device's screen. Max 50 characters.
           # @param [String] application_sid Refers to the parameter with the same name when
-          #   initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @param [String] caller_id Refers to the parameter with the same name when
-          #   initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @param [String] fallback_method Refers to the parameter with the same name when
-          #   initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @param [String] fallback_url Refers to the parameter with the same name when
-          #   initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @param [String] machine_detection Refers to the parameter with the same name
-          #   when initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   when [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @param [String] machine_detection_silence_timeout Refers to the parameter with
-          #   the same name when initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   the same name when [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @param [String] machine_detection_speech_end_threshold Refers to the parameter
-          #   with the same name when initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   with the same name when [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @param [String] machine_detection_speech_threshold Refers to the parameter with
-          #   the same name when initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   the same name when [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @param [String] machine_detection_timeout Refers to the parameter with the same
-          #   name when initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   name when [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @param [String] method Refers to the parameter with the same name when
-          #   initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @param [Boolean] record Refers to the parameter with the same name when
-          #   initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @param [String] recording_channels Refers to the parameter with the same name
-          #   when initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   when [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @param [String] recording_status_callback Refers to the parameter with the same
-          #   name when initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   name when [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @param [String] recording_status_callback_event Refers to the parameter with the
-          #   same name when initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   same name when [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @param [String] recording_status_callback_method Refers to the parameter with
-          #   the same name when initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   the same name when [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @param [String] send_digits Refers to the parameter with the same name when
-          #   initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @param [String] sip_auth_password Refers to the parameter with the same name
-          #   when initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   when [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @param [String] sip_auth_username Refers to the parameter with the same name
-          #   when initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   when [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @param [String] status_callback Refers to the parameter with the same name when
-          #   initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @param [String] status_callback_event Refers to the parameter with the same name
-          #   when initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   when [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @param [String] status_callback_method Refers to the parameter with the same
-          #   name when initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   name when [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @param [String] timeout Refers to the parameter with the same name when
-          #   initiating a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
-          # @param [String] trim Refers to the parameter with the same name when initiating
-          #   a call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
-          # @param [String] url Refers to the parameter with the same name when initiating a
-          #   call via Voice API
-          #   (https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          #   [initiating a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          # @param [String] trim Refers to the parameter with the same name when [initiating
+          #   a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
+          # @param [String] url Refers to the parameter with the same name when [initiating
+          #   a call via Voice
+          #   API](https://www.twilio.com/docs/voice/api/call#create-a-call-resource)
           # @return [PhoneCallInstance] Newly created PhoneCallInstance
           def create(from: nil, to: nil, reason: :unset, application_sid: :unset, caller_id: :unset, fallback_method: :unset, fallback_url: :unset, machine_detection: :unset, machine_detection_silence_timeout: :unset, machine_detection_speech_end_threshold: :unset, machine_detection_speech_threshold: :unset, machine_detection_timeout: :unset, method: :unset, record: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_event: :unset, recording_status_callback_method: :unset, send_digits: :unset, sip_auth_password: :unset, sip_auth_username: :unset, status_callback: :unset, status_callback_event: :unset, status_callback_method: :unset, timeout: :unset, trim: :unset, url: :unset)
             data = Twilio::Values.of({

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

@@ -29,8 +29,8 @@ module Twilio
           ##
           # Access the countries
           # @param [String] iso_country The [ISO country
-          #   code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the origin-based voice
-          #   pricing information to fetch.
+          #   code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the origin-based
+          #   voice pricing information to fetch.
           # @return [CountryList]
           # @return [CountryContext] if iso_country was passed.
           def countries(iso_country=:unset)

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

@@ -147,8 +147,8 @@ module Twilio
             # Initialize the CountryContext
             # @param [Version] version Version that contains the resource
             # @param [String] iso_country The [ISO country
-            #   code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the origin-based voice
-            #   pricing information to fetch.
+            #   code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the origin-based
+            #   voice pricing information to fetch.
             # @return [CountryContext] CountryContext
             def initialize(version, iso_country)
               super(version)
@@ -194,8 +194,8 @@ module Twilio
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
             # @param [String] iso_country The [ISO country
-            #   code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the origin-based voice
-            #   pricing information to fetch.
+            #   code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the origin-based
+            #   voice pricing information to fetch.
             # @return [CountryInstance] CountryInstance
             def initialize(version, payload, iso_country: nil)
               super(version)

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

@@ -32,7 +32,7 @@ module Twilio
             # Retrieve a single page of PhoneNumberInstance records from the API.
             # Request is executed immediately.
             # @param [String] sid The SID of a Twilio
-            #   [IncomingPhoneNumber](https://www.twilio.com/docs/phone-numbers/api/incoming-phone-numbers) resource that represents the Twilio Number you would like to assign to your Proxy Service.
+            #   [IncomingPhoneNumber](https://www.twilio.com/docs/phone-numbers/api/incomingphonenumber-resource) resource that represents the Twilio Number you would like to assign to your Proxy Service.
             # @param [String] phone_number The phone number in
             #   [E.164](https://www.twilio.com/docs/glossary/what-e164) format.  E.164 phone
             #   numbers consist of a + followed by the country code and subscriber number

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

@@ -29,7 +29,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid The unique SID identifier of this Service.
+      # @param [String] sid The unique string that we created to identify the Service
+      #   resource.
       # @return [Twilio::REST::Serverless::V1::ServiceInstance] if sid was passed.
       # @return [Twilio::REST::Serverless::V1::ServiceList]
       def services(sid=:unset)

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

@@ -19,8 +19,7 @@ module Twilio
         end
 
         ##
-        # @param [String] sid Identifier of the Serverless Service Instance. Either a SID
-        #   or UniqueName.
+        # @param [String] sid The `sid` or `unique_name` of the Service resource to fetch.
         # @return [Twilio::REST::Serverless::V1::ServiceContext] if sid was passed.
         # @return [Twilio::REST::Serverless::V1::ServiceList]
         def services(sid=:unset)

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

@@ -110,13 +110,14 @@ module Twilio
           ##
           # Retrieve a single page of ServiceInstance records from the API.
           # Request is executed immediately.
-          # @param [String] unique_name A unique, addressable name of this Service which
-          #   forms part of the domain name, fewer than 256 characters. Required.
-          # @param [String] friendly_name A human-readable description of this Service,
-          #   fewer than 256 characters. Required
-          # @param [Boolean] include_credentials A boolean value that indicates whether to
-          #   inject Account credentials into a Function invocation context. Optional, default
-          #   `false`.
+          # @param [String] unique_name An application-defined string that uniquely
+          #   identifies the Service resource. It can be used as an alternative to the `sid`
+          #   in the URL path to address the Service resource. This value must be 244
+          #   characters or less in length and be unique.
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the Service resource. It can be up to 255 characters long.
+          # @param [Boolean] include_credentials Whether to inject Account credentials into
+          #   a function invocation context. The default value is `false`.
           # @return [ServiceInstance] Newly created ServiceInstance
           def create(unique_name: nil, friendly_name: nil, include_credentials: :unset)
             data = Twilio::Values.of({
@@ -178,8 +179,7 @@ module Twilio
           ##
           # Initialize the ServiceContext
           # @param [Version] version Version that contains the resource
-          # @param [String] sid Identifier of the Serverless Service Instance. Either a SID
-          #   or UniqueName.
+          # @param [String] sid The `sid` or `unique_name` of the Service resource to fetch.
           # @return [ServiceContext] ServiceContext
           def initialize(version, sid)
             super(version)
@@ -219,10 +219,10 @@ module Twilio
 
           ##
           # Update the ServiceInstance
-          # @param [Boolean] include_credentials A boolean value that indicates whether to
-          #   inject Account credentials into a Function invocation context. Optional.
-          # @param [String] friendly_name A human-readable description of this Service,
-          #   fewer than 256 characters. Optional
+          # @param [Boolean] include_credentials Whether to inject Account credentials into
+          #   a function invocation context.
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the Service resource. It can be up to 255 characters long.
           # @return [ServiceInstance] Updated ServiceInstance
           def update(include_credentials: :unset, friendly_name: :unset)
             data = Twilio::Values.of({
@@ -333,8 +333,7 @@ module Twilio
           # Initialize the ServiceInstance
           # @param [Version] version Version that contains the resource
           # @param [Hash] payload payload that contains response from Twilio
-          # @param [String] sid Identifier of the Serverless Service Instance. Either a SID
-          #   or UniqueName.
+          # @param [String] sid The `sid` or `unique_name` of the Service resource to fetch.
           # @return [ServiceInstance] ServiceInstance
           def initialize(version, payload, sid: nil)
             super(version)
@@ -369,55 +368,55 @@ module Twilio
           end
 
           ##
-          # @return [String] Service Sid.
+          # @return [String] The unique string that identifies the Service resource
           def sid
             @properties['sid']
           end
 
           ##
-          # @return [String] Account Sid.
+          # @return [String] The SID of the Account that created the Service resource
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [String] A human-readable description of this Service.
+          # @return [String] The string that you assigned to describe the Service resource
           def friendly_name
             @properties['friendly_name']
           end
 
           ##
-          # @return [String] A unique, URL-friendly name of this Service.
+          # @return [String] An application-defined string that uniquely identifies the Service resource
           def unique_name
             @properties['unique_name']
           end
 
           ##
-          # @return [Boolean] Whether to inject Account credentials into a Function invocation context.
+          # @return [Boolean] Whether to inject Account credentials into a function invocation context
           def include_credentials
             @properties['include_credentials']
           end
 
           ##
-          # @return [Time] The date that this Service was created.
+          # @return [Time] The ISO 8601 date and time in GMT when the Service resource was created
           def date_created
             @properties['date_created']
           end
 
           ##
-          # @return [Time] The date that this Service was updated.
+          # @return [Time] The ISO 8601 date and time in GMT when the Service resource was last updated
           def date_updated
             @properties['date_updated']
           end
 
           ##
-          # @return [String] The URL of this Service.
+          # @return [String] The absolute URL of the Service resource
           def url
             @properties['url']
           end
 
           ##
-          # @return [String] Nested resource URLs.
+          # @return [String] The URLs of the Service's nested resources
           def links
             @properties['links']
           end
@@ -438,10 +437,10 @@ module Twilio
 
           ##
           # Update the ServiceInstance
-          # @param [Boolean] include_credentials A boolean value that indicates whether to
-          #   inject Account credentials into a Function invocation context. Optional.
-          # @param [String] friendly_name A human-readable description of this Service,
-          #   fewer than 256 characters. Optional
+          # @param [Boolean] include_credentials Whether to inject Account credentials into
+          #   a function invocation context.
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the Service resource. It can be up to 255 characters long.
           # @return [ServiceInstance] Updated ServiceInstance
           def update(include_credentials: :unset, friendly_name: :unset)
             context.update(include_credentials: include_credentials, friendly_name: friendly_name, )

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

@@ -17,8 +17,8 @@ module Twilio
             ##
             # Initialize the AssetList
             # @param [Version] version Version that contains the resource
-            # @param [String] service_sid The unique SID identifier of the Service for this
-            #   Asset.
+            # @param [String] service_sid The SID of the Service that the Asset resource is
+            #   associated with.
             # @return [AssetList] AssetList
             def initialize(version, service_sid: nil)
               super(version)
@@ -113,8 +113,8 @@ module Twilio
             ##
             # Retrieve a single page of AssetInstance records from the API.
             # Request is executed immediately.
-            # @param [String] friendly_name A human-readable description of this Asset, fewer
-            #   than 256 characters. Required.
+            # @param [String] friendly_name A descriptive string that you create to describe
+            #   the Asset resource. It can be up to 255 characters long.
             # @return [AssetInstance] Newly created AssetInstance
             def create(friendly_name: nil)
               data = Twilio::Values.of({'FriendlyName' => friendly_name, })
@@ -172,9 +172,9 @@ module Twilio
             ##
             # Initialize the AssetContext
             # @param [Version] version Version that contains the resource
-            # @param [String] service_sid The unique SID identifier of the Service for this
-            #   Asset.
-            # @param [String] sid The unique SID identifier of this Asset.
+            # @param [String] service_sid The SID of the Service to fetch the Asset resource
+            #   from.
+            # @param [String] sid The SID of the Asset resource to fetch.
             # @return [AssetContext] AssetContext
             def initialize(version, service_sid, sid)
               super(version)
@@ -211,8 +211,8 @@ module Twilio
 
             ##
             # Update the AssetInstance
-            # @param [String] friendly_name A human-readable description of this Asset, fewer
-            #   than 256 characters. Required.
+            # @param [String] friendly_name A descriptive string that you create to describe
+            #   the Asset resource. It can be up to 255 characters long.
             # @return [AssetInstance] Updated AssetInstance
             def update(friendly_name: nil)
               data = Twilio::Values.of({'FriendlyName' => friendly_name, })
@@ -270,9 +270,9 @@ module Twilio
             # Initialize the AssetInstance
             # @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 for this
-            #   Asset.
-            # @param [String] sid The unique SID identifier of this Asset.
+            # @param [String] service_sid The SID of the Service that the Asset resource is
+            #   associated with.
+            # @param [String] sid The SID of the Asset resource to fetch.
             # @return [AssetInstance] AssetInstance
             def initialize(version, payload, service_sid: nil, sid: nil)
               super(version)
@@ -306,49 +306,49 @@ module Twilio
             end
 
             ##
-            # @return [String] Asset Sid.
+            # @return [String] The unique string that identifies the Asset resource
             def sid
               @properties['sid']
             end
 
             ##
-            # @return [String] Account Sid.
+            # @return [String] The SID of the Account that created the Asset resource
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [String] Service Sid.
+            # @return [String] The SID of the Service that the Asset resource is associated with
             def service_sid
               @properties['service_sid']
             end
 
             ##
-            # @return [String] A human-readable description of this Asset.
+            # @return [String] The string that you assigned to describe the Asset resource
             def friendly_name
               @properties['friendly_name']
             end
 
             ##
-            # @return [Time] The date that this Asset was created.
+            # @return [Time] The ISO 8601 date and time in GMT when the Asset resource was created
             def date_created
               @properties['date_created']
             end
 
             ##
-            # @return [Time] The date that this Asset was updated.
+            # @return [Time] The ISO 8601 date and time in GMT when the Asset resource was last updated
             def date_updated
               @properties['date_updated']
             end
 
             ##
-            # @return [String] The URL of this Asset.
+            # @return [String] The absolute URL of the Asset resource
             def url
               @properties['url']
             end
 
             ##
-            # @return [String] Nested resource URLs.
+            # @return [String] The links to the nested resources of the asset
             def links
               @properties['links']
             end
@@ -369,8 +369,8 @@ module Twilio
 
             ##
             # Update the AssetInstance
-            # @param [String] friendly_name A human-readable description of this Asset, fewer
-            #   than 256 characters. Required.
+            # @param [String] friendly_name A descriptive string that you create to describe
+            #   the Asset resource. It can be up to 255 characters long.
             # @return [AssetInstance] Updated AssetInstance
             def update(friendly_name: nil)
               context.update(friendly_name: friendly_name, )