twilio-ruby 5.9.0 → 5.10.0

data/lib/twilio-ruby/rest/api/v2010/account/usage/record.rb

@@ -51,6 +51,7 @@ module Twilio
               #   date.  Format is YYYY-MM-DD.  All dates are in GMT.  As a convenience, you can
               #   also specify offsets to today.  For example, `EndDate=+30days` will make
               #   `EndDate` be 30 days from today.
+              # @param [Boolean] include_subaccounts The include_subaccounts
               # @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
@@ -58,11 +59,12 @@ module Twilio
               #    but a limit is defined, stream() will attempt to read the limit with the most
               #    efficient page size, i.e. min(limit, 1000)
               # @return [Array] Array of up to limit results
-              def list(category: :unset, start_date: :unset, end_date: :unset, limit: nil, page_size: nil)
+              def list(category: :unset, start_date: :unset, end_date: :unset, include_subaccounts: :unset, limit: nil, page_size: nil)
                 self.stream(
                     category: category,
                     start_date: start_date,
                     end_date: end_date,
+                    include_subaccounts: include_subaccounts,
                     limit: limit,
                     page_size: page_size
                 ).entries
@@ -82,6 +84,7 @@ module Twilio
               #   date.  Format is YYYY-MM-DD.  All dates are in GMT.  As a convenience, you can
               #   also specify offsets to today.  For example, `EndDate=+30days` will make
               #   `EndDate` be 30 days from today.
+              # @param [Boolean] include_subaccounts The include_subaccounts
               # @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
@@ -89,13 +92,14 @@ module Twilio
               #    but a limit is defined, stream() will attempt to read the limit with the most
               #    efficient page size, i.e. min(limit, 1000)
               # @return [Enumerable] Enumerable that will yield up to limit results
-              def stream(category: :unset, start_date: :unset, end_date: :unset, limit: nil, page_size: nil)
+              def stream(category: :unset, start_date: :unset, end_date: :unset, include_subaccounts: :unset, limit: nil, page_size: nil)
                 limits = @version.read_limits(limit, page_size)
 
                 page = self.page(
                     category: category,
                     start_date: start_date,
                     end_date: end_date,
+                    include_subaccounts: include_subaccounts,
                     page_size: limits[:page_size],
                 )
 
@@ -129,15 +133,17 @@ module Twilio
               #   date.  Format is YYYY-MM-DD.  All dates are in GMT.  As a convenience, you can
               #   also specify offsets to today.  For example, `EndDate=+30days` will make
               #   `EndDate` be 30 days from today.
+              # @param [Boolean] include_subaccounts The include_subaccounts
               # @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
               # @return [Page] Page of RecordInstance
-              def page(category: :unset, start_date: :unset, end_date: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
+              def page(category: :unset, start_date: :unset, end_date: :unset, include_subaccounts: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
                 params = Twilio::Values.of({
                     'Category' => category,
                     'StartDate' => Twilio.serialize_iso8601_date(start_date),
                     'EndDate' => Twilio.serialize_iso8601_date(end_date),
+                    'IncludeSubaccounts' => include_subaccounts,
                     'PageToken' => page_token,
                     'Page' => page_number,
                     'PageSize' => page_size,

data/lib/twilio-ruby/rest/api/v2010/account.rb

@@ -47,8 +47,8 @@ module Twilio
           # memory before returning.
           # @param [String] friendly_name Only return the Account resources with friendly
           #   names that exactly match this name.
-          # @param [String] status Only return Account resources with the given status. Can
-          #   be `closed`, `suspended` or `active`.
+          # @param [account.Status] status Only return Account resources with the given
+          #   status. Can be `closed`, `suspended` or `active`.
           # @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
@@ -71,8 +71,8 @@ module Twilio
           # is reached.
           # @param [String] friendly_name Only return the Account resources with friendly
           #   names that exactly match this name.
-          # @param [String] status Only return Account resources with the given status. Can
-          #   be `closed`, `suspended` or `active`.
+          # @param [account.Status] status Only return Account resources with the given
+          #   status. Can be `closed`, `suspended` or `active`.
           # @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
@@ -107,8 +107,8 @@ module Twilio
           # Request is executed immediately.
           # @param [String] friendly_name Only return the Account resources with friendly
           #   names that exactly match this name.
-          # @param [String] status Only return Account resources with the given status. Can
-          #   be `closed`, `suspended` or `active`.
+          # @param [account.Status] status Only return Account resources with the given
+          #   status. Can be `closed`, `suspended` or `active`.
           # @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
@@ -237,7 +237,9 @@ module Twilio
           # Update the AccountInstance
           # @param [String] friendly_name Update the human-readable description of this
           #   Account
-          # @param [String] status Alter the status of this account with a given Status
+          # @param [account.Status] status Alter the status of this account: use `closed` to
+          #   irreversibly close this account, `suspended` to temporarily suspend it, or
+          #   `active` to reactivate it.
           # @return [AccountInstance] Updated AccountInstance
           def update(friendly_name: :unset, status: :unset)
             data = Twilio::Values.of({'FriendlyName' => friendly_name, 'Status' => status, })
@@ -718,7 +720,7 @@ module Twilio
           end
 
           ##
-          # @return [String] The status of this account
+          # @return [account.Status] The status of this account
           def status
             @properties['status']
           end
@@ -752,7 +754,9 @@ module Twilio
           # Update the AccountInstance
           # @param [String] friendly_name Update the human-readable description of this
           #   Account
-          # @param [String] status Alter the status of this account with a given Status
+          # @param [account.Status] status Alter the status of this account: use `closed` to
+          #   irreversibly close this account, `suspended` to temporarily suspend it, or
+          #   `active` to reactivate it.
           # @return [AccountInstance] Updated AccountInstance
           def update(friendly_name: :unset, status: :unset)
             context.update(friendly_name: friendly_name, status: status, )

data/lib/twilio-ruby/rest/chat/v1/credential.rb

@@ -108,12 +108,18 @@ module Twilio
           ##
           # Retrieve a single page of CredentialInstance records from the API.
           # Request is executed immediately.
-          # @param [credential.PushService] type The type
-          # @param [String] friendly_name The friendly_name
-          # @param [String] certificate The certificate
-          # @param [String] private_key The private_key
-          # @param [Boolean] sandbox The sandbox
-          # @param [String] api_key The api_key
+          # @param [credential.PushService] type Credential type, one of "gcm" or "apn"
+          # @param [String] friendly_name Friendly name for stored credential
+          # @param [String] certificate [APN only] URL encoded representation of the
+          #   certificate, e.g. `-----BEGIN
+          #   CERTIFICATE-----MIIFnTCCBIWgAwIBAgIIAjy9H849+E8wDQYJKoZIhvcNAQEFBQAwgZYxCzAJBgNV.....A==-----END CERTIFICATE-----`
+          # @param [String] private_key [APN only] URL encoded representation of the private
+          #   key, e.g. `-----BEGIN RSA PRIVATE
+          #   KEY-----MIIEpQIBAAKCAQEAuyf/lNrH9ck8DmNyo3fGgvCI1l9s+cmBY3WIz+cUDqmxiieR\n.-----END RSA PRIVATE KEY-----`
+          # @param [Boolean] sandbox [APN only] use this credential for sending to
+          #   production or sandbox APNs (string `true` or `false`)
+          # @param [String] api_key [GCM only] This is the "API key" for project from Google
+          #   Developer console for your GCM Service application credential
           # @param [String] secret The secret
           # @return [CredentialInstance] Newly created CredentialInstance
           def create(type: nil, friendly_name: :unset, certificate: :unset, private_key: :unset, sandbox: :unset, api_key: :unset, secret: :unset)
@@ -203,11 +209,17 @@ module Twilio
 
           ##
           # Update the CredentialInstance
-          # @param [String] friendly_name The friendly_name
-          # @param [String] certificate The certificate
-          # @param [String] private_key The private_key
-          # @param [Boolean] sandbox The sandbox
-          # @param [String] api_key The api_key
+          # @param [String] friendly_name Friendly name for stored credential
+          # @param [String] certificate [APN only] URL encoded representation of the
+          #   certificate, e.g. `-----BEGIN
+          #   CERTIFICATE-----MIIFnTCCBIWgAwIBAgIIAjy9H849+E8wDQYJKoZIhvcNAQEFBQAwgZYxCzAJBgNV.....A==-----END CERTIFICATE-----`
+          # @param [String] private_key [APN only] URL encoded representation of the private
+          #   key, e.g. `-----BEGIN RSA PRIVATE
+          #   KEY-----MIIEpQIBAAKCAQEAuyf/lNrH9ck8DmNyo3fGgvCI1l9s+cmBY3WIz+cUDqmxiieR\n.-----END RSA PRIVATE KEY-----`
+          # @param [Boolean] sandbox [APN only] use this credential for sending to
+          #   production or sandbox APNs (string `true` or `false`)
+          # @param [String] api_key [GCM only] This is the "API key" for project from Google
+          #   Developer console for your GCM Service application credential
           # @param [String] secret The secret
           # @return [CredentialInstance] Updated CredentialInstance
           def update(friendly_name: :unset, certificate: :unset, private_key: :unset, sandbox: :unset, api_key: :unset, secret: :unset)
@@ -283,49 +295,49 @@ module Twilio
           end
 
           ##
-          # @return [String] The sid
+          # @return [String] A 34 character string that uniquely identifies this resource.
           def sid
             @properties['sid']
           end
 
           ##
-          # @return [String] The account_sid
+          # @return [String] The unique id of the Account[/console] responsible for this resource.
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [String] The friendly_name
+          # @return [String] The human-readable name of this resource.
           def friendly_name
             @properties['friendly_name']
           end
 
           ##
-          # @return [credential.PushService] The type
+          # @return [credential.PushService] Indicates which push notifications service this credential is for - either gcm or apn
           def type
             @properties['type']
           end
 
           ##
-          # @return [String] The sandbox
+          # @return [String] [APN only] true when this resource should use the sandbox APN service.
           def sandbox
             @properties['sandbox']
           end
 
           ##
-          # @return [Time] The date_created
+          # @return [Time] The date that this resource was created.
           def date_created
             @properties['date_created']
           end
 
           ##
-          # @return [Time] The date_updated
+          # @return [Time] The date that this resource was last updated.
           def date_updated
             @properties['date_updated']
           end
 
           ##
-          # @return [String] The url
+          # @return [String] An absolute URL for this credential resource.
           def url
             @properties['url']
           end
@@ -339,11 +351,17 @@ module Twilio
 
           ##
           # Update the CredentialInstance
-          # @param [String] friendly_name The friendly_name
-          # @param [String] certificate The certificate
-          # @param [String] private_key The private_key
-          # @param [Boolean] sandbox The sandbox
-          # @param [String] api_key The api_key
+          # @param [String] friendly_name Friendly name for stored credential
+          # @param [String] certificate [APN only] URL encoded representation of the
+          #   certificate, e.g. `-----BEGIN
+          #   CERTIFICATE-----MIIFnTCCBIWgAwIBAgIIAjy9H849+E8wDQYJKoZIhvcNAQEFBQAwgZYxCzAJBgNV.....A==-----END CERTIFICATE-----`
+          # @param [String] private_key [APN only] URL encoded representation of the private
+          #   key, e.g. `-----BEGIN RSA PRIVATE
+          #   KEY-----MIIEpQIBAAKCAQEAuyf/lNrH9ck8DmNyo3fGgvCI1l9s+cmBY3WIz+cUDqmxiieR\n.-----END RSA PRIVATE KEY-----`
+          # @param [Boolean] sandbox [APN only] use this credential for sending to
+          #   production or sandbox APNs (string `true` or `false`)
+          # @param [String] api_key [GCM only] This is the "API key" for project from Google
+          #   Developer console for your GCM Service application credential
           # @param [String] secret The secret
           # @return [CredentialInstance] Updated CredentialInstance
           def update(friendly_name: :unset, certificate: :unset, private_key: :unset, sandbox: :unset, api_key: :unset, secret: :unset)

data/lib/twilio-ruby/rest/chat/v1/service/channel/invite.rb

@@ -16,8 +16,11 @@ module Twilio
               ##
               # Initialize the InviteList
               # @param [Version] version Version that contains the resource
-              # @param [String] service_sid The service_sid
-              # @param [String] channel_sid The channel_sid
+              # @param [String] service_sid The unique id of the
+              #   [Service](https://www.twilio.com/docs/api/chat/rest/v1/service) this member
+              #   belongs to.
+              # @param [String] channel_sid The unique id of the
+              #   [Channel](https://www.twilio.com/docs/api/chat/rest/v1/channel) for this member.
               # @return [InviteList] InviteList
               def initialize(version, service_sid: nil, channel_sid: nil)
                 super(version)
@@ -30,8 +33,13 @@ module Twilio
               ##
               # Retrieve a single page of InviteInstance records from the API.
               # Request is executed immediately.
-              # @param [String] identity The identity
-              # @param [String] role_sid The role_sid
+              # @param [String] identity A unique string identifier for this
+              #   [User](https://www.twilio.com/docs/api/chat/rest/v1/user) in this
+              #   [Service](https://www.twilio.com/docs/api/chat/rest/v1/service). See the [access
+              #   tokens](https://www.twilio.com/docs/api/chat/guides/create-tokens)[/docs/api/chat/guides/create-tokens] docs for more details.
+              # @param [String] role_sid The
+              #   [Role](https://www.twilio.com/docs/api/chat/rest/v1/role) assigned to this
+              #   member.
               # @return [InviteInstance] Newly created InviteInstance
               def create(identity: nil, role_sid: :unset)
                 data = Twilio::Values.of({'Identity' => identity, 'RoleSid' => role_sid, })
@@ -54,7 +62,10 @@ module Twilio
               # Lists InviteInstance 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] identity A unique string identifier for this
+              #   [User](https://www.twilio.com/docs/api/chat/rest/v1/user) in this
+              #   [Service](https://www.twilio.com/docs/api/chat/rest/v1/service). See the [access
+              #   tokens](https://www.twilio.com/docs/api/chat/guides/create-tokens)[/docs/api/chat/guides/create-tokens] docs for more details.
               # @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
@@ -70,7 +81,10 @@ module Twilio
               # Streams InviteInstance 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] identity A unique string identifier for this
+              #   [User](https://www.twilio.com/docs/api/chat/rest/v1/user) in this
+              #   [Service](https://www.twilio.com/docs/api/chat/rest/v1/service). See the [access
+              #   tokens](https://www.twilio.com/docs/api/chat/guides/create-tokens)[/docs/api/chat/guides/create-tokens] docs for more details.
               # @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,7 +117,10 @@ module Twilio
               ##
               # Retrieve a single page of InviteInstance records from the API.
               # Request is executed immediately.
-              # @param [String] identity The identity
+              # @param [String] identity A unique string identifier for this
+              #   [User](https://www.twilio.com/docs/api/chat/rest/v1/user) in this
+              #   [Service](https://www.twilio.com/docs/api/chat/rest/v1/service). See the [access
+              #   tokens](https://www.twilio.com/docs/api/chat/guides/create-tokens)[/docs/api/chat/guides/create-tokens] docs for more details.
               # @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
@@ -234,8 +251,11 @@ module Twilio
               # Initialize the InviteInstance
               # @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] channel_sid The channel_sid
+              # @param [String] service_sid The unique id of the
+              #   [Service](https://www.twilio.com/docs/api/chat/rest/v1/service) this member
+              #   belongs to.
+              # @param [String] channel_sid The unique id of the
+              #   [Channel](https://www.twilio.com/docs/api/chat/rest/v1/channel) for this member.
               # @param [String] sid The sid
               # @return [InviteInstance] InviteInstance
               def initialize(version, payload, service_sid: nil, channel_sid: nil, sid: nil)
@@ -281,49 +301,49 @@ module Twilio
               end
 
               ##
-              # @return [String] The sid
+              # @return [String] A 34 character string that uniquely identifies this resource.
               def sid
                 @properties['sid']
               end
 
               ##
-              # @return [String] The account_sid
+              # @return [String] The unique id of the Account[/console] responsible for this member.
               def account_sid
                 @properties['account_sid']
               end
 
               ##
-              # @return [String] The channel_sid
+              # @return [String] The unique id of the Channel for this member.
               def channel_sid
                 @properties['channel_sid']
               end
 
               ##
-              # @return [String] The service_sid
+              # @return [String] The unique id of the Service this member belongs to.
               def service_sid
                 @properties['service_sid']
               end
 
               ##
-              # @return [String] The identity
+              # @return [String] A unique string identifier for this User in this Service.
               def identity
                 @properties['identity']
               end
 
               ##
-              # @return [Time] The date_created
+              # @return [Time] The date that this resource was created.
               def date_created
                 @properties['date_created']
               end
 
               ##
-              # @return [Time] The date_updated
+              # @return [Time] The date that this resource was last updated.
               def date_updated
                 @properties['date_updated']
               end
 
               ##
-              # @return [String] The role_sid
+              # @return [String] The Role assigned to this member.
               def role_sid
                 @properties['role_sid']
               end
@@ -335,7 +355,7 @@ module Twilio
               end
 
               ##
-              # @return [String] The url
+              # @return [String] An absolute URL for this member.
               def url
                 @properties['url']
               end

data/lib/twilio-ruby/rest/chat/v1/service/channel/member.rb

@@ -16,8 +16,12 @@ module Twilio
               ##
               # Initialize the MemberList
               # @param [Version] version Version that contains the resource
-              # @param [String] service_sid The service_sid
-              # @param [String] channel_sid The channel_sid
+              # @param [String] service_sid The unique id of the
+              #   [Service](https://www.twilio.com/docs/api/chat/rest/v1/services) this member
+              #   belongs to.
+              # @param [String] channel_sid The unique id of the
+              #   [Channel](https://www.twilio.com/docs/api/chat/rest/v1/channels) for this
+              #   member.
               # @return [MemberList] MemberList
               def initialize(version, service_sid: nil, channel_sid: nil)
                 super(version)
@@ -30,8 +34,14 @@ module Twilio
               ##
               # Retrieve a single page of MemberInstance records from the API.
               # Request is executed immediately.
-              # @param [String] identity The identity
-              # @param [String] role_sid The role_sid
+              # @param [String] identity A unique string identifier for this
+              #   [User](https://www.twilio.com/docs/api/chat/rest/v1/users) in this
+              #   [Service](https://www.twilio.com/docs/api/chat/rest/v1/services). See the
+              #   [access
+              #   tokens](https://www.twilio.com/docs/api/chat/guides/create-tokens)[/docs/api/chat/guides/create-tokens] docs for more details.
+              # @param [String] role_sid The
+              #   [Role](https://www.twilio.com/docs/api/chat/rest/v1/roles) assigned to this
+              #   member.
               # @return [MemberInstance] Newly created MemberInstance
               def create(identity: nil, role_sid: :unset)
                 data = Twilio::Values.of({'Identity' => identity, 'RoleSid' => role_sid, })
@@ -54,7 +64,11 @@ module Twilio
               # Lists MemberInstance 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] identity A unique string identifier for this
+              #   [User](https://www.twilio.com/docs/api/chat/rest/v1/users) in this
+              #   [Service](https://www.twilio.com/docs/api/chat/rest/v1/services). See the
+              #   [access
+              #   tokens](https://www.twilio.com/docs/api/chat/guides/create-tokens)[/docs/api/chat/guides/create-tokens] docs for more details.
               # @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
@@ -70,7 +84,11 @@ module Twilio
               # Streams MemberInstance 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] identity A unique string identifier for this
+              #   [User](https://www.twilio.com/docs/api/chat/rest/v1/users) in this
+              #   [Service](https://www.twilio.com/docs/api/chat/rest/v1/services). See the
+              #   [access
+              #   tokens](https://www.twilio.com/docs/api/chat/guides/create-tokens)[/docs/api/chat/guides/create-tokens] docs for more details.
               # @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,7 +121,11 @@ module Twilio
               ##
               # Retrieve a single page of MemberInstance records from the API.
               # Request is executed immediately.
-              # @param [String] identity The identity
+              # @param [String] identity A unique string identifier for this
+              #   [User](https://www.twilio.com/docs/api/chat/rest/v1/users) in this
+              #   [Service](https://www.twilio.com/docs/api/chat/rest/v1/services). See the
+              #   [access
+              #   tokens](https://www.twilio.com/docs/api/chat/guides/create-tokens)[/docs/api/chat/guides/create-tokens] docs for more details.
               # @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
@@ -223,8 +245,13 @@ module Twilio
 
               ##
               # Update the MemberInstance
-              # @param [String] role_sid The role_sid
-              # @param [String] last_consumed_message_index The last_consumed_message_index
+              # @param [String] role_sid The
+              #   [Role](https://www.twilio.com/docs/api/chat/rest/v1/roles) assigned to this
+              #   member.
+              # @param [String] last_consumed_message_index An Integer representing index of the
+              #   last [Message](https://www.twilio.com/docs/api/chat/rest/v1/messages) this
+              #   Member has read within this
+              #   [Channel](https://www.twilio.com/docs/api/chat/rest/v1/channels)
               # @return [MemberInstance] Updated MemberInstance
               def update(role_sid: :unset, last_consumed_message_index: :unset)
                 data = Twilio::Values.of({
@@ -260,8 +287,12 @@ module Twilio
               # Initialize the MemberInstance
               # @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] channel_sid The channel_sid
+              # @param [String] service_sid The unique id of the
+              #   [Service](https://www.twilio.com/docs/api/chat/rest/v1/services) this member
+              #   belongs to.
+              # @param [String] channel_sid The unique id of the
+              #   [Channel](https://www.twilio.com/docs/api/chat/rest/v1/channels) for this
+              #   member.
               # @param [String] sid The sid
               # @return [MemberInstance] MemberInstance
               def initialize(version, payload, service_sid: nil, channel_sid: nil, sid: nil)
@@ -308,67 +339,67 @@ module Twilio
               end
 
               ##
-              # @return [String] The sid
+              # @return [String] A 34 character string that uniquely identifies this resource.
               def sid
                 @properties['sid']
               end
 
               ##
-              # @return [String] The account_sid
+              # @return [String] The unique id of the Account responsible for this member.
               def account_sid
                 @properties['account_sid']
               end
 
               ##
-              # @return [String] The channel_sid
+              # @return [String] The unique id of the Channel for this member.
               def channel_sid
                 @properties['channel_sid']
               end
 
               ##
-              # @return [String] The service_sid
+              # @return [String] The unique id of the Service this member belongs to.
               def service_sid
                 @properties['service_sid']
               end
 
               ##
-              # @return [String] The identity
+              # @return [String] A unique string identifier for this User in this Service.
               def identity
                 @properties['identity']
               end
 
               ##
-              # @return [Time] The date_created
+              # @return [Time] The date that this resource was created.
               def date_created
                 @properties['date_created']
               end
 
               ##
-              # @return [Time] The date_updated
+              # @return [Time] The date that this resource was last updated.
               def date_updated
                 @properties['date_updated']
               end
 
               ##
-              # @return [String] The role_sid
+              # @return [String] The Role assigned to this member.
               def role_sid
                 @properties['role_sid']
               end
 
               ##
-              # @return [String] The last_consumed_message_index
+              # @return [String] An Integer representing index of the last Message this Member has read within this Channel
               def last_consumed_message_index
                 @properties['last_consumed_message_index']
               end
 
               ##
-              # @return [Time] The last_consumption_timestamp
+              # @return [Time] An ISO8601 based timestamp string representing the datetime of the last Message read event for this Member within this Channel
               def last_consumption_timestamp
                 @properties['last_consumption_timestamp']
               end
 
               ##
-              # @return [String] The url
+              # @return [String] An absolute URL for this member.
               def url
                 @properties['url']
               end
@@ -389,8 +420,13 @@ module Twilio
 
               ##
               # Update the MemberInstance
-              # @param [String] role_sid The role_sid
-              # @param [String] last_consumed_message_index The last_consumed_message_index
+              # @param [String] role_sid The
+              #   [Role](https://www.twilio.com/docs/api/chat/rest/v1/roles) assigned to this
+              #   member.
+              # @param [String] last_consumed_message_index An Integer representing index of the
+              #   last [Message](https://www.twilio.com/docs/api/chat/rest/v1/messages) this
+              #   Member has read within this
+              #   [Channel](https://www.twilio.com/docs/api/chat/rest/v1/channels)
               # @return [MemberInstance] Updated MemberInstance
               def update(role_sid: :unset, last_consumed_message_index: :unset)
                 context.update(role_sid: role_sid, last_consumed_message_index: last_consumed_message_index, )