twilio-ruby 5.9.0 → 5.10.0

data/lib/twilio-ruby/rest/sync/v1/service/document.rb

@@ -31,11 +31,10 @@ module Twilio
             ##
             # Retrieve a single page of DocumentInstance records from the API.
             # Request is executed immediately.
-            # @param [String] unique_name (optional) Human-readable name for this document
-            # @param [Hash] data (optional) JSON data to be stored in this document
-            # @param [String] ttl (optional) Time-to-live of this Document in seconds,
-            #   defaults to no expiration. In the range [1, 31 536 000 (1 year)], or 0 for
-            #   infinity.
+            # @param [String] unique_name Human-readable name for this document
+            # @param [Hash] data JSON data to be stored in this document
+            # @param [String] ttl Time-to-live of this Document in seconds, defaults to no
+            #   expiration. In the range [1, 31 536 000 (1 year)], or 0 for infinity.
             # @return [DocumentInstance] Newly created DocumentInstance
             def create(unique_name: :unset, data: :unset, ttl: :unset)
               data = Twilio::Values.of({
@@ -217,10 +216,10 @@ module Twilio
 
             ##
             # Update the DocumentInstance
-            # @param [Hash] data (optional) Contains an arbitrary JSON object to be stored in
-            #   this Document. Serialized to string to respect HTTP form input, up to 16KB.
-            # @param [String] ttl (optional) New time-to-live of this Document in seconds. In
-            #   the range [1, 31 536 000 (1 year)], or 0 for infinity.
+            # @param [Hash] data Contains an arbitrary JSON object to be stored in this
+            #   Document. Serialized to string to respect HTTP form input, up to 16KB.
+            # @param [String] ttl New time-to-live of this Document in seconds. In the range
+            #   [1, 31 536 000 (1 year)], or 0 for infinity.
             # @return [DocumentInstance] Updated DocumentInstance
             def update(data: :unset, ttl: :unset)
               data = Twilio::Values.of({'Data' => Twilio.serialize_object(data), 'Ttl' => ttl, })
@@ -398,10 +397,10 @@ module Twilio
 
             ##
             # Update the DocumentInstance
-            # @param [Hash] data (optional) Contains an arbitrary JSON object to be stored in
-            #   this Document. Serialized to string to respect HTTP form input, up to 16KB.
-            # @param [String] ttl (optional) New time-to-live of this Document in seconds. In
-            #   the range [1, 31 536 000 (1 year)], or 0 for infinity.
+            # @param [Hash] data Contains an arbitrary JSON object to be stored in this
+            #   Document. Serialized to string to respect HTTP form input, up to 16KB.
+            # @param [String] ttl New time-to-live of this Document in seconds. In the range
+            #   [1, 31 536 000 (1 year)], or 0 for infinity.
             # @return [DocumentInstance] Updated DocumentInstance
             def update(data: :unset, ttl: :unset)
               context.update(data: data, ttl: ttl, )

data/lib/twilio-ruby/rest/sync/v1/service/sync_list/sync_list_item.rb

@@ -34,9 +34,10 @@ module Twilio
               ##
               # Retrieve a single page of SyncListItemInstance records from the API.
               # Request is executed immediately.
-              # @param [Hash] data The data
-              # @param [String] ttl (optional) Time-to-live of this item in seconds, defaults to
-              #   no expiration. In the range [1, 31 536 000 (1 year)], or 0 for infinity. Upon
+              # @param [Hash] data Contains arbitrary user-defined, schema-less data that this
+              #   List Item stores, represented by a JSON object, up to 16KB.
+              # @param [String] ttl Time-to-live of this item in seconds, defaults to no
+              #   expiration. In the range [1, 31 536 000 (1 year)], or 0 for infinity. Upon
               #   expiry, the list item will be cleaned up at least in a matter of hours, and
               #   often within seconds, making this a good tool for garbage management.
               # @return [SyncListItemInstance] Newly created SyncListItemInstance
@@ -61,11 +62,10 @@ module Twilio
               # Lists SyncListItemInstance records from the API as a list.
               # Unlike stream(), this operation is eager and will load `limit` records into
               # memory before returning.
-              # @param [sync_list_item.QueryResultOrder] order (optional) A string; `asc` or
-              #   `desc`
-              # @param [String] from (optional) An integer representing Item index offset
-              #   (inclusive). If not present, query is performed from the start or end, depending
-              #   on the Order query parameter.
+              # @param [sync_list_item.QueryResultOrder] order A string; `asc` or `desc`
+              # @param [String] from An integer representing Item index offset (inclusive). If
+              #   not present, query is performed from the start or end, depending on the Order
+              #   query parameter.
               # @param [sync_list_item.QueryFromBoundType] bounds The bounds
               # @param [Integer] limit Upper limit for the number of records to return. stream()
               #    guarantees to never return more than limit.  Default is no limit
@@ -82,11 +82,10 @@ module Twilio
               # Streams SyncListItemInstance records from the API as an Enumerable.
               # This operation lazily loads records as efficiently as possible until the limit
               # is reached.
-              # @param [sync_list_item.QueryResultOrder] order (optional) A string; `asc` or
-              #   `desc`
-              # @param [String] from (optional) An integer representing Item index offset
-              #   (inclusive). If not present, query is performed from the start or end, depending
-              #   on the Order query parameter.
+              # @param [sync_list_item.QueryResultOrder] order A string; `asc` or `desc`
+              # @param [String] from An integer representing Item index offset (inclusive). If
+              #   not present, query is performed from the start or end, depending on the Order
+              #   query parameter.
               # @param [sync_list_item.QueryFromBoundType] bounds The bounds
               # @param [Integer] limit Upper limit for the number of records to return. stream()
               #    guarantees to never return more than limit. Default is no limit.
@@ -120,11 +119,10 @@ module Twilio
               ##
               # Retrieve a single page of SyncListItemInstance records from the API.
               # Request is executed immediately.
-              # @param [sync_list_item.QueryResultOrder] order (optional) A string; `asc` or
-              #   `desc`
-              # @param [String] from (optional) An integer representing Item index offset
-              #   (inclusive). If not present, query is performed from the start or end, depending
-              #   on the Order query parameter.
+              # @param [sync_list_item.QueryResultOrder] order A string; `asc` or `desc`
+              # @param [String] from An integer representing Item index offset (inclusive). If
+              #   not present, query is performed from the start or end, depending on the Order
+              #   query parameter.
               # @param [sync_list_item.QueryFromBoundType] bounds The bounds
               # @param [String] page_token PageToken provided by the API
               # @param [Integer] page_number Page Number, this value is simply for client state
@@ -251,8 +249,12 @@ module Twilio
 
               ##
               # Update the SyncListItemInstance
-              # @param [Hash] data The data
-              # @param [String] ttl The ttl
+              # @param [Hash] data Contains arbitrary user-defined, schema-less data that this
+              #   List Item stores, represented by a JSON object, up to 16KB.
+              # @param [String] ttl Time-to-live of this item in seconds, defaults to no
+              #   expiration. In the range [1, 31 536 000 (1 year)], or 0 for infinity. Upon
+              #   expiry, the list item will be cleaned up at least in a matter of hours, and
+              #   often within seconds, making this a good tool for garbage management.
               # @return [SyncListItemInstance] Updated SyncListItemInstance
               def update(data: :unset, ttl: :unset)
                 data = Twilio::Values.of({'Data' => Twilio.serialize_object(data), 'Ttl' => ttl, })
@@ -418,8 +420,12 @@ module Twilio
 
               ##
               # Update the SyncListItemInstance
-              # @param [Hash] data The data
-              # @param [String] ttl The ttl
+              # @param [Hash] data Contains arbitrary user-defined, schema-less data that this
+              #   List Item stores, represented by a JSON object, up to 16KB.
+              # @param [String] ttl Time-to-live of this item in seconds, defaults to no
+              #   expiration. In the range [1, 31 536 000 (1 year)], or 0 for infinity. Upon
+              #   expiry, the list item will be cleaned up at least in a matter of hours, and
+              #   often within seconds, making this a good tool for garbage management.
               # @return [SyncListItemInstance] Updated SyncListItemInstance
               def update(data: :unset, ttl: :unset)
                 context.update(data: data, ttl: ttl, )

data/lib/twilio-ruby/rest/sync/v1/service/sync_list.rb

@@ -31,9 +31,9 @@ module Twilio
             ##
             # Retrieve a single page of SyncListInstance records from the API.
             # Request is executed immediately.
-            # @param [String] unique_name (optional) Human-readable name for this list
-            # @param [String] ttl (optional) Time-to-live of this List in seconds, defaults to
-            #   no expiration. In the range [1, 31 536 000 (1 year)], or 0 for infinity.
+            # @param [String] unique_name Human-readable name for this list
+            # @param [String] ttl Time-to-live of this List in seconds, defaults to no
+            #   expiration. In the range [1, 31 536 000 (1 year)], or 0 for infinity.
             # @return [SyncListInstance] Newly created SyncListInstance
             def create(unique_name: :unset, ttl: :unset)
               data = Twilio::Values.of({'UniqueName' => unique_name, 'Ttl' => ttl, })
@@ -212,7 +212,8 @@ module Twilio
 
             ##
             # Update the SyncListInstance
-            # @param [String] ttl The ttl
+            # @param [String] ttl Time-to-live of this List in seconds, defaults to no
+            #   expiration. In the range [1, 31 536 000 (1 year)], or 0 for infinity.
             # @return [SyncListInstance] Updated SyncListInstance
             def update(ttl: :unset)
               data = Twilio::Values.of({'Ttl' => ttl, })
@@ -405,7 +406,8 @@ module Twilio
 
             ##
             # Update the SyncListInstance
-            # @param [String] ttl The ttl
+            # @param [String] ttl Time-to-live of this List in seconds, defaults to no
+            #   expiration. In the range [1, 31 536 000 (1 year)], or 0 for infinity.
             # @return [SyncListInstance] Updated SyncListInstance
             def update(ttl: :unset)
               context.update(ttl: ttl, )

data/lib/twilio-ruby/rest/sync/v1/service/sync_map/sync_map_item.rb

@@ -34,10 +34,12 @@ module Twilio
               ##
               # Retrieve a single page of SyncMapItemInstance records from the API.
               # Request is executed immediately.
-              # @param [String] key The key
-              # @param [Hash] data The data
-              # @param [String] ttl (optional) Time-to-live of this Map in seconds, defaults to
-              #   no expiration. In the range [1, 31 536 000 (1 year)], or 0 for infinity.
+              # @param [String] key The unique user-defined key of this Map Item. Up to 256
+              #   characters long.
+              # @param [Hash] data Contains arbitrary user-defined, schema-less data that this
+              #   Map Item stores, represented by a JSON object, up to 16KB.
+              # @param [String] ttl Time-to-live of this Map in seconds, defaults to no
+              #   expiration. In the range [1, 31 536 000 (1 year)], or 0 for infinity.
               # @return [SyncMapItemInstance] Newly created SyncMapItemInstance
               def create(key: nil, data: nil, ttl: :unset)
                 data = Twilio::Values.of({'Key' => key, 'Data' => Twilio.serialize_object(data), 'Ttl' => ttl, })
@@ -60,8 +62,13 @@ module Twilio
               # Lists SyncMapItemInstance records from the API as a list.
               # Unlike stream(), this operation is eager and will load `limit` records into
               # memory before returning.
-              # @param [sync_map_item.QueryResultOrder] order The order
-              # @param [String] from The from
+              # @param [sync_map_item.QueryResultOrder] order A string; asc or desc. Map Items
+              #   are [ordered
+              #   lexicographically](https://en.wikipedia.org/wiki/Lexicographical_order) by Item
+              #   key.
+              # @param [String] from The Item key offset (including the specified key). If not
+              #   present, query is performed from the start or end, depending on the Order query
+              #   parameter.
               # @param [sync_map_item.QueryFromBoundType] bounds The bounds
               # @param [Integer] limit Upper limit for the number of records to return. stream()
               #    guarantees to never return more than limit.  Default is no limit
@@ -78,8 +85,13 @@ module Twilio
               # Streams SyncMapItemInstance records from the API as an Enumerable.
               # This operation lazily loads records as efficiently as possible until the limit
               # is reached.
-              # @param [sync_map_item.QueryResultOrder] order The order
-              # @param [String] from The from
+              # @param [sync_map_item.QueryResultOrder] order A string; asc or desc. Map Items
+              #   are [ordered
+              #   lexicographically](https://en.wikipedia.org/wiki/Lexicographical_order) by Item
+              #   key.
+              # @param [String] from The Item key offset (including the specified key). If not
+              #   present, query is performed from the start or end, depending on the Order query
+              #   parameter.
               # @param [sync_map_item.QueryFromBoundType] bounds The bounds
               # @param [Integer] limit Upper limit for the number of records to return. stream()
               #    guarantees to never return more than limit. Default is no limit.
@@ -113,8 +125,13 @@ module Twilio
               ##
               # Retrieve a single page of SyncMapItemInstance records from the API.
               # Request is executed immediately.
-              # @param [sync_map_item.QueryResultOrder] order The order
-              # @param [String] from The from
+              # @param [sync_map_item.QueryResultOrder] order A string; asc or desc. Map Items
+              #   are [ordered
+              #   lexicographically](https://en.wikipedia.org/wiki/Lexicographical_order) by Item
+              #   key.
+              # @param [String] from The Item key offset (including the specified key). If not
+              #   present, query is performed from the start or end, depending on the Order query
+              #   parameter.
               # @param [sync_map_item.QueryFromBoundType] bounds The bounds
               # @param [String] page_token PageToken provided by the API
               # @param [Integer] page_number Page Number, this value is simply for client state
@@ -241,8 +258,8 @@ module Twilio
 
               ##
               # Update the SyncMapItemInstance
-              # @param [Hash] data (optional) Contains an arbitrary JSON object to be stored in
-              #   this Map Item. Serialized to string to respect HTTP form input, up to 16KB.
+              # @param [Hash] data Contains an arbitrary JSON object to be stored in this Map
+              #   Item. Serialized to string to respect HTTP form input, up to 16KB.
               # @param [String] ttl New time-to-live of this Map in seconds. In the range [1, 31
               #   536 000 (1 year)], or 0 for infinity.
               # @return [SyncMapItemInstance] Updated SyncMapItemInstance
@@ -406,8 +423,8 @@ module Twilio
 
               ##
               # Update the SyncMapItemInstance
-              # @param [Hash] data (optional) Contains an arbitrary JSON object to be stored in
-              #   this Map Item. Serialized to string to respect HTTP form input, up to 16KB.
+              # @param [Hash] data Contains an arbitrary JSON object to be stored in this Map
+              #   Item. Serialized to string to respect HTTP form input, up to 16KB.
               # @param [String] ttl New time-to-live of this Map in seconds. In the range [1, 31
               #   536 000 (1 year)], or 0 for infinity.
               # @return [SyncMapItemInstance] Updated SyncMapItemInstance

data/lib/twilio-ruby/rest/sync/v1/service/sync_map.rb

@@ -31,9 +31,9 @@ module Twilio
             ##
             # Retrieve a single page of SyncMapInstance records from the API.
             # Request is executed immediately.
-            # @param [String] unique_name (optional) Human-readable name for this map
-            # @param [String] ttl (optional) Time-to-live of this Map in seconds, defaults to
-            #   no expiration. In the range [1, 31 536 000 (1 year)], or 0 for infinity.
+            # @param [String] unique_name Human-readable name for this map
+            # @param [String] ttl Time-to-live of this Map in seconds, defaults to no
+            #   expiration. In the range [1, 31 536 000 (1 year)], or 0 for infinity.
             # @return [SyncMapInstance] Newly created SyncMapInstance
             def create(unique_name: :unset, ttl: :unset)
               data = Twilio::Values.of({'UniqueName' => unique_name, 'Ttl' => ttl, })

data/lib/twilio-ruby/rest/sync/v1/service/sync_stream.rb

@@ -33,8 +33,8 @@ module Twilio
             # Request is executed immediately.
             # @param [String] unique_name The unique and addressable name of this Stream.
             #   Optional, up to 256 characters long.
-            # @param [String] ttl (optional) Time-to-live of this Stream in seconds, defaults
-            #   to no expiration. In the range [1, 31 536 000 (1 year)], or 0 for infinity.
+            # @param [String] ttl Time-to-live of this Stream in seconds, defaults to no
+            #   expiration. In the range [1, 31 536 000 (1 year)], or 0 for infinity.
             # @return [SyncStreamInstance] Newly created SyncStreamInstance
             def create(unique_name: :unset, ttl: :unset)
               data = Twilio::Values.of({'UniqueName' => unique_name, 'Ttl' => ttl, })

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

@@ -28,15 +28,14 @@ module Twilio
           ##
           # Retrieve a single page of ServiceInstance records from the API.
           # Request is executed immediately.
-          # @param [String] friendly_name (optional) Human-readable name for this service
-          #   instance
-          # @param [String] webhook_url (optional) A URL that will receive event updates
-          #   when objects are manipulated.
-          # @param [Boolean] reachability_webhooks_enabled (optional) `true` or `false` -
-          #   controls whether this instance fires webhooks when client endpoints connect to
-          #   Sync Defaults to false.
-          # @param [Boolean] acl_enabled (optional) `true` or `false` - determines whether
-          #   token identities must be granted access to Sync objects via the [Permissions
+          # @param [String] friendly_name Human-readable name for this service instance
+          # @param [String] webhook_url A URL that will receive event updates when objects
+          #   are manipulated.
+          # @param [Boolean] reachability_webhooks_enabled `true` or `false` - controls
+          #   whether this instance fires webhooks when client endpoints connect to Sync
+          #   Defaults to false.
+          # @param [Boolean] acl_enabled `true` or `false` - determines whether token
+          #   identities must be granted access to Sync objects via the [Permissions
           #   API](https://www.twilio.com/docs/api/sync/rest/sync-rest-api-permissions) in
           #   this Service.
           # @return [ServiceInstance] Newly created ServiceInstance
@@ -223,15 +222,14 @@ module Twilio
 
           ##
           # Update the ServiceInstance
-          # @param [String] webhook_url (optional) A URL that will receive event updates
-          #   when objects are manipulated.
-          # @param [String] friendly_name (optional) Human-readable name for this service
-          #   instance
-          # @param [Boolean] reachability_webhooks_enabled (optional) True or false -
-          #   controls whether this instance fires webhooks when client endpoints connect to
-          #   Sync Defaults to false.
-          # @param [Boolean] acl_enabled (optional) `true` or `false` - determines whether
-          #   token identities must be granted access to Sync objects via the [Permissions
+          # @param [String] webhook_url A URL that will receive event updates when objects
+          #   are manipulated.
+          # @param [String] friendly_name Human-readable name for this service instance
+          # @param [Boolean] reachability_webhooks_enabled True or false - controls whether
+          #   this instance fires webhooks when client endpoints connect to Sync Defaults to
+          #   false.
+          # @param [Boolean] acl_enabled `true` or `false` - determines whether token
+          #   identities must be granted access to Sync objects via the [Permissions
           #   API](https://www.twilio.com/docs/api/sync/rest/sync-rest-api-permissions) in
           #   this Service.
           # @return [ServiceInstance] Updated ServiceInstance
@@ -457,15 +455,14 @@ module Twilio
 
           ##
           # Update the ServiceInstance
-          # @param [String] webhook_url (optional) A URL that will receive event updates
-          #   when objects are manipulated.
-          # @param [String] friendly_name (optional) Human-readable name for this service
-          #   instance
-          # @param [Boolean] reachability_webhooks_enabled (optional) True or false -
-          #   controls whether this instance fires webhooks when client endpoints connect to
-          #   Sync Defaults to false.
-          # @param [Boolean] acl_enabled (optional) `true` or `false` - determines whether
-          #   token identities must be granted access to Sync objects via the [Permissions
+          # @param [String] webhook_url A URL that will receive event updates when objects
+          #   are manipulated.
+          # @param [String] friendly_name Human-readable name for this service instance
+          # @param [Boolean] reachability_webhooks_enabled True or false - controls whether
+          #   this instance fires webhooks when client endpoints connect to Sync Defaults to
+          #   false.
+          # @param [Boolean] acl_enabled `true` or `false` - determines whether token
+          #   identities must be granted access to Sync objects via the [Permissions
           #   API](https://www.twilio.com/docs/api/sync/rest/sync-rest-api-permissions) in
           #   this Service.
           # @return [ServiceInstance] Updated ServiceInstance

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

@@ -283,7 +283,7 @@ module Twilio
                 'trim' => payload['trim'],
                 'format' => payload['format'],
                 'bitrate' => payload['bitrate'].to_i,
-                'size' => payload['size'],
+                'size' => payload['size'].to_i,
                 'duration' => payload['duration'].to_i,
                 'url' => payload['url'],
                 'links' => payload['links'],

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

@@ -27,11 +27,15 @@ module Twilio
           # Lists RecordingInstance records from the API as a list.
           # Unlike stream(), this operation is eager and will load `limit` records into
           # memory before returning.
-          # @param [recording.Status] status The status
-          # @param [String] source_sid The source_sid
-          # @param [String] grouping_sid The grouping_sid
-          # @param [Time] date_created_after The date_created_after
-          # @param [Time] date_created_before The date_created_before
+          # @param [recording.Status] status Only show Recordings with the given status.
+          # @param [String] source_sid Only show the Recordings with the given source Sid
+          #   (you can use this to filter Recordings by `TrackSid` for Video Room Recordings.
+          # @param [String] grouping_sid Only show Recordings that have this GroupingSid,
+          #   which may include a ParticipantSid and/or a RoomSid.
+          # @param [Time] date_created_after Only show Recordings 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 Recordings that started before this
+          #   this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
           # @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
@@ -55,11 +59,15 @@ module Twilio
           # Streams RecordingInstance records from the API as an Enumerable.
           # This operation lazily loads records as efficiently as possible until the limit
           # is reached.
-          # @param [recording.Status] status The status
-          # @param [String] source_sid The source_sid
-          # @param [String] grouping_sid The grouping_sid
-          # @param [Time] date_created_after The date_created_after
-          # @param [Time] date_created_before The date_created_before
+          # @param [recording.Status] status Only show Recordings with the given status.
+          # @param [String] source_sid Only show the Recordings with the given source Sid
+          #   (you can use this to filter Recordings by `TrackSid` for Video Room Recordings.
+          # @param [String] grouping_sid Only show Recordings that have this GroupingSid,
+          #   which may include a ParticipantSid and/or a RoomSid.
+          # @param [Time] date_created_after Only show Recordings 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 Recordings that started before this
+          #   this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
           # @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
@@ -99,11 +107,15 @@ module Twilio
           ##
           # Retrieve a single page of RecordingInstance records from the API.
           # Request is executed immediately.
-          # @param [recording.Status] status The status
-          # @param [String] source_sid The source_sid
-          # @param [String] grouping_sid The grouping_sid
-          # @param [Time] date_created_after The date_created_after
-          # @param [Time] date_created_before The date_created_before
+          # @param [recording.Status] status Only show Recordings with the given status.
+          # @param [String] source_sid Only show the Recordings with the given source Sid
+          #   (you can use this to filter Recordings by `TrackSid` for Video Room Recordings.
+          # @param [String] grouping_sid Only show Recordings that have this GroupingSid,
+          #   which may include a ParticipantSid and/or a RoomSid.
+          # @param [Time] date_created_after Only show Recordings 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 Recordings that started before this
+          #   this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
           # @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
@@ -180,7 +192,8 @@ module Twilio
           ##
           # Initialize the RecordingContext
           # @param [Version] version Version that contains the resource
-          # @param [String] sid The sid
+          # @param [String] sid The Recording Sid that uniquely identifies the Recording to
+          #   fetch.
           # @return [RecordingContext] RecordingContext
           def initialize(version, sid)
             super(version)
@@ -225,7 +238,8 @@ module Twilio
           # Initialize the RecordingInstance
           # @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 Recording Sid that uniquely identifies the Recording to
+          #   fetch.
           # @return [RecordingInstance] RecordingInstance
           def initialize(version, payload, sid: nil)
             super(version)
@@ -237,7 +251,7 @@ module Twilio
                 'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
                 'sid' => payload['sid'],
                 'source_sid' => payload['source_sid'],
-                'size' => payload['size'],
+                'size' => payload['size'].to_i,
                 'url' => payload['url'],
                 'type' => payload['type'],
                 'duration' => payload['duration'] == nil ? payload['duration'] : payload['duration'].to_i,
@@ -265,79 +279,79 @@ module Twilio
           end
 
           ##
-          # @return [String] The account_sid
+          # @return [String] Twilio Account SID.
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [recording.Status] The status
+          # @return [recording.Status] The status of the Recording.
           def status
             @properties['status']
           end
 
           ##
-          # @return [Time] The date_created
+          # @return [Time] Date when the media recording began writing.
           def date_created
             @properties['date_created']
           end
 
           ##
-          # @return [String] The sid
+          # @return [String] A 34-character string that uniquely identifies this Recording.
           def sid
             @properties['sid']
           end
 
           ##
-          # @return [String] The source_sid
+          # @return [String] A 34-character string that uniquely identifies the source of this Recording.
           def source_sid
             @properties['source_sid']
           end
 
           ##
-          # @return [String] The size
+          # @return [String] Size of the recorded track, in bytes.
           def size
             @properties['size']
           end
 
           ##
-          # @return [String] The url
+          # @return [String] The absolute URL for this resource.
           def url
             @properties['url']
           end
 
           ##
-          # @return [recording.Type] The type
+          # @return [recording.Type] Indicates the media type for this recording.
           def type
             @properties['type']
           end
 
           ##
-          # @return [String] The duration
+          # @return [String] Duration of the Recording in seconds.
           def duration
             @properties['duration']
           end
 
           ##
-          # @return [recording.Format] The container_format
+          # @return [recording.Format] The file format for this Recording.
           def container_format
             @properties['container_format']
           end
 
           ##
-          # @return [recording.Codec] The codec
+          # @return [recording.Codec] The codec used to encode the track.
           def codec
             @properties['codec']
           end
 
           ##
-          # @return [Hash] The grouping_sids
+          # @return [Hash] A list of Sids related to this Recording.
           def grouping_sids
             @properties['grouping_sids']
           end
 
           ##
-          # @return [String] The track_name
+          # @return [String] The name that was given to the source track of this recording.
           def track_name
             @properties['track_name']
           end