twilio-ruby 5.27.0 → 5.27.1

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

@@ -94,22 +94,19 @@ module Twilio
 
           ##
           # Update the WebhookInstance
-          # @param [String] webhook_method The HTTP method to be used when sending a webhook
+          # @param [String] webhook_method The HTTP method to use when sending a webhook
           #   request.
           # @param [String] webhook_filters The list of webhook event triggers that are
-          #   enabled for this Service.
-          # @param [String] pre_webhook_url The absolute url the pre-event webhook request
-          #   should be sent to.
-          # @param [String] post_webhook_url The absolute url the post-event webhook request
-          #   should be sent to.
-          # @param [String] pre_webhook_retry_count The number of retries in case of
-          #   pre-event webhook request failures. Maximum 3 retries are allowed, the default
-          #   value is 0.
-          # @param [String] post_webhook_retry_count The number of retries in case of
-          #   post-event webhook request failures. Maximum 3 retries are allowed, the default
-          #   value is 0.
+          #   enabled for the Service.
+          # @param [String] pre_webhook_url The absolute URL of the pre-event webhook.
+          # @param [String] post_webhook_url The absolute URL of the post-event webhook.
+          # @param [String] pre_webhook_retry_count The number of times to try the pre-event
+          #   webhook request if the first attempt fails. Can be up to 3 and the default is 0.
+          # @param [String] post_webhook_retry_count The number of times to try the
+          #   post-event webhook request if the first attempt fails. Can be up to 3 and the
+          #   default is 0.
           # @param [webhook.Target] target The routing target of the webhook. Can be
-          #   ordinary or route internally to Flex
+          #   ordinary or routed internally to Flex
           # @return [WebhookInstance] Updated WebhookInstance
           def update(webhook_method: :unset, webhook_filters: :unset, pre_webhook_url: :unset, post_webhook_url: :unset, pre_webhook_retry_count: :unset, post_webhook_retry_count: :unset, target: :unset)
             data = Twilio::Values.of({
@@ -188,61 +185,61 @@ module Twilio
           end
 
           ##
-          # @return [String] The unique id of the Account responsible for this session.
+          # @return [String] The SID of the Account that created the resource
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [String] The unique id of the Chat Service this session belongs to.
+          # @return [String] The SID of the Chat Service that the resource is associated with
           def service_sid
             @properties['service_sid']
           end
 
           ##
-          # @return [String] The HTTP method to be used when sending a webhook request.
+          # @return [String] The HTTP method to use when sending a webhook request
           def webhook_method
             @properties['webhook_method']
           end
 
           ##
-          # @return [String] The list of webhook event triggers that are enabled for this Service.
+          # @return [String] The list of webhook event triggers that are enabled for the Service
           def webhook_filters
             @properties['webhook_filters']
           end
 
           ##
-          # @return [String] The absolute url the pre-event webhook request should be sent to.
+          # @return [String] The absolute URL of the pre-event webhook
           def pre_webhook_url
             @properties['pre_webhook_url']
           end
 
           ##
-          # @return [String] The absolute url the post-event webhook request should be sent to.
+          # @return [String] The absolute URL of the post-event webhook
           def post_webhook_url
             @properties['post_webhook_url']
           end
 
           ##
-          # @return [String] The number of retries in case of pre-event webhook request failures.
+          # @return [String] The number of times to try the pre-event webhook request if the first attempt fails
           def pre_webhook_retry_count
             @properties['pre_webhook_retry_count']
           end
 
           ##
-          # @return [String] The number of retries in case of post-event webhook request failures.
+          # @return [String] The number of times to try the post-event webhook request if the first attempt fails
           def post_webhook_retry_count
             @properties['post_webhook_retry_count']
           end
 
           ##
-          # @return [webhook.Target] The routing target of the webhook.
+          # @return [webhook.Target] The routing target of the webhook
           def target
             @properties['target']
           end
 
           ##
-          # @return [String] An absolute URL for this webhook.
+          # @return [String] The absolute URL of the webhook
           def url
             @properties['url']
           end
@@ -256,22 +253,19 @@ module Twilio
 
           ##
           # Update the WebhookInstance
-          # @param [String] webhook_method The HTTP method to be used when sending a webhook
+          # @param [String] webhook_method The HTTP method to use when sending a webhook
           #   request.
           # @param [String] webhook_filters The list of webhook event triggers that are
-          #   enabled for this Service.
-          # @param [String] pre_webhook_url The absolute url the pre-event webhook request
-          #   should be sent to.
-          # @param [String] post_webhook_url The absolute url the post-event webhook request
-          #   should be sent to.
-          # @param [String] pre_webhook_retry_count The number of retries in case of
-          #   pre-event webhook request failures. Maximum 3 retries are allowed, the default
-          #   value is 0.
-          # @param [String] post_webhook_retry_count The number of retries in case of
-          #   post-event webhook request failures. Maximum 3 retries are allowed, the default
-          #   value is 0.
+          #   enabled for the Service.
+          # @param [String] pre_webhook_url The absolute URL of the pre-event webhook.
+          # @param [String] post_webhook_url The absolute URL of the post-event webhook.
+          # @param [String] pre_webhook_retry_count The number of times to try the pre-event
+          #   webhook request if the first attempt fails. Can be up to 3 and the default is 0.
+          # @param [String] post_webhook_retry_count The number of times to try the
+          #   post-event webhook request if the first attempt fails. Can be up to 3 and the
+          #   default is 0.
           # @param [webhook.Target] target The routing target of the webhook. Can be
-          #   ordinary or route internally to Flex
+          #   ordinary or routed internally to Flex
           # @return [WebhookInstance] Updated WebhookInstance
           def update(webhook_method: :unset, webhook_filters: :unset, pre_webhook_url: :unset, post_webhook_url: :unset, pre_webhook_retry_count: :unset, post_webhook_retry_count: :unset, target: :unset)
             context.update(

data/lib/twilio-ruby/rest/monitor.rb

@@ -29,7 +29,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this Alert.
+      # @param [String] sid The unique string that we created to identify the Alert
+      #   resource.
       # @return [Twilio::REST::Monitor::V1::AlertInstance] if sid was passed.
       # @return [Twilio::REST::Monitor::V1::AlertList]
       def alerts(sid=:unset)
@@ -37,7 +38,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this event.
+      # @param [String] sid The unique string that we created to identify the Event
+      #   resource.
       # @return [Twilio::REST::Monitor::V1::EventInstance] if sid was passed.
       # @return [Twilio::REST::Monitor::V1::EventList]
       def events(sid=:unset)

data/lib/twilio-ruby/rest/monitor/v1.rb

@@ -20,7 +20,7 @@ module Twilio
         end
 
         ##
-        # @param [String] sid A 34 character string that uniquely identifies this Alert.
+        # @param [String] sid The SID of the Alert resource to fetch.
         # @return [Twilio::REST::Monitor::V1::AlertContext] if sid was passed.
         # @return [Twilio::REST::Monitor::V1::AlertList]
         def alerts(sid=:unset)
@@ -34,7 +34,7 @@ module Twilio
         end
 
         ##
-        # @param [String] sid A 34 character string that uniquely identifies this event.
+        # @param [String] sid The SID of the Event resource to fetch.
         # @return [Twilio::REST::Monitor::V1::EventContext] if sid was passed.
         # @return [Twilio::REST::Monitor::V1::EventList]
         def events(sid=:unset)

data/lib/twilio-ruby/rest/monitor/v1/alert.rb

@@ -27,18 +27,14 @@ module Twilio
           # Lists AlertInstance records from the API as a list.
           # Unlike stream(), this operation is eager and will load `limit` records into
           # memory before returning.
-          # @param [String] log_level Only show alerts for this log-level.  One of 'error',
-          #   'warning', 'notice', or 'debug'.
-          # @param [Date] start_date Only show Alerts on or after this date.  Useful in
-          #   combination with `EndDate` to define a date-range of Alerts.  Input is a [UTC
-          #   ISO 8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day
-          #   is ignored by the filter. Queries for Alerts older than 30 days are not
-          #   supported.
-          # @param [Date] end_date Only show Alerts on or before this date.  Useful in
-          #   combination with `StartDate` to define a date-range of Alerts.  Input is a [UTC
-          #   ISO 8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day
-          #   is ignored by the filter. Queries for Alerts older than 30 days are not
-          #   supported.
+          # @param [String] log_level Only show alerts for this log-level.  Can be: `error`,
+          #   `warning`, `notice`, or `debug`.
+          # @param [Date] start_date Only include alerts that occurred on or after this
+          #   date. Specify the date in GMT and format as `YYYY-MM-DD`. Queries for alerts
+          #   older than 30 days are not supported.
+          # @param [Date] end_date Only include alerts that occurred on or before this date.
+          #   Specify the date in GMT and format as `YYYY-MM-DD`. Queries for alerts older
+          #   than 30 days are not supported.
           # @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
@@ -60,18 +56,14 @@ module Twilio
           # Streams AlertInstance records from the API as an Enumerable.
           # This operation lazily loads records as efficiently as possible until the limit
           # is reached.
-          # @param [String] log_level Only show alerts for this log-level.  One of 'error',
-          #   'warning', 'notice', or 'debug'.
-          # @param [Date] start_date Only show Alerts on or after this date.  Useful in
-          #   combination with `EndDate` to define a date-range of Alerts.  Input is a [UTC
-          #   ISO 8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day
-          #   is ignored by the filter. Queries for Alerts older than 30 days are not
-          #   supported.
-          # @param [Date] end_date Only show Alerts on or before this date.  Useful in
-          #   combination with `StartDate` to define a date-range of Alerts.  Input is a [UTC
-          #   ISO 8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day
-          #   is ignored by the filter. Queries for Alerts older than 30 days are not
-          #   supported.
+          # @param [String] log_level Only show alerts for this log-level.  Can be: `error`,
+          #   `warning`, `notice`, or `debug`.
+          # @param [Date] start_date Only include alerts that occurred on or after this
+          #   date. Specify the date in GMT and format as `YYYY-MM-DD`. Queries for alerts
+          #   older than 30 days are not supported.
+          # @param [Date] end_date Only include alerts that occurred on or before this date.
+          #   Specify the date in GMT and format as `YYYY-MM-DD`. Queries for alerts older
+          #   than 30 days are not supported.
           # @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
@@ -109,18 +101,14 @@ module Twilio
           ##
           # Retrieve a single page of AlertInstance records from the API.
           # Request is executed immediately.
-          # @param [String] log_level Only show alerts for this log-level.  One of 'error',
-          #   'warning', 'notice', or 'debug'.
-          # @param [Date] start_date Only show Alerts on or after this date.  Useful in
-          #   combination with `EndDate` to define a date-range of Alerts.  Input is a [UTC
-          #   ISO 8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day
-          #   is ignored by the filter. Queries for Alerts older than 30 days are not
-          #   supported.
-          # @param [Date] end_date Only show Alerts on or before this date.  Useful in
-          #   combination with `StartDate` to define a date-range of Alerts.  Input is a [UTC
-          #   ISO 8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day
-          #   is ignored by the filter. Queries for Alerts older than 30 days are not
-          #   supported.
+          # @param [String] log_level Only show alerts for this log-level.  Can be: `error`,
+          #   `warning`, `notice`, or `debug`.
+          # @param [Date] start_date Only include alerts that occurred on or after this
+          #   date. Specify the date in GMT and format as `YYYY-MM-DD`. Queries for alerts
+          #   older than 30 days are not supported.
+          # @param [Date] end_date Only include alerts that occurred on or before this date.
+          #   Specify the date in GMT and format as `YYYY-MM-DD`. Queries for alerts older
+          #   than 30 days are not supported.
           # @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
@@ -195,7 +183,7 @@ module Twilio
           ##
           # Initialize the AlertContext
           # @param [Version] version Version that contains the resource
-          # @param [String] sid A 34 character string that uniquely identifies this Alert.
+          # @param [String] sid The SID of the Alert resource to fetch.
           # @return [AlertContext] AlertContext
           def initialize(version, sid)
             super(version)
@@ -240,7 +228,7 @@ module Twilio
           # Initialize the AlertInstance
           # @param [Version] version Version that contains the resource
           # @param [Hash] payload payload that contains response from Twilio
-          # @param [String] sid A 34 character string that uniquely identifies this Alert.
+          # @param [String] sid The SID of the Alert resource to fetch.
           # @return [AlertInstance] AlertInstance
           def initialize(version, payload, sid: nil)
             super(version)
@@ -285,115 +273,115 @@ module Twilio
           end
 
           ##
-          # @return [String] The unique id of the Account responsible for this alert.
+          # @return [String] The SID of the Account that created the resource
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [String] The text of the alert.
+          # @return [String] The text of the alert
           def alert_text
             @properties['alert_text']
           end
 
           ##
-          # @return [String] The version of the Twilio API in use when this alert was generated.
+          # @return [String] The API version used when the alert was generated
           def api_version
             @properties['api_version']
           end
 
           ##
-          # @return [Time] The date that this resource was created, given in ISO 8601 format.
+          # @return [Time] The ISO 8601 date and time in GMT when the resource was created
           def date_created
             @properties['date_created']
           end
 
           ##
-          # @return [Time] The date the alert was actually generated, given in ISO 8601 format.
+          # @return [Time] The date and time when the alert was generated specified in ISO 8601 format
           def date_generated
             @properties['date_generated']
           end
 
           ##
-          # @return [Time] The most recent date that this resource was updated, given in ISO 8601 format.
+          # @return [Time] The ISO 8601 date and time in GMT when the resource was last updated
           def date_updated
             @properties['date_updated']
           end
 
           ##
-          # @return [String] A unique error code for the error condition.
+          # @return [String] The error code for the condition that generated the alert
           def error_code
             @properties['error_code']
           end
 
           ##
-          # @return [String] A string representing the log level.
+          # @return [String] The log level
           def log_level
             @properties['log_level']
           end
 
           ##
-          # @return [String] A URL for more information about the error condition.
+          # @return [String] The URL of the page in our Error Dictionary with more information about the error condition
           def more_info
             @properties['more_info']
           end
 
           ##
-          # @return [String] If the Alert was generated by a request Twilio made to your server, this will be the request method used when Twilio made the request to your server.
+          # @return [String] The method used by the request that generated the alert
           def request_method
             @properties['request_method']
           end
 
           ##
-          # @return [String] If the Alert was generated by a request Twilio made to your server, this will be the URL on your server that generated the alert.
+          # @return [String] The URL of the request that generated the alert
           def request_url
             @properties['request_url']
           end
 
           ##
-          # @return [String] The request_variables
+          # @return [String] The variables passed in the request that generated the alert
           def request_variables
             @properties['request_variables']
           end
 
           ##
-          # @return [String] The unique ID of the resource for which the Alert was generated.
+          # @return [String] The SID of the resource for which the alert was generated
           def resource_sid
             @properties['resource_sid']
           end
 
           ##
-          # @return [String] The response_body
+          # @return [String] The response body of the request that generated the alert
           def response_body
             @properties['response_body']
           end
 
           ##
-          # @return [String] The response_headers
+          # @return [String] The response headers of the request that generated the alert
           def response_headers
             @properties['response_headers']
           end
 
           ##
-          # @return [String] A 34 character string that uniquely identifies this Alert.
+          # @return [String] The unique string that identifies the resource
           def sid
             @properties['sid']
           end
 
           ##
-          # @return [String] The absolute URL for this resource.
+          # @return [String] The absolute URL of the Alert resource
           def url
             @properties['url']
           end
 
           ##
-          # @return [String] The request_headers
+          # @return [String] The request headers of the request that generated the alert
           def request_headers
             @properties['request_headers']
           end
 
           ##
-          # @return [String] The service_sid
+          # @return [String] The SID of the service or resource that generated the alert
           def service_sid
             @properties['service_sid']
           end

data/lib/twilio-ruby/rest/monitor/v1/event.rb

@@ -27,22 +27,21 @@ module Twilio
           # Lists EventInstance records from the API as a list.
           # Unlike stream(), this operation is eager and will load `limit` records into
           # memory before returning.
-          # @param [String] actor_sid Only include Events initiated by this Actor. Useful
+          # @param [String] actor_sid Only include events initiated by this Actor. Useful
           #   for auditing actions taken by specific users or API credentials.
-          # @param [String] event_type Only include Events of this EventType.
-          # @param [String] resource_sid Only include Events referring to this resource.
+          # @param [String] event_type Only include events of this [Event
+          #   Type](https://www.twilio.com/docs/usage/monitor-events#event-types).
+          # @param [String] resource_sid Only include events that refer to this resource.
           #   Useful for discovering the history of a specific resource.
-          # @param [String] source_ip_address Only include Events that originated from this
+          # @param [String] source_ip_address Only include events that originated from this
           #   IP address. Useful for tracking suspicious activity originating from the API or
           #   the Twilio Console.
-          # @param [Time] start_date Only show events on or after this date. Useful in
-          #   combination with `EndDate` to define a date-range of events. Input is a [UTC ISO
-          #   8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day is
-          #   ignored by the filter.
-          # @param [Time] end_date Only show events on or before this date. Useful in
-          #   combination with `StartDate` to define a date-range of events. Input is a [UTC
-          #   ISO 8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day
-          #   is ignored by the filter.
+          # @param [Time] start_date Only include events that occurred on or after this
+          #   date. Specify the date in GMT and [ISO
+          #   8601](https://en.wikipedia.org/wiki/ISO_8601) format.
+          # @param [Time] end_date Only include events that occurred on or before this date.
+          #   Specify the date in GMT and [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
+          #   format.
           # @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
@@ -67,22 +66,21 @@ module Twilio
           # Streams EventInstance records from the API as an Enumerable.
           # This operation lazily loads records as efficiently as possible until the limit
           # is reached.
-          # @param [String] actor_sid Only include Events initiated by this Actor. Useful
+          # @param [String] actor_sid Only include events initiated by this Actor. Useful
           #   for auditing actions taken by specific users or API credentials.
-          # @param [String] event_type Only include Events of this EventType.
-          # @param [String] resource_sid Only include Events referring to this resource.
+          # @param [String] event_type Only include events of this [Event
+          #   Type](https://www.twilio.com/docs/usage/monitor-events#event-types).
+          # @param [String] resource_sid Only include events that refer to this resource.
           #   Useful for discovering the history of a specific resource.
-          # @param [String] source_ip_address Only include Events that originated from this
+          # @param [String] source_ip_address Only include events that originated from this
           #   IP address. Useful for tracking suspicious activity originating from the API or
           #   the Twilio Console.
-          # @param [Time] start_date Only show events on or after this date. Useful in
-          #   combination with `EndDate` to define a date-range of events. Input is a [UTC ISO
-          #   8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day is
-          #   ignored by the filter.
-          # @param [Time] end_date Only show events on or before this date. Useful in
-          #   combination with `StartDate` to define a date-range of events. Input is a [UTC
-          #   ISO 8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day
-          #   is ignored by the filter.
+          # @param [Time] start_date Only include events that occurred on or after this
+          #   date. Specify the date in GMT and [ISO
+          #   8601](https://en.wikipedia.org/wiki/ISO_8601) format.
+          # @param [Time] end_date Only include events that occurred on or before this date.
+          #   Specify the date in GMT and [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
+          #   format.
           # @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
@@ -123,22 +121,21 @@ module Twilio
           ##
           # Retrieve a single page of EventInstance records from the API.
           # Request is executed immediately.
-          # @param [String] actor_sid Only include Events initiated by this Actor. Useful
+          # @param [String] actor_sid Only include events initiated by this Actor. Useful
           #   for auditing actions taken by specific users or API credentials.
-          # @param [String] event_type Only include Events of this EventType.
-          # @param [String] resource_sid Only include Events referring to this resource.
+          # @param [String] event_type Only include events of this [Event
+          #   Type](https://www.twilio.com/docs/usage/monitor-events#event-types).
+          # @param [String] resource_sid Only include events that refer to this resource.
           #   Useful for discovering the history of a specific resource.
-          # @param [String] source_ip_address Only include Events that originated from this
+          # @param [String] source_ip_address Only include events that originated from this
           #   IP address. Useful for tracking suspicious activity originating from the API or
           #   the Twilio Console.
-          # @param [Time] start_date Only show events on or after this date. Useful in
-          #   combination with `EndDate` to define a date-range of events. Input is a [UTC ISO
-          #   8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day is
-          #   ignored by the filter.
-          # @param [Time] end_date Only show events on or before this date. Useful in
-          #   combination with `StartDate` to define a date-range of events. Input is a [UTC
-          #   ISO 8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day
-          #   is ignored by the filter.
+          # @param [Time] start_date Only include events that occurred on or after this
+          #   date. Specify the date in GMT and [ISO
+          #   8601](https://en.wikipedia.org/wiki/ISO_8601) format.
+          # @param [Time] end_date Only include events that occurred on or before this date.
+          #   Specify the date in GMT and [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
+          #   format.
           # @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
@@ -216,7 +213,7 @@ module Twilio
           ##
           # Initialize the EventContext
           # @param [Version] version Version that contains the resource
-          # @param [String] sid A 34 character string that uniquely identifies this event.
+          # @param [String] sid The SID of the Event resource to fetch.
           # @return [EventContext] EventContext
           def initialize(version, sid)
             super(version)
@@ -261,7 +258,7 @@ module Twilio
           # Initialize the EventInstance
           # @param [Version] version Version that contains the resource
           # @param [Hash] payload payload that contains response from Twilio
-          # @param [String] sid A 34 character string that uniquely identifies this event.
+          # @param [String] sid The SID of the Event resource to fetch.
           # @return [EventInstance] EventInstance
           def initialize(version, payload, sid: nil)
             super(version)
@@ -301,49 +298,49 @@ module Twilio
           end
 
           ##
-          # @return [String] A 34 character string identifying the Account for which this Event was recorded.
+          # @return [String] The SID of the Account that created the resource
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [String] If available, a 34 character string identifying the actor that caused this event. May be null.
+          # @return [String] The SID of the actor that caused the event, if available
           def actor_sid
             @properties['actor_sid']
           end
 
           ##
-          # @return [String] The type of actor that caused this event
+          # @return [String] The type of actor that caused the event
           def actor_type
             @properties['actor_type']
           end
 
           ##
-          # @return [String] A human-readable description of the event.  May be null.
+          # @return [String] A description of the event
           def description
             @properties['description']
           end
 
           ##
-          # @return [Hash] A freeform json object encoding additional data about the event
+          # @return [Hash] A JSON string that represents an object with additional data about the event
           def event_data
             @properties['event_data']
           end
 
           ##
-          # @return [Time] The date-time the event was recorded
+          # @return [Time] The ISO 8601 date and time in GMT when the event was recorded
           def event_date
             @properties['event_date']
           end
 
           ##
-          # @return [String] The event's type, as a string.
+          # @return [String] The event's type
           def event_type
             @properties['event_type']
           end
 
           ##
-          # @return [String] A 34 character string identifying the resource that was affected.
+          # @return [String] The SID of the resource that was affected
           def resource_sid
             @properties['resource_sid']
           end
@@ -355,13 +352,13 @@ module Twilio
           end
 
           ##
-          # @return [String] A 34 character string that uniquely identifies this event.
+          # @return [String] The unique string that identifies the resource
           def sid
             @properties['sid']
           end
 
           ##
-          # @return [String] The originating system or interface that caused the event.  web for events caused by user action in the Twilio Console.  api for events caused through a request to the REST API.  twilio for events caused by an automated or internal Twilio system.
+          # @return [String] The originating system or interface that caused the event
           def source
             @properties['source']
           end
@@ -373,13 +370,13 @@ module Twilio
           end
 
           ##
-          # @return [String] The url
+          # @return [String] The absolute URL of the resource that was affected
           def url
             @properties['url']
           end
 
           ##
-          # @return [String] The links
+          # @return [String] The absolute URLs of related resources
           def links
             @properties['links']
           end