twilio-ruby 5.10.0 → 5.10.1

data/lib/twilio-ruby/rest/ip_messaging/v2/service/channel/message.rb

@@ -17,8 +17,8 @@ module Twilio
               # Initialize the MessageList
               # @param [Version] version Version that contains the resource
               # @param [String] service_sid The unique id of the
-              #   [Service](https://www.twilio.com/docs/api/chat/rest/services) this message
-              #   belongs to.
+              #   [Service](https://www.twilio.com/docs/chat/api/services) this message belongs
+              #   to.
               # @param [String] channel_sid The channel_sid
               # @return [MessageList] MessageList
               def initialize(version, service_sid: nil, channel_sid: nil)
@@ -34,9 +34,11 @@ module Twilio
               # Request is executed immediately.
               # @param [String] from The
               #   [identity](https://www.twilio.com/docs/api/chat/guides/identity) of the
-              #   message's author. Defaults to `system` if not specified.
-              # @param [String] attributes A metadata field you can use to store any data you
-              #   wish.  The string value must contain structurally valid JSON if specified.
+              #   message's author. Defaults to `system`.
+              # @param [String] attributes An string metadata field you can use to store any
+              #   data you wish. The string value must contain structurally valid JSON if
+              #   specified. **Note** that this will always be null for resources returned via
+              #   LIST GET operations, but will be present for single GET operations.
               # @param [Time] date_created The ISO8601 time specifying the datetime the Message
               #   should be set as being created. Will be set to the current time by the Chat
               #   service if not specified.  Note that this should only be used in cases where a
@@ -262,9 +264,10 @@ module Twilio
               # @param [String] body The message body string. You can also send structured data
               #   by serializing it into a string. May be updated to empty string or `null`, will
               #   be set as empty string as a result in this cases.
-              # @param [String] attributes The attributes metadata field you can use to store
-              #   any data you wish.  The string value must contain structurally valid JSON if
-              #   specified.
+              # @param [String] attributes A string metadata field you can use to store any data
+              #   you wish. The string value must contain structurally valid JSON if specified.
+              #   **Note** that this will always be null for resources returned via LIST GET
+              #   operations, but will be present for single GET operations.
               # @param [Time] date_created The ISO8601 time specifying the datetime the Message
               #   should be set as being created.
               # @param [Time] date_updated The ISO8601 time specifying the datetime the Message
@@ -310,8 +313,8 @@ module Twilio
               # @param [Version] version Version that contains the resource
               # @param [Hash] payload payload that contains response from Twilio
               # @param [String] service_sid The unique id of the
-              #   [Service](https://www.twilio.com/docs/api/chat/rest/services) this message
-              #   belongs to.
+              #   [Service](https://www.twilio.com/docs/chat/api/services) this message belongs
+              #   to.
               # @param [String] channel_sid The channel_sid
               # @param [String] sid The sid
               # @return [MessageInstance] MessageInstance
@@ -376,7 +379,7 @@ module Twilio
               end
 
               ##
-              # @return [String] An optional string metadata field you can use to store any data you wish.
+              # @return [String] A string metadata field you can use to store any data you wish.
               def attributes
                 @properties['attributes']
               end
@@ -412,7 +415,7 @@ module Twilio
               end
 
               ##
-              # @return [String] Optional field to specify the Identity of the User that last updated the Message
+              # @return [String] Field to specify the Identity of the User that last updated the Message
               def last_updated_by
                 @properties['last_updated_by']
               end
@@ -430,7 +433,7 @@ module Twilio
               end
 
               ##
-              # @return [String] Optional — the contents of the message.
+              # @return [String] The contents of the message.
               def body
                 @properties['body']
               end
@@ -448,7 +451,7 @@ module Twilio
               end
 
               ##
-              # @return [Hash] Optional — if a Media resource instance is attached to the Message, this will contain the Media object for the attached Media.
+              # @return [Hash] If a Media resource instance is attached to the Message, this will contain the Media object for the attached Media.
               def media
                 @properties['media']
               end
@@ -478,9 +481,10 @@ module Twilio
               # @param [String] body The message body string. You can also send structured data
               #   by serializing it into a string. May be updated to empty string or `null`, will
               #   be set as empty string as a result in this cases.
-              # @param [String] attributes The attributes metadata field you can use to store
-              #   any data you wish.  The string value must contain structurally valid JSON if
-              #   specified.
+              # @param [String] attributes A string metadata field you can use to store any data
+              #   you wish. The string value must contain structurally valid JSON if specified.
+              #   **Note** that this will always be null for resources returned via LIST GET
+              #   operations, but will be present for single GET operations.
               # @param [Time] date_created The ISO8601 time specifying the datetime the Message
               #   should be set as being created.
               # @param [Time] date_updated The ISO8601 time specifying the datetime the Message

data/lib/twilio-ruby/rest/ip_messaging/v2/service/user/user_channel.rb

@@ -16,7 +16,9 @@ module Twilio
               ##
               # Initialize the UserChannelList
               # @param [Version] version Version that contains the resource
-              # @param [String] service_sid The service_sid
+              # @param [String] service_sid The unique id of the
+              #   [Service](https://www.twilio.com/docs/api/chat/rest/services) this channel
+              #   belongs to.
               # @param [String] user_sid A 34 character string that uniquely identifies this
               #   resource.
               # @return [UserChannelList] UserChannelList
@@ -156,7 +158,9 @@ module Twilio
               # Initialize the UserChannelInstance
               # @param [Version] version Version that contains the resource
               # @param [Hash] payload payload that contains response from Twilio
-              # @param [String] service_sid The service_sid
+              # @param [String] service_sid The unique id of the
+              #   [Service](https://www.twilio.com/docs/api/chat/rest/services) this channel
+              #   belongs to.
               # @param [String] user_sid A 34 character string that uniquely identifies this
               #   resource.
               # @return [UserChannelInstance] UserChannelInstance
@@ -177,43 +181,43 @@ module Twilio
               end
 
               ##
-              # @return [String] The account_sid
+              # @return [String] The unique id of the Account responsible for this channel.
               def account_sid
                 @properties['account_sid']
               end
 
               ##
-              # @return [String] The service_sid
+              # @return [String] The unique id of the Service this channel belongs to.
               def service_sid
                 @properties['service_sid']
               end
 
               ##
-              # @return [String] The channel_sid
+              # @return [String] The unique id of a Channel.
               def channel_sid
                 @properties['channel_sid']
               end
 
               ##
-              # @return [String] The member_sid
+              # @return [String] The unique id of this User as a Member in this Channel.
               def member_sid
                 @properties['member_sid']
               end
 
               ##
-              # @return [user_channel.ChannelStatus] The status
+              # @return [user_channel.ChannelStatus] The status of the User on this Channel.
               def status
                 @properties['status']
               end
 
               ##
-              # @return [String] The last_consumed_message_index
+              # @return [String] The index of the last read Message in this Channel for this User.
               def last_consumed_message_index
                 @properties['last_consumed_message_index']
               end
 
               ##
-              # @return [String] The unread_messages_count
+              # @return [String] The count of unread Messages in this Channel for this User.
               def unread_messages_count
                 @properties['unread_messages_count']
               end

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

@@ -30,8 +30,11 @@ module Twilio
             ##
             # Retrieve a single page of UserInstance records from the API.
             # Request is executed immediately.
-            # @param [String] identity The identity
-            # @param [String] segment The segment
+            # @param [String] identity The identifier of the User, defined by your
+            #   application.
+            # @param [String] segment The list of segments this User belongs to. Segments can
+            #   be used to select recipients of a notification. Maximum 20 Segments per User
+            #   allowed.
             # @return [UserInstance] Newly created UserInstance
             def create(identity: nil, segment: :unset)
               data = Twilio::Values.of({
@@ -52,8 +55,11 @@ module Twilio
             # Lists UserInstance records from the API as a list.
             # Unlike stream(), this operation is eager and will load `limit` records into
             # memory before returning.
-            # @param [String] identity The identity
-            # @param [String] segment The segment
+            # @param [String] identity The identifier of the User, defined by your
+            #   application.
+            # @param [String] segment The list of segments this User belongs to. Segments can
+            #   be used to select recipients of a notification. Maximum 20 Segments per User
+            #   allowed.
             # @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
@@ -69,8 +75,11 @@ module Twilio
             # Streams UserInstance records from the API as an Enumerable.
             # This operation lazily loads records as efficiently as possible until the limit
             # is reached.
-            # @param [String] identity The identity
-            # @param [String] segment The segment
+            # @param [String] identity The identifier of the User, defined by your
+            #   application.
+            # @param [String] segment The list of segments this User belongs to. Segments can
+            #   be used to select recipients of a notification. Maximum 20 Segments per User
+            #   allowed.
             # @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
@@ -103,8 +112,11 @@ module Twilio
             ##
             # Retrieve a single page of UserInstance records from the API.
             # Request is executed immediately.
-            # @param [String] identity The identity
-            # @param [String] segment The segment
+            # @param [String] identity The identifier of the User, defined by your
+            #   application.
+            # @param [String] segment The list of segments this User belongs to. Segments can
+            #   be used to select recipients of a notification. Maximum 20 Segments per User
+            #   allowed.
             # @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
@@ -342,7 +354,7 @@ module Twilio
             end
 
             ##
-            # @return [String] The identity
+            # @return [String] The identifier of the User, defined by your application.
             def identity
               @properties['identity']
             end

data/lib/twilio-ruby/rest/trunking/v1/trunk/credential_list.rb

@@ -28,7 +28,10 @@ module Twilio
             ##
             # Retrieve a single page of CredentialListInstance records from the API.
             # Request is executed immediately.
-            # @param [String] credential_list_sid The credential_list_sid
+            # @param [String] credential_list_sid The SID of the [Credential
+            #   List](https://www.twilio.com/docs/api/rest/credential-list) that you want to
+            #   associate with this trunk. Once associated, Twilio will start authenticating
+            #   access to the trunk against this list.
             # @return [CredentialListInstance] Newly created CredentialListInstance
             def create(credential_list_sid: nil)
               data = Twilio::Values.of({'CredentialListSid' => credential_list_sid, })

data/lib/twilio-ruby/rest/trunking/v1/trunk/ip_access_control_list.rb

@@ -15,7 +15,8 @@ module Twilio
             ##
             # Initialize the IpAccessControlListList
             # @param [Version] version Version that contains the resource
-            # @param [String] trunk_sid The trunk_sid
+            # @param [String] trunk_sid A 34 character string that identifies the Trunk this
+            #   resrouce is associated with.
             # @return [IpAccessControlListList] IpAccessControlListList
             def initialize(version, trunk_sid: nil)
               super(version)
@@ -28,7 +29,9 @@ module Twilio
             ##
             # Retrieve a single page of IpAccessControlListInstance records from the API.
             # Request is executed immediately.
-            # @param [String] ip_access_control_list_sid The ip_access_control_list_sid
+            # @param [String] ip_access_control_list_sid The SID of the [IP Access Control
+            #   List](https://www.twilio.com/docs/api/rest/ip-access-control-list) that you want
+            #   to associate with this trunk.
             # @return [IpAccessControlListInstance] Newly created IpAccessControlListInstance
             def create(ip_access_control_list_sid: nil)
               data = Twilio::Values.of({'IpAccessControlListSid' => ip_access_control_list_sid, })
@@ -215,7 +218,8 @@ module Twilio
             # Initialize the IpAccessControlListInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] trunk_sid The trunk_sid
+            # @param [String] trunk_sid A 34 character string that identifies the Trunk this
+            #   resrouce is associated with.
             # @param [String] sid The sid
             # @return [IpAccessControlListInstance] IpAccessControlListInstance
             def initialize(version, payload, trunk_sid: nil, sid: nil)
@@ -249,37 +253,37 @@ module Twilio
             end
 
             ##
-            # @return [String] The account_sid
+            # @return [String] The unique sid that identifies this account
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [String] The sid
+            # @return [String] A string that uniquely identifies this resource
             def sid
               @properties['sid']
             end
 
             ##
-            # @return [String] The trunk_sid
+            # @return [String] The unique sid that identifies the associated Trunk
             def trunk_sid
               @properties['trunk_sid']
             end
 
             ##
-            # @return [String] The friendly_name
+            # @return [String] A human readable description of this resource
             def friendly_name
               @properties['friendly_name']
             end
 
             ##
-            # @return [Time] The date_created
+            # @return [Time] The date this resource was created
             def date_created
               @properties['date_created']
             end
 
             ##
-            # @return [Time] The date_updated
+            # @return [Time] The date this resource was last updated
             def date_updated
               @properties['date_updated']
             end

data/lib/twilio-ruby/rest/trunking/v1/trunk.rb

@@ -39,17 +39,19 @@ module Twilio
           #   Recovery](https://www.twilio.com/docs/sip-trunking/getting-started#disaster-recovery) for more information.
           # @param [String] disaster_recovery_method The HTTP method Twilio will use when
           #   requesting the `DisasterRecoveryUrl`. Either `GET` or `POST`.
-          # @param [String] recording The recording settings for this trunk. If turned on,
-          #   all calls going through this trunk will be recorded and the recording can either
-          #   start when the call is ringing or when the call is answered. See
+          # @param [trunk.RecordingSetting] recording The recording settings for this trunk.
+          #   If turned on, all calls going through this trunk will be recorded and the
+          #   recording can either start when the call is ringing or when the call is
+          #   answered. See
           #   [Recording](https://www.twilio.com/docs/sip-trunking/getting-started#recording)
           #   for more information.
           # @param [Boolean] secure The Secure Trunking  settings for this trunk. If turned
           #   on, all calls going through this trunk will be secure using SRTP for media and
           #   TLS for signalling. If turned off, then RTP will be used for media. See [Secure
           #   Trunking](https://www.twilio.com/docs/sip-trunking/getting-started#securetrunking) for more information.
+          # @param [Boolean] cnam_lookup_enabled The cnam_lookup_enabled
           # @return [TrunkInstance] Newly created TrunkInstance
-          def create(friendly_name: :unset, domain_name: :unset, disaster_recovery_url: :unset, disaster_recovery_method: :unset, recording: :unset, secure: :unset)
+          def create(friendly_name: :unset, domain_name: :unset, disaster_recovery_url: :unset, disaster_recovery_method: :unset, recording: :unset, secure: :unset, cnam_lookup_enabled: :unset)
             data = Twilio::Values.of({
                 'FriendlyName' => friendly_name,
                 'DomainName' => domain_name,
@@ -57,6 +59,7 @@ module Twilio
                 'DisasterRecoveryMethod' => disaster_recovery_method,
                 'Recording' => recording,
                 'Secure' => secure,
+                'CnamLookupEnabled' => cnam_lookup_enabled,
             })
 
             payload = @version.create(
@@ -243,17 +246,19 @@ module Twilio
           #   Recovery](https://www.twilio.com/docs/sip-trunking/getting-started#disaster-recovery) for more information.
           # @param [String] disaster_recovery_method The HTTP method Twilio will use when
           #   requesting the `DisasterRecoveryUrl`. Either `GET` or `POST`.
-          # @param [String] recording The recording settings for this trunk. If turned on,
-          #   all calls going through this trunk will be recorded and the recording can either
-          #   start when the call is ringing or when the call is answered. See
+          # @param [trunk.RecordingSetting] recording The recording settings for this trunk.
+          #   If turned on, all calls going through this trunk will be recorded and the
+          #   recording can either start when the call is ringing or when the call is
+          #   answered. See
           #   [Recording](https://www.twilio.com/docs/sip-trunking/getting-started#recording)
           #   for more information.
           # @param [Boolean] secure The Secure Trunking  settings for this trunk. If turned
           #   on, all calls going through this trunk will be secure using SRTP for media and
           #   TLS for signalling. If turned off, then RTP will be used for media. See [Secure
           #   Trunking](https://www.twilio.com/docs/sip-trunking/getting-started#securetrunking) for more information.
+          # @param [Boolean] cnam_lookup_enabled The cnam_lookup_enabled
           # @return [TrunkInstance] Updated TrunkInstance
-          def update(friendly_name: :unset, domain_name: :unset, disaster_recovery_url: :unset, disaster_recovery_method: :unset, recording: :unset, secure: :unset)
+          def update(friendly_name: :unset, domain_name: :unset, disaster_recovery_url: :unset, disaster_recovery_method: :unset, recording: :unset, secure: :unset, cnam_lookup_enabled: :unset)
             data = Twilio::Values.of({
                 'FriendlyName' => friendly_name,
                 'DomainName' => domain_name,
@@ -261,6 +266,7 @@ module Twilio
                 'DisasterRecoveryMethod' => disaster_recovery_method,
                 'Recording' => recording,
                 'Secure' => secure,
+                'CnamLookupEnabled' => cnam_lookup_enabled,
             })
 
             payload = @version.update(
@@ -371,6 +377,7 @@ module Twilio
                 'friendly_name' => payload['friendly_name'],
                 'secure' => payload['secure'],
                 'recording' => payload['recording'],
+                'cnam_lookup_enabled' => payload['cnam_lookup_enabled'],
                 'auth_type' => payload['auth_type'],
                 'auth_type_set' => payload['auth_type_set'],
                 'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
@@ -438,6 +445,12 @@ module Twilio
             @properties['recording']
           end
 
+          ##
+          # @return [Boolean] The cnam_lookup_enabled
+          def cnam_lookup_enabled
+            @properties['cnam_lookup_enabled']
+          end
+
           ##
           # @return [String] The types of authentication you have mapped to your domain.
           def auth_type
@@ -509,17 +522,19 @@ module Twilio
           #   Recovery](https://www.twilio.com/docs/sip-trunking/getting-started#disaster-recovery) for more information.
           # @param [String] disaster_recovery_method The HTTP method Twilio will use when
           #   requesting the `DisasterRecoveryUrl`. Either `GET` or `POST`.
-          # @param [String] recording The recording settings for this trunk. If turned on,
-          #   all calls going through this trunk will be recorded and the recording can either
-          #   start when the call is ringing or when the call is answered. See
+          # @param [trunk.RecordingSetting] recording The recording settings for this trunk.
+          #   If turned on, all calls going through this trunk will be recorded and the
+          #   recording can either start when the call is ringing or when the call is
+          #   answered. See
           #   [Recording](https://www.twilio.com/docs/sip-trunking/getting-started#recording)
           #   for more information.
           # @param [Boolean] secure The Secure Trunking  settings for this trunk. If turned
           #   on, all calls going through this trunk will be secure using SRTP for media and
           #   TLS for signalling. If turned off, then RTP will be used for media. See [Secure
           #   Trunking](https://www.twilio.com/docs/sip-trunking/getting-started#securetrunking) for more information.
+          # @param [Boolean] cnam_lookup_enabled The cnam_lookup_enabled
           # @return [TrunkInstance] Updated TrunkInstance
-          def update(friendly_name: :unset, domain_name: :unset, disaster_recovery_url: :unset, disaster_recovery_method: :unset, recording: :unset, secure: :unset)
+          def update(friendly_name: :unset, domain_name: :unset, disaster_recovery_url: :unset, disaster_recovery_method: :unset, recording: :unset, secure: :unset, cnam_lookup_enabled: :unset)
             context.update(
                 friendly_name: friendly_name,
                 domain_name: domain_name,
@@ -527,6 +542,7 @@ module Twilio
                 disaster_recovery_method: disaster_recovery_method,
                 recording: recording,
                 secure: secure,
+                cnam_lookup_enabled: cnam_lookup_enabled,
             )
           end
 

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

@@ -29,9 +29,11 @@ module Twilio
           # Lists CompositionInstance records from the API as a list.
           # Unlike stream(), this operation is eager and will load `limit` records into
           # memory before returning.
-          # @param [composition.Status] status The status
-          # @param [Time] date_created_after The date_created_after
-          # @param [Time] date_created_before The date_created_before
+          # @param [composition.Status] status Only show Compositions with the given status.
+          # @param [Time] date_created_after Only show Compositions that started on or after
+          #   this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
+          # @param [Time] date_created_before Only show Compositions that started before
+          #   this this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
           # @param [String] room_sid The room_sid
           # @param [Integer] limit Upper limit for the number of records to return. stream()
           #    guarantees to never return more than limit.  Default is no limit
@@ -55,9 +57,11 @@ module Twilio
           # Streams CompositionInstance records from the API as an Enumerable.
           # This operation lazily loads records as efficiently as possible until the limit
           # is reached.
-          # @param [composition.Status] status The status
-          # @param [Time] date_created_after The date_created_after
-          # @param [Time] date_created_before The date_created_before
+          # @param [composition.Status] status Only show Compositions with the given status.
+          # @param [Time] date_created_after Only show Compositions that started on or after
+          #   this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
+          # @param [Time] date_created_before Only show Compositions that started before
+          #   this this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
           # @param [String] room_sid The room_sid
           # @param [Integer] limit Upper limit for the number of records to return. stream()
           #    guarantees to never return more than limit. Default is no limit.
@@ -97,9 +101,11 @@ module Twilio
           ##
           # Retrieve a single page of CompositionInstance records from the API.
           # Request is executed immediately.
-          # @param [composition.Status] status The status
-          # @param [Time] date_created_after The date_created_after
-          # @param [Time] date_created_before The date_created_before
+          # @param [composition.Status] status Only show Compositions with the given status.
+          # @param [Time] date_created_after Only show Compositions that started on or after
+          #   this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
+          # @param [Time] date_created_before Only show Compositions that started before
+          #   this this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
           # @param [String] room_sid The room_sid
           # @param [String] page_token PageToken provided by the API
           # @param [Integer] page_number Page Number, this value is simply for client state
@@ -215,7 +221,8 @@ module Twilio
           ##
           # Initialize the CompositionContext
           # @param [Version] version Version that contains the resource
-          # @param [String] sid The sid
+          # @param [String] sid The Composition Sid that uniquely identifies the Composition
+          #   to fetch.
           # @return [CompositionContext] CompositionContext
           def initialize(version, sid)
             super(version)
@@ -262,7 +269,8 @@ module Twilio
           # Initialize the CompositionInstance
           # @param [Version] version Version that contains the resource
           # @param [Hash] payload payload that contains response from Twilio
-          # @param [String] sid The sid
+          # @param [String] sid The Composition Sid that uniquely identifies the Composition
+          #   to fetch.
           # @return [CompositionInstance] CompositionInstance
           def initialize(version, payload, sid: nil)
             super(version)
@@ -306,79 +314,79 @@ module Twilio
           end
 
           ##
-          # @return [String] The account_sid
+          # @return [String] Twilio Account SID.
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [composition.Status] The status
+          # @return [composition.Status] The status of the Composition.
           def status
             @properties['status']
           end
 
           ##
-          # @return [Time] The date_created
+          # @return [Time] Date when the Composition Resource was created.
           def date_created
             @properties['date_created']
           end
 
           ##
-          # @return [String] The date_completed
+          # @return [String] Date when the media processing task finished.
           def date_completed
             @properties['date_completed']
           end
 
           ##
-          # @return [String] The date_deleted
+          # @return [String] Date when the Composition Resource generated media was deleted.
           def date_deleted
             @properties['date_deleted']
           end
 
           ##
-          # @return [String] The sid
+          # @return [String] A 34-character string that uniquely identifies this Composition.
           def sid
             @properties['sid']
           end
 
           ##
-          # @return [String] The room_sid
+          # @return [String] A 34-character string that uniquely identifies the source of this Composition.
           def room_sid
             @properties['room_sid']
           end
 
           ##
-          # @return [String] The audio_sources
+          # @return [String] A list of audio sources related to this Composition.
           def audio_sources
             @properties['audio_sources']
           end
 
           ##
-          # @return [String] The audio_sources_excluded
+          # @return [String] A list of audio sources excluded related to this Composition.
           def audio_sources_excluded
             @properties['audio_sources_excluded']
           end
 
           ##
-          # @return [Hash] The video_layout
+          # @return [Hash] The JSON video layout description.
           def video_layout
             @properties['video_layout']
           end
 
           ##
-          # @return [String] The resolution
+          # @return [String] Pixel resolution of the composed video.
           def resolution
             @properties['resolution']
           end
 
           ##
-          # @return [Boolean] The trim
+          # @return [Boolean] Boolean flag for clipping intervals that have no media.
           def trim
             @properties['trim']
           end
 
           ##
-          # @return [composition.Format] The format
+          # @return [composition.Format] The file format for this Composition.
           def format
             @properties['format']
           end
@@ -390,25 +398,25 @@ module Twilio
           end
 
           ##
-          # @return [String] The size
+          # @return [String] Size of the Composed media file expressed in bytes.
           def size
             @properties['size']
           end
 
           ##
-          # @return [String] The duration
+          # @return [String] Duration of the Composed media in seconds.
           def duration
             @properties['duration']
           end
 
           ##
-          # @return [String] The url
+          # @return [String] The absolute URL for this resource.
           def url
             @properties['url']
           end
 
           ##
-          # @return [String] The links
+          # @return [String] JSON object with the URL where the media file can be fetched.
           def links
             @properties['links']
           end