twilio-ruby 5.25.4 → 5.26.0

data/lib/twilio-ruby/rest/chat/v2/service.rb

@@ -163,8 +163,7 @@ module Twilio
           ##
           # Initialize the ServiceContext
           # @param [Version] version Version that contains the resource
-          # @param [String] sid The Twilio-provided string that uniquely identifies the
-          #   Service resource to fetch.
+          # @param [String] sid The SID of the Service resource to fetch.
           # @return [ServiceContext] ServiceContext
           def initialize(version, sid)
             super(version)
@@ -197,7 +196,7 @@ module Twilio
 
           ##
           # Deletes the ServiceInstance
-          # @return [Boolean] true if delete succeeds, true otherwise
+          # @return [Boolean] true if delete succeeds, false otherwise
           def delete
             @version.delete('delete', @uri)
           end
@@ -207,14 +206,14 @@ module Twilio
           # @param [String] friendly_name A descriptive string that you create to describe
           #   the resource.
           # @param [String] default_service_role_sid The service role assigned to users when
-          #   they are added to the service. See the [Roles
-          #   endpoint](https://www.twilio.com/docs/chat/api/roles) for more details.
+          #   they are added to the service. See the [Role
+          #   resource](https://www.twilio.com/docs/chat/api/roles) for more info about roles.
           # @param [String] default_channel_role_sid The channel role assigned to users when
-          #   they are added to a channel. See the [Roles
-          #   endpoint](https://www.twilio.com/docs/chat/api/roles) for more details.
+          #   they are added to a channel. See the [Role
+          #   resource](https://www.twilio.com/docs/chat/api/roles) for more info about roles.
           # @param [String] default_channel_creator_role_sid The channel role assigned to a
-          #   channel creator when they join a new channel. See the [Roles
-          #   endpoint](https://www.twilio.com/docs/chat/api/roles) for more details.
+          #   channel creator when they join a new channel. See the [Role
+          #   resource](https://www.twilio.com/docs/chat/api/roles) for more info about roles.
           # @param [Boolean] read_status_enabled Whether to enable the [Message Consumption
           #   Horizon](https://www.twilio.com/docs/chat/consumption-horizon) feature. The
           #   default is `true`.
@@ -227,8 +226,7 @@ module Twilio
           # @param [String] consumption_report_interval DEPRECATED. The interval in seconds
           #   between consumption reports submission batches from client endpoints.
           # @param [Boolean] notifications_new_message_enabled Whether to send a
-          #   notification when a new message is added to a channel. Can be: `true` or `false`
-          #   and the default is `false`.
+          #   notification when a new message is added to a channel. The default is `false`.
           # @param [String] notifications_new_message_template The template to use to create
           #   the notification text displayed when a new message is added to a channel and
           #   `notifications.new_message.enabled` is `true`.
@@ -236,10 +234,9 @@ module Twilio
           #   when a new message is added to a channel and `notifications.new_message.enabled`
           #   is `true`.
           # @param [Boolean] notifications_new_message_badge_count_enabled Whether the new
-          #   message badge is enabled. Can be: `true` or `false` and the default is `false`.
+          #   message badge is enabled. The default is `false`.
           # @param [Boolean] notifications_added_to_channel_enabled Whether to send a
-          #   notification when a member is added to a channel. Can be: `true` or `false` and
-          #   the default is `false`.
+          #   notification when a member is added to a channel. The default is `false`.
           # @param [String] notifications_added_to_channel_template The template to use to
           #   create the notification text displayed when a member is added to a channel and
           #   `notifications.added_to_channel.enabled` is `true`.
@@ -247,8 +244,8 @@ module Twilio
           #   play when a member is added to a channel and
           #   `notifications.added_to_channel.enabled` is `true`.
           # @param [Boolean] notifications_removed_from_channel_enabled Whether to send a
-          #   notification to a user when they are removed from a channel. Can be: `true` or
-          #   `false` and the default is `false`.
+          #   notification to a user when they are removed from a channel. The default is
+          #   `false`.
           # @param [String] notifications_removed_from_channel_template The template to use
           #   to create the notification text displayed to a user when they are removed from a
           #   channel and `notifications.removed_from_channel.enabled` is `true`.
@@ -256,8 +253,7 @@ module Twilio
           #   to play to a user when they are removed from a channel and
           #   `notifications.removed_from_channel.enabled` is `true`.
           # @param [Boolean] notifications_invited_to_channel_enabled Whether to send a
-          #   notification when a user is invited to a channel. Can be: `true` or `false` and
-          #   the default is `false`.
+          #   notification when a user is invited to a channel. The default is `false`.
           # @param [String] notifications_invited_to_channel_template The template to use to
           #   create the notification text displayed when a user is invited to a channel and
           #   `notifications.invited_to_channel.enabled` is `true`.
@@ -274,7 +270,7 @@ module Twilio
           #   `pre_webhook_url` and `post_webhook_url` webhooks.  Can be: `POST` or `GET` and
           #   the default is `POST`. See [Webhook
           #   Events](https://www.twilio.com/docs/chat/webhook-events) for more details.
-          # @param [String] webhook_filters The list of WebHook events that are enabled for
+          # @param [String] webhook_filters The list of webhook events that are enabled for
           #   this Service instance. See [Webhook
           #   Events](https://www.twilio.com/docs/chat/webhook-events) for more details.
           # @param [String] limits_channel_members The maximum number of Members that can be
@@ -291,8 +287,8 @@ module Twilio
           #   the `post_webhook_url` if the request times out (after 5 seconds) or it receives
           #   a 429, 503, or 504 HTTP response. The default is 0, which means the call won't
           #   be retried.
-          # @param [Boolean] notifications_log_enabled Whether to log notifications. Can be:
-          #   `true` or `false` and the default is `false`.
+          # @param [Boolean] notifications_log_enabled Whether to log notifications. The
+          #   default is `false`.
           # @return [ServiceInstance] Updated ServiceInstance
           def update(friendly_name: :unset, default_service_role_sid: :unset, default_channel_role_sid: :unset, default_channel_creator_role_sid: :unset, read_status_enabled: :unset, reachability_enabled: :unset, typing_indicator_timeout: :unset, consumption_report_interval: :unset, notifications_new_message_enabled: :unset, notifications_new_message_template: :unset, notifications_new_message_sound: :unset, notifications_new_message_badge_count_enabled: :unset, notifications_added_to_channel_enabled: :unset, notifications_added_to_channel_template: :unset, notifications_added_to_channel_sound: :unset, notifications_removed_from_channel_enabled: :unset, notifications_removed_from_channel_template: :unset, notifications_removed_from_channel_sound: :unset, notifications_invited_to_channel_enabled: :unset, notifications_invited_to_channel_template: :unset, notifications_invited_to_channel_sound: :unset, pre_webhook_url: :unset, post_webhook_url: :unset, webhook_method: :unset, webhook_filters: :unset, limits_channel_members: :unset, limits_user_channels: :unset, media_compatibility_message: :unset, pre_webhook_retry_count: :unset, post_webhook_retry_count: :unset, notifications_log_enabled: :unset)
             data = Twilio::Values.of({
@@ -430,8 +426,7 @@ module Twilio
           # Initialize the ServiceInstance
           # @param [Version] version Version that contains the resource
           # @param [Hash] payload payload that contains response from Twilio
-          # @param [String] sid The Twilio-provided string that uniquely identifies the
-          #   Service resource to fetch.
+          # @param [String] sid The SID of the Service resource to fetch.
           # @return [ServiceInstance] ServiceInstance
           def initialize(version, payload, sid: nil)
             super(version)
@@ -576,7 +571,7 @@ module Twilio
           end
 
           ##
-          # @return [String] The list of WebHook events that are enabled for this Service instance
+          # @return [String] The list of webhook events that are enabled for this Service instance
           def webhook_filters
             @properties['webhook_filters']
           end
@@ -626,7 +621,7 @@ module Twilio
 
           ##
           # Deletes the ServiceInstance
-          # @return [Boolean] true if delete succeeds, true otherwise
+          # @return [Boolean] true if delete succeeds, false otherwise
           def delete
             context.delete
           end
@@ -636,14 +631,14 @@ module Twilio
           # @param [String] friendly_name A descriptive string that you create to describe
           #   the resource.
           # @param [String] default_service_role_sid The service role assigned to users when
-          #   they are added to the service. See the [Roles
-          #   endpoint](https://www.twilio.com/docs/chat/api/roles) for more details.
+          #   they are added to the service. See the [Role
+          #   resource](https://www.twilio.com/docs/chat/api/roles) for more info about roles.
           # @param [String] default_channel_role_sid The channel role assigned to users when
-          #   they are added to a channel. See the [Roles
-          #   endpoint](https://www.twilio.com/docs/chat/api/roles) for more details.
+          #   they are added to a channel. See the [Role
+          #   resource](https://www.twilio.com/docs/chat/api/roles) for more info about roles.
           # @param [String] default_channel_creator_role_sid The channel role assigned to a
-          #   channel creator when they join a new channel. See the [Roles
-          #   endpoint](https://www.twilio.com/docs/chat/api/roles) for more details.
+          #   channel creator when they join a new channel. See the [Role
+          #   resource](https://www.twilio.com/docs/chat/api/roles) for more info about roles.
           # @param [Boolean] read_status_enabled Whether to enable the [Message Consumption
           #   Horizon](https://www.twilio.com/docs/chat/consumption-horizon) feature. The
           #   default is `true`.
@@ -656,8 +651,7 @@ module Twilio
           # @param [String] consumption_report_interval DEPRECATED. The interval in seconds
           #   between consumption reports submission batches from client endpoints.
           # @param [Boolean] notifications_new_message_enabled Whether to send a
-          #   notification when a new message is added to a channel. Can be: `true` or `false`
-          #   and the default is `false`.
+          #   notification when a new message is added to a channel. The default is `false`.
           # @param [String] notifications_new_message_template The template to use to create
           #   the notification text displayed when a new message is added to a channel and
           #   `notifications.new_message.enabled` is `true`.
@@ -665,10 +659,9 @@ module Twilio
           #   when a new message is added to a channel and `notifications.new_message.enabled`
           #   is `true`.
           # @param [Boolean] notifications_new_message_badge_count_enabled Whether the new
-          #   message badge is enabled. Can be: `true` or `false` and the default is `false`.
+          #   message badge is enabled. The default is `false`.
           # @param [Boolean] notifications_added_to_channel_enabled Whether to send a
-          #   notification when a member is added to a channel. Can be: `true` or `false` and
-          #   the default is `false`.
+          #   notification when a member is added to a channel. The default is `false`.
           # @param [String] notifications_added_to_channel_template The template to use to
           #   create the notification text displayed when a member is added to a channel and
           #   `notifications.added_to_channel.enabled` is `true`.
@@ -676,8 +669,8 @@ module Twilio
           #   play when a member is added to a channel and
           #   `notifications.added_to_channel.enabled` is `true`.
           # @param [Boolean] notifications_removed_from_channel_enabled Whether to send a
-          #   notification to a user when they are removed from a channel. Can be: `true` or
-          #   `false` and the default is `false`.
+          #   notification to a user when they are removed from a channel. The default is
+          #   `false`.
           # @param [String] notifications_removed_from_channel_template The template to use
           #   to create the notification text displayed to a user when they are removed from a
           #   channel and `notifications.removed_from_channel.enabled` is `true`.
@@ -685,8 +678,7 @@ module Twilio
           #   to play to a user when they are removed from a channel and
           #   `notifications.removed_from_channel.enabled` is `true`.
           # @param [Boolean] notifications_invited_to_channel_enabled Whether to send a
-          #   notification when a user is invited to a channel. Can be: `true` or `false` and
-          #   the default is `false`.
+          #   notification when a user is invited to a channel. The default is `false`.
           # @param [String] notifications_invited_to_channel_template The template to use to
           #   create the notification text displayed when a user is invited to a channel and
           #   `notifications.invited_to_channel.enabled` is `true`.
@@ -703,7 +695,7 @@ module Twilio
           #   `pre_webhook_url` and `post_webhook_url` webhooks.  Can be: `POST` or `GET` and
           #   the default is `POST`. See [Webhook
           #   Events](https://www.twilio.com/docs/chat/webhook-events) for more details.
-          # @param [String] webhook_filters The list of WebHook events that are enabled for
+          # @param [String] webhook_filters The list of webhook events that are enabled for
           #   this Service instance. See [Webhook
           #   Events](https://www.twilio.com/docs/chat/webhook-events) for more details.
           # @param [String] limits_channel_members The maximum number of Members that can be
@@ -720,8 +712,8 @@ module Twilio
           #   the `post_webhook_url` if the request times out (after 5 seconds) or it receives
           #   a 429, 503, or 504 HTTP response. The default is 0, which means the call won't
           #   be retried.
-          # @param [Boolean] notifications_log_enabled Whether to log notifications. Can be:
-          #   `true` or `false` and the default is `false`.
+          # @param [Boolean] notifications_log_enabled Whether to log notifications. The
+          #   default is `false`.
           # @return [ServiceInstance] Updated ServiceInstance
           def update(friendly_name: :unset, default_service_role_sid: :unset, default_channel_role_sid: :unset, default_channel_creator_role_sid: :unset, read_status_enabled: :unset, reachability_enabled: :unset, typing_indicator_timeout: :unset, consumption_report_interval: :unset, notifications_new_message_enabled: :unset, notifications_new_message_template: :unset, notifications_new_message_sound: :unset, notifications_new_message_badge_count_enabled: :unset, notifications_added_to_channel_enabled: :unset, notifications_added_to_channel_template: :unset, notifications_added_to_channel_sound: :unset, notifications_removed_from_channel_enabled: :unset, notifications_removed_from_channel_template: :unset, notifications_removed_from_channel_sound: :unset, notifications_invited_to_channel_enabled: :unset, notifications_invited_to_channel_template: :unset, notifications_invited_to_channel_sound: :unset, pre_webhook_url: :unset, post_webhook_url: :unset, webhook_method: :unset, webhook_filters: :unset, limits_channel_members: :unset, limits_user_channels: :unset, media_compatibility_message: :unset, pre_webhook_retry_count: :unset, post_webhook_retry_count: :unset, notifications_log_enabled: :unset)
             context.update(

data/lib/twilio-ruby/rest/chat/v2/service/binding.rb

@@ -16,8 +16,8 @@ module Twilio
             # Initialize the BindingList
             # @param [Version] version Version that contains the resource
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/chat/rest/services) the resource is
-            #   associated with.
+            #   [Service](https://www.twilio.com/docs/chat/rest/services) the Binding resource
+            #   is associated with.
             # @return [BindingList] BindingList
             def initialize(version, service_sid: nil)
               super(version)
@@ -35,7 +35,7 @@ module Twilio
             #   Binding resources to read.  Can be: `apn`, `gcm`, or `fcm`.  See [push
             #   notification
             #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
-            #   for more information.
+            #   for more info.
             # @param [String] identity The
             #   [User](https://www.twilio.com/docs/chat/rest/users)'s `identity` value of the
             #   resources to read. See [access
@@ -64,7 +64,7 @@ module Twilio
             #   Binding resources to read.  Can be: `apn`, `gcm`, or `fcm`.  See [push
             #   notification
             #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
-            #   for more information.
+            #   for more info.
             # @param [String] identity The
             #   [User](https://www.twilio.com/docs/chat/rest/users)'s `identity` value of the
             #   resources to read. See [access
@@ -105,7 +105,7 @@ module Twilio
             #   Binding resources to read.  Can be: `apn`, `gcm`, or `fcm`.  See [push
             #   notification
             #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
-            #   for more information.
+            #   for more info.
             # @param [String] identity The
             #   [User](https://www.twilio.com/docs/chat/rest/users)'s `identity` value of the
             #   resources to read. See [access
@@ -184,10 +184,9 @@ module Twilio
             # Initialize the BindingContext
             # @param [Version] version Version that contains the resource
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/chat/rest/services) to fetch the resource
-            #   from.
-            # @param [String] sid The Twilio-provided string that uniquely identifies the
-            #   Binding resource to fetch.
+            #   [Service](https://www.twilio.com/docs/chat/rest/services) to fetch the Binding
+            #   resource from.
+            # @param [String] sid The SID of the Binding resource to fetch.
             # @return [BindingContext] BindingContext
             def initialize(version, service_sid, sid)
               super(version)
@@ -214,7 +213,7 @@ module Twilio
 
             ##
             # Deletes the BindingInstance
-            # @return [Boolean] true if delete succeeds, true otherwise
+            # @return [Boolean] true if delete succeeds, false otherwise
             def delete
               @version.delete('delete', @uri)
             end
@@ -240,10 +239,9 @@ module Twilio
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/chat/rest/services) the resource is
-            #   associated with.
-            # @param [String] sid The Twilio-provided string that uniquely identifies the
-            #   Binding resource to fetch.
+            #   [Service](https://www.twilio.com/docs/chat/rest/services) the Binding resource
+            #   is associated with.
+            # @param [String] sid The SID of the Binding resource to fetch.
             # @return [BindingInstance] BindingInstance
             def initialize(version, payload, service_sid: nil, sid: nil)
               super(version)
@@ -293,19 +291,19 @@ module Twilio
             end
 
             ##
-            # @return [String] The SID of the Service that the resource is associated with
+            # @return [String] The SID of the Service that the Binding resource is associated with
             def service_sid
               @properties['service_sid']
             end
 
             ##
-            # @return [Time] The RFC 2822 date and time in GMT when the resource was created
+            # @return [Time] The ISO 8601 date and time in GMT when the resource was created
             def date_created
               @properties['date_created']
             end
 
             ##
-            # @return [Time] The RFC 2822 date and time in GMT when the resource was last updated
+            # @return [Time] The ISO 8601 date and time in GMT when the resource was last updated
             def date_updated
               @properties['date_updated']
             end
@@ -347,7 +345,7 @@ module Twilio
             end
 
             ##
-            # @return [String] The absolute URLs of the Users for the Binding
+            # @return [String] The absolute URLs of the Binding's User
             def links
               @properties['links']
             end
@@ -361,7 +359,7 @@ module Twilio
 
             ##
             # Deletes the BindingInstance
-            # @return [Boolean] true if delete succeeds, true otherwise
+            # @return [Boolean] true if delete succeeds, false otherwise
             def delete
               context.delete
             end

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

@@ -16,8 +16,8 @@ module Twilio
             # Initialize the ChannelList
             # @param [Version] version Version that contains the resource
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/chat/rest/services) the resource is
-            #   associated with.
+            #   [Service](https://www.twilio.com/docs/chat/rest/services) the Channel resource
+            #   is associated with.
             # @return [ChannelList] ChannelList
             def initialize(version, service_sid: nil)
               super(version)
@@ -34,21 +34,21 @@ module Twilio
             #   the new resource. It can be up to 64 characters long.
             # @param [String] unique_name An application-defined string that uniquely
             #   identifies the resource. It can be used to address the resource in place of the
-            #   resource's `sid` in the URL. This value must be 64 characters or less in length
-            #   and be unique within the Service.
+            #   Channel resource's `sid` in the URL. This value must be 64 characters or less in
+            #   length and be unique within the Service.
             # @param [String] attributes A valid JSON string that contains
             #   application-specific data.
             # @param [channel.ChannelType] type The visibility of the channel. Can be:
             #   `public` or `private` and defaults to `public`.
             # @param [Time] date_created The date, specified in [ISO
             #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
-            #   as the date it was created. The default is the current time set by the Chat
-            #   service.  Note that this should only be used in cases where a Channel is being
-            #   recreated from a backup/separate source.
+            #   as the date it was created. The default value is the current time set by the
+            #   Chat service.  Note that this should only be used in cases where a Channel is
+            #   being recreated from a backup/separate source.
             # @param [Time] date_updated The date, specified in [ISO
             #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
-            #   as the date it was last updated. The default value is `null`.  Note that this
-            #   should only be used in cases where a Channel is being recreated from a
+            #   as the date it was last updated. The default value is `null`. Note that this
+            #   parameter should only be used in cases where a Channel is being recreated from a
             #   backup/separate source  and where a Message was previously updated.
             # @param [String] created_by The `identity` of the User that created the channel.
             #   Default is: `system`.
@@ -203,10 +203,10 @@ module Twilio
             # Initialize the ChannelContext
             # @param [Version] version Version that contains the resource
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/chat/rest/services) to fetch the resource
-            #   from.
-            # @param [String] sid The Twilio-provided string that uniquely identifies the
-            #   Channel resource to fetch.
+            #   [Service](https://www.twilio.com/docs/chat/rest/services) to fetch the Channel
+            #   resource from.
+            # @param [String] sid The SID of the Channel resource to fetch. This value can be
+            #   either the `sid` or the `unique_name` of the Channel resource to fetch.
             # @return [ChannelContext] ChannelContext
             def initialize(version, service_sid, sid)
               super(version)
@@ -239,7 +239,7 @@ module Twilio
 
             ##
             # Deletes the ChannelInstance
-            # @return [Boolean] true if delete succeeds, true otherwise
+            # @return [Boolean] true if delete succeeds, false otherwise
             def delete
               @version.delete('delete', @uri)
             end
@@ -256,7 +256,9 @@ module Twilio
             #   application-specific data.
             # @param [Time] date_created The date, specified in [ISO
             #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
-            #   as the date it was created.
+            #   as the date it was created. The default value is the current time set by the
+            #   Chat service.  Note that this should only be used in cases where a Channel is
+            #   being recreated from a backup/separate source.
             # @param [Time] date_updated The date, specified in [ISO
             #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
             #   as the date it was last updated.
@@ -391,10 +393,10 @@ module Twilio
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/chat/rest/services) the resource is
-            #   associated with.
-            # @param [String] sid The Twilio-provided string that uniquely identifies the
-            #   Channel resource to fetch.
+            #   [Service](https://www.twilio.com/docs/chat/rest/services) the Channel resource
+            #   is associated with.
+            # @param [String] sid The SID of the Channel resource to fetch. This value can be
+            #   either the `sid` or the `unique_name` of the Channel resource to fetch.
             # @return [ChannelInstance] ChannelInstance
             def initialize(version, payload, service_sid: nil, sid: nil)
               super(version)
@@ -476,13 +478,13 @@ module Twilio
             end
 
             ##
-            # @return [Time] The RFC 2822 date and time in GMT when the resource was created
+            # @return [Time] The ISO 8601 date and time in GMT when the resource was created
             def date_created
               @properties['date_created']
             end
 
             ##
-            # @return [Time] The RFC 2822 date and time in GMT when the resource was last updated
+            # @return [Time] The ISO 8601 date and time in GMT when the resource was last updated
             def date_updated
               @properties['date_updated']
             end
@@ -500,7 +502,7 @@ module Twilio
             end
 
             ##
-            # @return [String] The number of Messages in the Channel
+            # @return [String] The number of Messages that have been passed in the Channel
             def messages_count
               @properties['messages_count']
             end
@@ -526,7 +528,7 @@ module Twilio
 
             ##
             # Deletes the ChannelInstance
-            # @return [Boolean] true if delete succeeds, true otherwise
+            # @return [Boolean] true if delete succeeds, false otherwise
             def delete
               context.delete
             end
@@ -543,7 +545,9 @@ module Twilio
             #   application-specific data.
             # @param [Time] date_created The date, specified in [ISO
             #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
-            #   as the date it was created.
+            #   as the date it was created. The default value is the current time set by the
+            #   Chat service.  Note that this should only be used in cases where a Channel is
+            #   being recreated from a backup/separate source.
             # @param [Time] date_updated The date, specified in [ISO
             #   8601](https://en.wikipedia.org/wiki/ISO_8601) format, to assign to the resource
             #   as the date it was last updated.