twilio-ruby 5.27.0 → 5.27.1

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

@@ -17,8 +17,9 @@ module Twilio
             ##
             # Initialize the AlphaSenderList
             # @param [Version] version Version that contains the resource
-            # @param [String] service_sid The 34 character unique sid of the Messaging
-            #   Service.
+            # @param [String] service_sid The SID of the
+            #   [Service](https://www.twilio.com/docs/chat/rest/service-resource) the resource
+            #   is associated with.
             # @return [AlphaSenderList] AlphaSenderList
             def initialize(version, service_sid: nil)
               super(version)
@@ -31,9 +32,9 @@ module Twilio
             ##
             # Retrieve a single page of AlphaSenderInstance records from the API.
             # Request is executed immediately.
-            # @param [String] alpha_sender An Alphanumeric Sender ID string, up to 11
-            #   characters. Valid characters are A-Z, a-z, 0-9, space and dash ( - ). An
-            #   Alphanumeric Sender ID string cannot be comprised of only numbers.
+            # @param [String] alpha_sender The Alphanumeric Sender ID string. Can be up to 11
+            #   characters long. Valid characters are A-Z, a-z, 0-9, space, and hyphen `-`. This
+            #   value cannot contain only numbers.
             # @return [AlphaSenderInstance] Newly created AlphaSenderInstance
             def create(alpha_sender: nil)
               data = Twilio::Values.of({'AlphaSender' => alpha_sender, })
@@ -173,8 +174,10 @@ module Twilio
             ##
             # Initialize the AlphaSenderContext
             # @param [Version] version Version that contains the resource
-            # @param [String] service_sid The service_sid
-            # @param [String] sid The sid
+            # @param [String] service_sid The SID of the
+            #   [Service](https://www.twilio.com/docs/chat/rest/service-resource) to fetch the
+            #   resource from.
+            # @param [String] sid The SID of the AlphaSender resource to fetch.
             # @return [AlphaSenderContext] AlphaSenderContext
             def initialize(version, service_sid, sid)
               super(version)
@@ -233,9 +236,10 @@ module Twilio
             # Initialize the AlphaSenderInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] service_sid The 34 character unique sid of the Messaging
-            #   Service.
-            # @param [String] sid The sid
+            # @param [String] service_sid The SID of the
+            #   [Service](https://www.twilio.com/docs/chat/rest/service-resource) the resource
+            #   is associated with.
+            # @param [String] sid The SID of the AlphaSender resource to fetch.
             # @return [AlphaSenderInstance] AlphaSenderInstance
             def initialize(version, payload, service_sid: nil, sid: nil)
               super(version)
@@ -269,49 +273,49 @@ module Twilio
             end
 
             ##
-            # @return [String] The 34 character unique sid of the Alpha Sender ID.
+            # @return [String] The unique string that identifies the resource
             def sid
               @properties['sid']
             end
 
             ##
-            # @return [String] The 34 character unique sid of the Account.
+            # @return [String] The SID of the Account that created the resource
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [String] The 34 character unique sid of the Messaging Service.
+            # @return [String] The SID of the Service that the resource is associated with
             def service_sid
               @properties['service_sid']
             end
 
             ##
-            # @return [Time] The date that this 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 date that this 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
 
             ##
-            # @return [String] An Alphanumeric Sender ID string, up to 11 characters.
+            # @return [String] The Alphanumeric Sender ID string
             def alpha_sender
               @properties['alpha_sender']
             end
 
             ##
-            # @return [Hash] An array of values that indicate whether the number can receive calls or messages.
+            # @return [Hash] An array of values that describe whether the number can receive calls or messages
             def capabilities
               @properties['capabilities']
             end
 
             ##
-            # @return [String] The absolute URL for this resource.
+            # @return [String] The absolute URL of the AlphaSender resource
             def url
               @properties['url']
             end

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

@@ -17,7 +17,9 @@ module Twilio
             ##
             # Initialize the PhoneNumberList
             # @param [Version] version Version that contains the resource
-            # @param [String] service_sid The 34 character unique sid of the Service.
+            # @param [String] service_sid The SID of the
+            #   [Service](https://www.twilio.com/docs/chat/rest/service-resource) the resource
+            #   is associated with.
             # @return [PhoneNumberList] PhoneNumberList
             def initialize(version, service_sid: nil)
               super(version)
@@ -30,8 +32,8 @@ module Twilio
             ##
             # Retrieve a single page of PhoneNumberInstance records from the API.
             # Request is executed immediately.
-            # @param [String] phone_number_sid Phone Number SID for the Phone Number being
-            #   added to the Service.
+            # @param [String] phone_number_sid The SID of the Phone Number being added to the
+            #   Service.
             # @return [PhoneNumberInstance] Newly created PhoneNumberInstance
             def create(phone_number_sid: nil)
               data = Twilio::Values.of({'PhoneNumberSid' => phone_number_sid, })
@@ -171,8 +173,10 @@ module Twilio
             ##
             # Initialize the PhoneNumberContext
             # @param [Version] version Version that contains the resource
-            # @param [String] service_sid The service_sid
-            # @param [String] sid The sid
+            # @param [String] service_sid The SID of the
+            #   [Service](https://www.twilio.com/docs/chat/rest/service-resource) to fetch the
+            #   resource from.
+            # @param [String] sid The SID of the PhoneNumber resource to fetch.
             # @return [PhoneNumberContext] PhoneNumberContext
             def initialize(version, service_sid, sid)
               super(version)
@@ -231,8 +235,10 @@ module Twilio
             # Initialize the PhoneNumberInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] service_sid The 34 character unique sid of the Service.
-            # @param [String] sid The sid
+            # @param [String] service_sid The SID of the
+            #   [Service](https://www.twilio.com/docs/chat/rest/service-resource) the resource
+            #   is associated with.
+            # @param [String] sid The SID of the PhoneNumber resource to fetch.
             # @return [PhoneNumberInstance] PhoneNumberInstance
             def initialize(version, payload, service_sid: nil, sid: nil)
               super(version)
@@ -267,55 +273,55 @@ module Twilio
             end
 
             ##
-            # @return [String] The 34 character unique sid of the Phone Number.
+            # @return [String] The unique string that identifies the resource
             def sid
               @properties['sid']
             end
 
             ##
-            # @return [String] The 34 character unique sid of the Account.
+            # @return [String] The SID of the Account that created the resource
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [String] The 34 character unique sid of the Service.
+            # @return [String] The SID of the Service that the resource is associated with
             def service_sid
               @properties['service_sid']
             end
 
             ##
-            # @return [Time] The date that this 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 date that this 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
 
             ##
-            # @return [String] The E.
+            # @return [String] The phone number in E.164 format
             def phone_number
               @properties['phone_number']
             end
 
             ##
-            # @return [String] The 2 character ISO Country Code of the number.
+            # @return [String] The 2-character ISO Country Code of the number
             def country_code
               @properties['country_code']
             end
 
             ##
-            # @return [String] Any array of values that indicate whether the number can receive calls or messages.
+            # @return [String] An array of values that describe whether the number can receive calls or messages
             def capabilities
               @properties['capabilities']
             end
 
             ##
-            # @return [String] The absolute URL for this resource.
+            # @return [String] The absolute URL of the PhoneNumber resource
             def url
               @properties['url']
             end

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

@@ -18,8 +18,8 @@ module Twilio
             # Initialize the ShortCodeList
             # @param [Version] version Version that contains the resource
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/api/chat/rest/services) this resource is
-            #   associated with.
+            #   [Service](https://www.twilio.com/docs/chat/rest/service-resource) the resource
+            #   is associated with.
             # @return [ShortCodeList] ShortCodeList
             def initialize(version, service_sid: nil)
               super(version)
@@ -32,8 +32,8 @@ module Twilio
             ##
             # Retrieve a single page of ShortCodeInstance records from the API.
             # Request is executed immediately.
-            # @param [String] short_code_sid SID of the ShortCode resource being added to the
-            #   Service.
+            # @param [String] short_code_sid The SID of the ShortCode resource being added to
+            #   the Service.
             # @return [ShortCodeInstance] Newly created ShortCodeInstance
             def create(short_code_sid: nil)
               data = Twilio::Values.of({'ShortCodeSid' => short_code_sid, })
@@ -174,10 +174,9 @@ module Twilio
             # Initialize the ShortCodeContext
             # @param [Version] version Version that contains the resource
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/api/chat/rest/services) to fetch the
+            #   [Service](https://www.twilio.com/docs/chat/rest/service-resource) to fetch the
             #   resource from.
-            # @param [String] sid The Twilio-provided string that uniquely identifies the
-            #   ShortCode resource to fetch
+            # @param [String] sid The SID of the ShortCode resource to fetch.
             # @return [ShortCodeContext] ShortCodeContext
             def initialize(version, service_sid, sid)
               super(version)
@@ -232,10 +231,9 @@ module Twilio
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/api/chat/rest/services) this resource is
-            #   associated with.
-            # @param [String] sid The Twilio-provided string that uniquely identifies the
-            #   ShortCode resource to fetch
+            #   [Service](https://www.twilio.com/docs/chat/rest/service-resource) the resource
+            #   is associated with.
+            # @param [String] sid The SID of the ShortCode resource to fetch.
             # @return [ShortCodeInstance] ShortCodeInstance
             def initialize(version, payload, service_sid: nil, sid: nil)
               super(version)
@@ -270,55 +268,55 @@ module Twilio
             end
 
             ##
-            # @return [String] The unique string that identifies this resource
+            # @return [String] The unique string that identifies the resource
             def sid
               @properties['sid']
             end
 
             ##
-            # @return [String] The SID of the Account that created this resource
+            # @return [String] The SID of the Account that created the resource
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [String] The SID of the Service that this resource is associated with
+            # @return [String] The SID of the Service that the resource is associated with
             def service_sid
               @properties['service_sid']
             end
 
             ##
-            # @return [Time] The RFC 2822 date and time in GMT that this 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 that this 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
 
             ##
-            # @return [String] The E.164 format of the short code.
+            # @return [String] The E.164 format of the short code
             def short_code
               @properties['short_code']
             end
 
             ##
-            # @return [String] The 2-character ISO Country Code of the number.
+            # @return [String] The 2-character ISO Country Code of the number
             def country_code
               @properties['country_code']
             end
 
             ##
-            # @return [Hash] Any array of values that indicate whether the number can receive calls or messages.
+            # @return [Hash] An array of values that describe whether the number can receive calls or messages
             def capabilities
               @properties['capabilities']
             end
 
             ##
-            # @return [String] The absolute URL of this ShortCode resource
+            # @return [String] The absolute URL of the ShortCode resource
             def url
               @properties['url']
             end

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

@@ -28,17 +28,19 @@ module Twilio
           ##
           # Retrieve a single page of SessionInstance records from the API.
           # Request is executed immediately.
-          # @param [String] messaging_service_sid The unique id of the [SMS
-          #   Service](https://www.twilio.com/docs/sms/services/api) this session belongs to.
-          # @param [String] friendly_name The human-readable name of this session. Optional.
-          # @param [String] attributes An optional string metadata field you can use to
-          #   store any data you wish. The string value must contain structurally valid JSON
-          #   if specified.  **Note** that if the attributes are not set "{}" will be
-          #   returned.
-          # @param [Time] date_created The date that this resource was created.
-          # @param [Time] date_updated The date that this resource was last updated.
-          # @param [String] created_by Identity of the session's creator. If the Session was
-          #   created through the API, the value will be `system`
+          # @param [String] messaging_service_sid The SID of the [Messaging
+          #   Service](https://www.twilio.com/docs/sms/services/api) the session belongs to.
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the resource. It can be up to 64 characters long.
+          # @param [String] attributes A JSON string that stores application-specific data.
+          # @param [Time] date_created The date, specified in [ISO
+          #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
+          #   as the date it was created.
+          # @param [Time] date_updated The date, specified in [ISO
+          #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
+          #   as the date it was last updated.
+          # @param [String] created_by The Identity of the session's creator. If the Session
+          #   was created through the API, the value will be `system`
           # @return [SessionInstance] Newly created SessionInstance
           def create(messaging_service_sid: nil, friendly_name: :unset, attributes: :unset, date_created: :unset, date_updated: :unset, created_by: :unset)
             data = Twilio::Values.of({
@@ -185,8 +187,7 @@ module Twilio
           ##
           # Initialize the SessionContext
           # @param [Version] version Version that contains the resource
-          # @param [String] sid A 34 character string that uniquely identifies this
-          #   resource.
+          # @param [String] sid The SID of the Session resource to fetch.
           # @return [SessionContext] SessionContext
           def initialize(version, sid)
             super(version)
@@ -225,15 +226,17 @@ module Twilio
 
           ##
           # Update the SessionInstance
-          # @param [String] friendly_name The human-readable name of this session. Optional.
-          # @param [String] attributes An optional string metadata field you can use to
-          #   store any data you wish. The string value must contain structurally valid JSON
-          #   if specified.  **Note** that if the attributes are not set "{}" will be
-          #   returned.
-          # @param [Time] date_created The date that this resource was created.
-          # @param [Time] date_updated The date that this resource was last updated.
-          # @param [String] created_by Identity of the session's creator. If the Session was
-          #   created through the API, the value will be `system`
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the resource. It can be up to 64 characters long.
+          # @param [String] attributes A JSON string that stores application-specific data.
+          # @param [Time] date_created The date, specified in [ISO
+          #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
+          #   as the date it was created.
+          # @param [Time] date_updated The date, specified in [ISO
+          #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
+          #   as the date it was last updated.
+          # @param [String] created_by The Identity of the session's creator. If the Session
+          #   was created through the API, the value will be `system`
           # @return [SessionInstance] Updated SessionInstance
           def update(friendly_name: :unset, attributes: :unset, date_created: :unset, date_updated: :unset, created_by: :unset)
             data = Twilio::Values.of({
@@ -329,8 +332,7 @@ module Twilio
           # Initialize the SessionInstance
           # @param [Version] version Version that contains the resource
           # @param [Hash] payload payload that contains response from Twilio
-          # @param [String] sid A 34 character string that uniquely identifies this
-          #   resource.
+          # @param [String] sid The SID of the Session resource to fetch.
           # @return [SessionInstance] SessionInstance
           def initialize(version, payload, sid: nil)
             super(version)
@@ -367,67 +369,67 @@ module Twilio
           end
 
           ##
-          # @return [String] A 34 character string that uniquely identifies this resource.
+          # @return [String] The unique string that identifies the resource
           def sid
             @properties['sid']
           end
 
           ##
-          # @return [String] The unique id of the Account responsible for this session.
+          # @return [String] The SID of the Account that created the resource
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [String] The unique id of the Chat Service this session belongs to.
+          # @return [String] The SID of the Service that the resource is associated with
           def service_sid
             @properties['service_sid']
           end
 
           ##
-          # @return [String] The unique id of the SMS Service this session belongs to.
+          # @return [String] The SID of the SMS Service the session belongs to
           def messaging_service_sid
             @properties['messaging_service_sid']
           end
 
           ##
-          # @return [String] The human-readable name of this session.
+          # @return [String] The string that you assigned to describe the resource
           def friendly_name
             @properties['friendly_name']
           end
 
           ##
-          # @return [String] An optional string metadata field you can use to store any data you wish.
+          # @return [String] The JSON string that stores application-specific data
           def attributes
             @properties['attributes']
           end
 
           ##
-          # @return [String] Identity of the session's creator.
+          # @return [String] The Identity of the session's creator
           def created_by
             @properties['created_by']
           end
 
           ##
-          # @return [Time] The date that this 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 date that this 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
 
           ##
-          # @return [String] An absolute URL for this session.
+          # @return [String] The absolute URL of the session
           def url
             @properties['url']
           end
 
           ##
-          # @return [String] Absolute URLs to access the Participants and Messages for this Session.
+          # @return [String] The absolute URLs of the Participants, Interactions, and Messages for the Session
           def links
             @properties['links']
           end
@@ -448,15 +450,17 @@ module Twilio
 
           ##
           # Update the SessionInstance
-          # @param [String] friendly_name The human-readable name of this session. Optional.
-          # @param [String] attributes An optional string metadata field you can use to
-          #   store any data you wish. The string value must contain structurally valid JSON
-          #   if specified.  **Note** that if the attributes are not set "{}" will be
-          #   returned.
-          # @param [Time] date_created The date that this resource was created.
-          # @param [Time] date_updated The date that this resource was last updated.
-          # @param [String] created_by Identity of the session's creator. If the Session was
-          #   created through the API, the value will be `system`
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the resource. It can be up to 64 characters long.
+          # @param [String] attributes A JSON string that stores application-specific data.
+          # @param [Time] date_created The date, specified in [ISO
+          #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
+          #   as the date it was created.
+          # @param [Time] date_updated The date, specified in [ISO
+          #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
+          #   as the date it was last updated.
+          # @param [String] created_by The Identity of the session's creator. If the Session
+          #   was created through the API, the value will be `system`
           # @return [SessionInstance] Updated SessionInstance
           def update(friendly_name: :unset, attributes: :unset, date_created: :unset, date_updated: :unset, created_by: :unset)
             context.update(