twilio-ruby 5.40.2 → 5.43.0

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

@@ -18,7 +18,7 @@ module Twilio
               # @param [Version] version Version that contains the resource
               # @param [String] account_sid The account_sid
               # @param [String] country_code The
-              #   [ISO-3166-1](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of
+              #   {ISO-3166-1}[https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] country code of
               #   the country.
               # @return [TollFreeList] TollFreeList
               def initialize(version, account_sid: nil, country_code: nil)
@@ -37,8 +37,11 @@ module Twilio
               #   only phone numbers in the US and Canada.
               # @param [String] contains The pattern on which to match phone numbers. Valid
               #   characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any
-              #   single digit. For examples, see [Example
-              #   2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters.
+              #   single digit. For examples, see {Example
+              #   2}[https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2]
+              #   and {Example
+              #   3}[https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3].
+              #   If specified, this value must have at least two characters.
               # @param [Boolean] sms_enabled Whether the phone numbers can receive text
               #   messages. Can be: `true` or `false`.
               # @param [Boolean] mms_enabled Whether the phone numbers can receive MMS messages.
@@ -46,14 +49,14 @@ module Twilio
               # @param [Boolean] voice_enabled Whether the phone numbers can receive calls. Can
               #   be: `true` or `false`.
               # @param [Boolean] exclude_all_address_required Whether to exclude phone numbers
-              #   that require an [Address](https://www.twilio.com/docs/usage/api/address). Can
+              #   that require an {Address}[https://www.twilio.com/docs/usage/api/address]. Can
               #   be: `true` or `false` and the default is `false`.
               # @param [Boolean] exclude_local_address_required Whether to exclude phone numbers
-              #   that require a local [Address](https://www.twilio.com/docs/usage/api/address).
+              #   that require a local {Address}[https://www.twilio.com/docs/usage/api/address].
               #   Can be: `true` or `false` and the default is `false`.
               # @param [Boolean] exclude_foreign_address_required Whether to exclude phone
               #   numbers that require a foreign
-              #   [Address](https://www.twilio.com/docs/usage/api/address). Can be: `true` or
+              #   {Address}[https://www.twilio.com/docs/usage/api/address]. Can be: `true` or
               #   `false` and the default is `false`.
               # @param [Boolean] beta Whether to read phone numbers that are new to the Twilio
               #   platform. Can be: `true` or `false` and the default is `true`.
@@ -76,9 +79,9 @@ module Twilio
               #   a phone number search within the same rate center as that number. Requires
               #   `in_lata` to be set as well. Applies to only phone numbers in the US and Canada.
               # @param [String] in_lata Limit results to a specific local access and transport
-              #   area ([LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area)).
+              #   area ({LATA}[https://en.wikipedia.org/wiki/Local_access_and_transport_area]).
               #   Given a phone number, search within the same
-              #   [LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area) as that
+              #   {LATA}[https://en.wikipedia.org/wiki/Local_access_and_transport_area] as that
               #   number. Applies to only phone numbers in the US and Canada.
               # @param [String] in_locality Limit results to a particular locality or city.
               #   Given a phone number, search within the same Locality as that number.
@@ -124,8 +127,11 @@ module Twilio
               #   only phone numbers in the US and Canada.
               # @param [String] contains The pattern on which to match phone numbers. Valid
               #   characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any
-              #   single digit. For examples, see [Example
-              #   2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters.
+              #   single digit. For examples, see {Example
+              #   2}[https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2]
+              #   and {Example
+              #   3}[https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3].
+              #   If specified, this value must have at least two characters.
               # @param [Boolean] sms_enabled Whether the phone numbers can receive text
               #   messages. Can be: `true` or `false`.
               # @param [Boolean] mms_enabled Whether the phone numbers can receive MMS messages.
@@ -133,14 +139,14 @@ module Twilio
               # @param [Boolean] voice_enabled Whether the phone numbers can receive calls. Can
               #   be: `true` or `false`.
               # @param [Boolean] exclude_all_address_required Whether to exclude phone numbers
-              #   that require an [Address](https://www.twilio.com/docs/usage/api/address). Can
+              #   that require an {Address}[https://www.twilio.com/docs/usage/api/address]. Can
               #   be: `true` or `false` and the default is `false`.
               # @param [Boolean] exclude_local_address_required Whether to exclude phone numbers
-              #   that require a local [Address](https://www.twilio.com/docs/usage/api/address).
+              #   that require a local {Address}[https://www.twilio.com/docs/usage/api/address].
               #   Can be: `true` or `false` and the default is `false`.
               # @param [Boolean] exclude_foreign_address_required Whether to exclude phone
               #   numbers that require a foreign
-              #   [Address](https://www.twilio.com/docs/usage/api/address). Can be: `true` or
+              #   {Address}[https://www.twilio.com/docs/usage/api/address]. Can be: `true` or
               #   `false` and the default is `false`.
               # @param [Boolean] beta Whether to read phone numbers that are new to the Twilio
               #   platform. Can be: `true` or `false` and the default is `true`.
@@ -163,9 +169,9 @@ module Twilio
               #   a phone number search within the same rate center as that number. Requires
               #   `in_lata` to be set as well. Applies to only phone numbers in the US and Canada.
               # @param [String] in_lata Limit results to a specific local access and transport
-              #   area ([LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area)).
+              #   area ({LATA}[https://en.wikipedia.org/wiki/Local_access_and_transport_area]).
               #   Given a phone number, search within the same
-              #   [LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area) as that
+              #   {LATA}[https://en.wikipedia.org/wiki/Local_access_and_transport_area] as that
               #   number. Applies to only phone numbers in the US and Canada.
               # @param [String] in_locality Limit results to a particular locality or city.
               #   Given a phone number, search within the same Locality as that number.
@@ -227,8 +233,11 @@ module Twilio
               #   only phone numbers in the US and Canada.
               # @param [String] contains The pattern on which to match phone numbers. Valid
               #   characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any
-              #   single digit. For examples, see [Example
-              #   2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters.
+              #   single digit. For examples, see {Example
+              #   2}[https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2]
+              #   and {Example
+              #   3}[https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3].
+              #   If specified, this value must have at least two characters.
               # @param [Boolean] sms_enabled Whether the phone numbers can receive text
               #   messages. Can be: `true` or `false`.
               # @param [Boolean] mms_enabled Whether the phone numbers can receive MMS messages.
@@ -236,14 +245,14 @@ module Twilio
               # @param [Boolean] voice_enabled Whether the phone numbers can receive calls. Can
               #   be: `true` or `false`.
               # @param [Boolean] exclude_all_address_required Whether to exclude phone numbers
-              #   that require an [Address](https://www.twilio.com/docs/usage/api/address). Can
+              #   that require an {Address}[https://www.twilio.com/docs/usage/api/address]. Can
               #   be: `true` or `false` and the default is `false`.
               # @param [Boolean] exclude_local_address_required Whether to exclude phone numbers
-              #   that require a local [Address](https://www.twilio.com/docs/usage/api/address).
+              #   that require a local {Address}[https://www.twilio.com/docs/usage/api/address].
               #   Can be: `true` or `false` and the default is `false`.
               # @param [Boolean] exclude_foreign_address_required Whether to exclude phone
               #   numbers that require a foreign
-              #   [Address](https://www.twilio.com/docs/usage/api/address). Can be: `true` or
+              #   {Address}[https://www.twilio.com/docs/usage/api/address]. Can be: `true` or
               #   `false` and the default is `false`.
               # @param [Boolean] beta Whether to read phone numbers that are new to the Twilio
               #   platform. Can be: `true` or `false` and the default is `true`.
@@ -266,9 +275,9 @@ module Twilio
               #   a phone number search within the same rate center as that number. Requires
               #   `in_lata` to be set as well. Applies to only phone numbers in the US and Canada.
               # @param [String] in_lata Limit results to a specific local access and transport
-              #   area ([LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area)).
+              #   area ({LATA}[https://en.wikipedia.org/wiki/Local_access_and_transport_area]).
               #   Given a phone number, search within the same
-              #   [LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area) as that
+              #   {LATA}[https://en.wikipedia.org/wiki/Local_access_and_transport_area] as that
               #   number. Applies to only phone numbers in the US and Canada.
               # @param [String] in_locality Limit results to a particular locality or city.
               #   Given a phone number, search within the same Locality as that number.
@@ -369,7 +378,7 @@ module Twilio
               # @param [Hash] payload payload that contains response from Twilio
               # @param [String] account_sid The account_sid
               # @param [String] country_code The
-              #   [ISO-3166-1](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of
+              #   {ISO-3166-1}[https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] country code of
               #   the country.
               # @return [TollFreeInstance] TollFreeInstance
               def initialize(version, payload, account_sid: nil, country_code: nil)

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

@@ -18,7 +18,7 @@ module Twilio
               # @param [Version] version Version that contains the resource
               # @param [String] account_sid The account_sid
               # @param [String] country_code The
-              #   [ISO-3166-1](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of
+              #   {ISO-3166-1}[https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] country code of
               #   the country.
               # @return [VoipList] VoipList
               def initialize(version, account_sid: nil, country_code: nil)
@@ -37,8 +37,11 @@ module Twilio
               #   only phone numbers in the US and Canada.
               # @param [String] contains The pattern on which to match phone numbers. Valid
               #   characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any
-              #   single digit. For examples, see [Example
-              #   2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters.
+              #   single digit. For examples, see {Example
+              #   2}[https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2]
+              #   and {Example
+              #   3}[https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3].
+              #   If specified, this value must have at least two characters.
               # @param [Boolean] sms_enabled Whether the phone numbers can receive text
               #   messages. Can be: `true` or `false`.
               # @param [Boolean] mms_enabled Whether the phone numbers can receive MMS messages.
@@ -46,14 +49,14 @@ module Twilio
               # @param [Boolean] voice_enabled Whether the phone numbers can receive calls. Can
               #   be: `true` or `false`.
               # @param [Boolean] exclude_all_address_required Whether to exclude phone numbers
-              #   that require an [Address](https://www.twilio.com/docs/usage/api/address). Can
+              #   that require an {Address}[https://www.twilio.com/docs/usage/api/address]. Can
               #   be: `true` or `false` and the default is `false`.
               # @param [Boolean] exclude_local_address_required Whether to exclude phone numbers
-              #   that require a local [Address](https://www.twilio.com/docs/usage/api/address).
+              #   that require a local {Address}[https://www.twilio.com/docs/usage/api/address].
               #   Can be: `true` or `false` and the default is `false`.
               # @param [Boolean] exclude_foreign_address_required Whether to exclude phone
               #   numbers that require a foreign
-              #   [Address](https://www.twilio.com/docs/usage/api/address). Can be: `true` or
+              #   {Address}[https://www.twilio.com/docs/usage/api/address]. Can be: `true` or
               #   `false` and the default is `false`.
               # @param [Boolean] beta Whether to read phone numbers that are new to the Twilio
               #   platform. Can be: `true` or `false` and the default is `true`.
@@ -76,9 +79,9 @@ module Twilio
               #   a phone number search within the same rate center as that number. Requires
               #   `in_lata` to be set as well. Applies to only phone numbers in the US and Canada.
               # @param [String] in_lata Limit results to a specific local access and transport
-              #   area ([LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area)).
+              #   area ({LATA}[https://en.wikipedia.org/wiki/Local_access_and_transport_area]).
               #   Given a phone number, search within the same
-              #   [LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area) as that
+              #   {LATA}[https://en.wikipedia.org/wiki/Local_access_and_transport_area] as that
               #   number. Applies to only phone numbers in the US and Canada.
               # @param [String] in_locality Limit results to a particular locality or city.
               #   Given a phone number, search within the same Locality as that number.
@@ -124,8 +127,11 @@ module Twilio
               #   only phone numbers in the US and Canada.
               # @param [String] contains The pattern on which to match phone numbers. Valid
               #   characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any
-              #   single digit. For examples, see [Example
-              #   2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters.
+              #   single digit. For examples, see {Example
+              #   2}[https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2]
+              #   and {Example
+              #   3}[https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3].
+              #   If specified, this value must have at least two characters.
               # @param [Boolean] sms_enabled Whether the phone numbers can receive text
               #   messages. Can be: `true` or `false`.
               # @param [Boolean] mms_enabled Whether the phone numbers can receive MMS messages.
@@ -133,14 +139,14 @@ module Twilio
               # @param [Boolean] voice_enabled Whether the phone numbers can receive calls. Can
               #   be: `true` or `false`.
               # @param [Boolean] exclude_all_address_required Whether to exclude phone numbers
-              #   that require an [Address](https://www.twilio.com/docs/usage/api/address). Can
+              #   that require an {Address}[https://www.twilio.com/docs/usage/api/address]. Can
               #   be: `true` or `false` and the default is `false`.
               # @param [Boolean] exclude_local_address_required Whether to exclude phone numbers
-              #   that require a local [Address](https://www.twilio.com/docs/usage/api/address).
+              #   that require a local {Address}[https://www.twilio.com/docs/usage/api/address].
               #   Can be: `true` or `false` and the default is `false`.
               # @param [Boolean] exclude_foreign_address_required Whether to exclude phone
               #   numbers that require a foreign
-              #   [Address](https://www.twilio.com/docs/usage/api/address). Can be: `true` or
+              #   {Address}[https://www.twilio.com/docs/usage/api/address]. Can be: `true` or
               #   `false` and the default is `false`.
               # @param [Boolean] beta Whether to read phone numbers that are new to the Twilio
               #   platform. Can be: `true` or `false` and the default is `true`.
@@ -163,9 +169,9 @@ module Twilio
               #   a phone number search within the same rate center as that number. Requires
               #   `in_lata` to be set as well. Applies to only phone numbers in the US and Canada.
               # @param [String] in_lata Limit results to a specific local access and transport
-              #   area ([LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area)).
+              #   area ({LATA}[https://en.wikipedia.org/wiki/Local_access_and_transport_area]).
               #   Given a phone number, search within the same
-              #   [LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area) as that
+              #   {LATA}[https://en.wikipedia.org/wiki/Local_access_and_transport_area] as that
               #   number. Applies to only phone numbers in the US and Canada.
               # @param [String] in_locality Limit results to a particular locality or city.
               #   Given a phone number, search within the same Locality as that number.
@@ -227,8 +233,11 @@ module Twilio
               #   only phone numbers in the US and Canada.
               # @param [String] contains The pattern on which to match phone numbers. Valid
               #   characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any
-              #   single digit. For examples, see [Example
-              #   2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters.
+              #   single digit. For examples, see {Example
+              #   2}[https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2]
+              #   and {Example
+              #   3}[https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3].
+              #   If specified, this value must have at least two characters.
               # @param [Boolean] sms_enabled Whether the phone numbers can receive text
               #   messages. Can be: `true` or `false`.
               # @param [Boolean] mms_enabled Whether the phone numbers can receive MMS messages.
@@ -236,14 +245,14 @@ module Twilio
               # @param [Boolean] voice_enabled Whether the phone numbers can receive calls. Can
               #   be: `true` or `false`.
               # @param [Boolean] exclude_all_address_required Whether to exclude phone numbers
-              #   that require an [Address](https://www.twilio.com/docs/usage/api/address). Can
+              #   that require an {Address}[https://www.twilio.com/docs/usage/api/address]. Can
               #   be: `true` or `false` and the default is `false`.
               # @param [Boolean] exclude_local_address_required Whether to exclude phone numbers
-              #   that require a local [Address](https://www.twilio.com/docs/usage/api/address).
+              #   that require a local {Address}[https://www.twilio.com/docs/usage/api/address].
               #   Can be: `true` or `false` and the default is `false`.
               # @param [Boolean] exclude_foreign_address_required Whether to exclude phone
               #   numbers that require a foreign
-              #   [Address](https://www.twilio.com/docs/usage/api/address). Can be: `true` or
+              #   {Address}[https://www.twilio.com/docs/usage/api/address]. Can be: `true` or
               #   `false` and the default is `false`.
               # @param [Boolean] beta Whether to read phone numbers that are new to the Twilio
               #   platform. Can be: `true` or `false` and the default is `true`.
@@ -266,9 +275,9 @@ module Twilio
               #   a phone number search within the same rate center as that number. Requires
               #   `in_lata` to be set as well. Applies to only phone numbers in the US and Canada.
               # @param [String] in_lata Limit results to a specific local access and transport
-              #   area ([LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area)).
+              #   area ({LATA}[https://en.wikipedia.org/wiki/Local_access_and_transport_area]).
               #   Given a phone number, search within the same
-              #   [LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area) as that
+              #   {LATA}[https://en.wikipedia.org/wiki/Local_access_and_transport_area] as that
               #   number. Applies to only phone numbers in the US and Canada.
               # @param [String] in_locality Limit results to a particular locality or city.
               #   Given a phone number, search within the same Locality as that number.
@@ -369,7 +378,7 @@ module Twilio
               # @param [Hash] payload payload that contains response from Twilio
               # @param [String] account_sid The account_sid
               # @param [String] country_code The
-              #   [ISO-3166-1](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of
+              #   {ISO-3166-1}[https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] country code of
               #   the country.
               # @return [VoipInstance] VoipInstance
               def initialize(version, payload, account_sid: nil, country_code: nil)

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

@@ -16,7 +16,7 @@ module Twilio
             # Initialize the CallList
             # @param [Version] version Version that contains the resource
             # @param [String] account_sid The SID of the
-            #   [Account](https://www.twilio.com/docs/iam/api/account) that created this Call
+            #   {Account}[https://www.twilio.com/docs/iam/api/account] that created this Call
             #   resource.
             # @return [CallList] CallList
             def initialize(version, account_sid: nil)
@@ -34,8 +34,8 @@ module Twilio
             # Create the CallInstance
             # @param [String] to The phone number, SIP address, or client identifier to call.
             # @param [String] from The phone number or client identifier to use as the caller
-            #   id. If using a phone number, it must be a Twilio number or a Verified [outgoing
-            #   caller id](https://www.twilio.com/docs/voice/api/outgoing-caller-ids) for your
+            #   id. If using a phone number, it must be a Twilio number or a Verified {outgoing
+            #   caller id}[https://www.twilio.com/docs/voice/api/outgoing-caller-ids] for your
             #   account. If the `to` parameter is a phone number, `From` must also be a phone
             #   number.
             # @param [String] method The HTTP method we should use when calling the `url`
@@ -56,8 +56,9 @@ module Twilio
             #   to the `status_callback` URL. Can be: `initiated`, `ringing`, `answered`, and
             #   `completed`. If no event is specified, we send the `completed` status. If you
             #   want to receive multiple events, specify each one in a separate
-            #   `status_callback_event` parameter. See the code sample for [monitoring call
-            #   progress](https://www.twilio.com/docs/voice/api/call-resource?code-sample=code-create-a-call-resource-and-specify-a-statuscallbackevent&code-sdk-version=json). If an `application_sid` is present, this parameter is ignored.
+            #   `status_callback_event` parameter. See the code sample for {monitoring call
+            #   progress}[https://www.twilio.com/docs/voice/api/call-resource?code-sample=code-create-a-call-resource-and-specify-a-statuscallbackevent&code-sdk-version=json].
+            #   If an `application_sid` is present, this parameter is ignored.
             # @param [String] status_callback_method The HTTP method we should use when
             #   calling the `status_callback` URL. Can be: `GET` or `POST` and the default is
             #   `POST`. If an `application_sid` parameter is present, this parameter is ignored.
@@ -100,8 +101,8 @@ module Twilio
             #   Use `Enable` if you would like us to return `AnsweredBy` as soon as the called
             #   party is identified. Use `DetectMessageEnd`, if you would like to leave a
             #   message on an answering machine. If `send_digits` is provided, this parameter is
-            #   ignored. For more information, see [Answering Machine
-            #   Detection](https://www.twilio.com/docs/voice/answering-machine-detection).
+            #   ignored. For more information, see {Answering Machine
+            #   Detection}[https://www.twilio.com/docs/voice/answering-machine-detection].
             # @param [String] machine_detection_timeout The number of seconds that we should
             #   attempt to detect an answering machine before timing out and sending a voice
             #   request with `AnsweredBy` of `unknown`. The default timeout is 30 seconds.
@@ -113,8 +114,8 @@ module Twilio
             #   recording. Can be: `trim-silence` or `do-not-trim` and the default is
             #   `trim-silence`.
             # @param [String] caller_id The phone number, SIP address, or Client identifier
-            #   that made this call. Phone numbers are in [E.164
-            #   format](https://wwnw.twilio.com/docs/glossary/what-e164) (e.g., +16175551212).
+            #   that made this call. Phone numbers are in {E.164
+            #   format}[https://wwnw.twilio.com/docs/glossary/what-e164] (e.g., +16175551212).
             #   SIP addresses are formatted as `name@company.com`.
             # @param [String] machine_detection_speech_threshold The number of milliseconds
             #   that is used as the measuring stick for the length of the speech activity, where
@@ -143,9 +144,9 @@ module Twilio
             #   Calls Beta)
             # @param [String] url The absolute URL that returns the TwiML instructions for the
             #   call. We will call this URL using the `method` when the call connects. For more
-            #   information, see the [Url
-            #   Parameter](https://www.twilio.com/docs/voice/make-calls#specify-a-url-parameter)
-            #   section in [Making Calls](https://www.twilio.com/docs/voice/make-calls).
+            #   information, see the {Url
+            #   Parameter}[https://www.twilio.com/docs/voice/make-calls#specify-a-url-parameter]
+            #   section in {Making Calls}[https://www.twilio.com/docs/voice/make-calls].
             # @param [String] twiml TwiML instructions for the call Twilio will use without
             #   fetching Twiml from url parameter. If both `twiml` and `url` are provided then
             #   `twiml` parameter will be ignored.
@@ -410,7 +411,7 @@ module Twilio
             # Initialize the CallContext
             # @param [Version] version Version that contains the resource
             # @param [String] account_sid The SID of the
-            #   [Account](https://www.twilio.com/docs/iam/api/account) that created the Call
+            #   {Account}[https://www.twilio.com/docs/iam/api/account] that created the Call
             #   resource(s) to fetch.
             # @param [String] sid The SID of the Call resource to fetch.
             # @return [CallContext] CallContext
@@ -425,6 +426,7 @@ module Twilio
               @recordings = nil
               @notifications = nil
               @feedback = nil
+              @events = nil
               @payments = nil
             end
 
@@ -448,9 +450,9 @@ module Twilio
             # Update the CallInstance
             # @param [String] url The absolute URL that returns the TwiML instructions for the
             #   call. We will call this URL using the `method` when the call connects. For more
-            #   information, see the [Url
-            #   Parameter](https://www.twilio.com/docs/voice/make-calls#specify-a-url-parameter)
-            #   section in [Making Calls](https://www.twilio.com/docs/voice/make-calls).
+            #   information, see the {Url
+            #   Parameter}[https://www.twilio.com/docs/voice/make-calls#specify-a-url-parameter]
+            #   section in {Making Calls}[https://www.twilio.com/docs/voice/make-calls].
             # @param [String] method The HTTP method we should use when calling the `url`. Can
             #   be: `GET` or `POST` and the default is `POST`. If an `application_sid` parameter
             #   is present, this parameter is ignored.
@@ -545,6 +547,18 @@ module Twilio
               FeedbackContext.new(@version, @solution[:account_sid], @solution[:sid], )
             end
 
+            ##
+            # Access the events
+            # @return [EventList]
+            # @return [EventContext]
+            def events
+              unless @events
+                @events = EventList.new(@version, account_sid: @solution[:account_sid], call_sid: @solution[:sid], )
+              end
+
+              @events
+            end
+
             ##
             # Access the payments
             # @return [PaymentList]
@@ -588,7 +602,7 @@ module Twilio
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
             # @param [String] account_sid The SID of the
-            #   [Account](https://www.twilio.com/docs/iam/api/account) that created this Call
+            #   {Account}[https://www.twilio.com/docs/iam/api/account] that created this Call
             #   resource.
             # @param [String] sid The SID of the Call resource to fetch.
             # @return [CallInstance] CallInstance
@@ -822,9 +836,9 @@ module Twilio
             # Update the CallInstance
             # @param [String] url The absolute URL that returns the TwiML instructions for the
             #   call. We will call this URL using the `method` when the call connects. For more
-            #   information, see the [Url
-            #   Parameter](https://www.twilio.com/docs/voice/make-calls#specify-a-url-parameter)
-            #   section in [Making Calls](https://www.twilio.com/docs/voice/make-calls).
+            #   information, see the {Url
+            #   Parameter}[https://www.twilio.com/docs/voice/make-calls#specify-a-url-parameter]
+            #   section in {Making Calls}[https://www.twilio.com/docs/voice/make-calls].
             # @param [String] method The HTTP method we should use when calling the `url`. Can
             #   be: `GET` or `POST` and the default is `POST`. If an `application_sid` parameter
             #   is present, this parameter is ignored.
@@ -884,6 +898,13 @@ module Twilio
               context.feedback
             end
 
+            ##
+            # Access the events
+            # @return [events] events
+            def events
+              context.events
+            end
+
             ##
             # Access the payments
             # @return [payments] payments

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

@@ -0,0 +1,201 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Api < Domain
+      class V2010 < Version
+        class AccountContext < InstanceContext
+          class CallContext < InstanceContext
+            class EventList < ListResource
+              ##
+              # Initialize the EventList
+              # @param [Version] version Version that contains the resource
+              # @param [String] account_sid The SID of the
+              #   {Account}[https://www.twilio.com/docs/iam/api/account] that created this Call
+              #   resource.
+              # @param [String] call_sid The unique string that that we created to identify this
+              #   Call resource.
+              # @return [EventList] EventList
+              def initialize(version, account_sid: nil, call_sid: nil)
+                super(version)
+
+                # Path Solution
+                @solution = {account_sid: account_sid, call_sid: call_sid}
+                @uri = "/Accounts/#{@solution[:account_sid]}/Calls/#{@solution[:call_sid]}/Events.json"
+              end
+
+              ##
+              # 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 [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
+              #    not set will use the default value of 50 records.  If no page_size is defined
+              #    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(limit: nil, page_size: nil)
+                self.stream(limit: limit, page_size: page_size).entries
+              end
+
+              ##
+              # Streams EventInstance records from the API as an Enumerable.
+              # This operation lazily loads records as efficiently as possible until the limit
+              # is reached.
+              # @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
+              #    not set will use the default value of 50 records. If no page_size is defined
+              #    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(limit: nil, page_size: nil)
+                limits = @version.read_limits(limit, page_size)
+
+                page = self.page(page_size: limits[:page_size], )
+
+                @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
+              end
+
+              ##
+              # When passed a block, yields EventInstance records from the API.
+              # This operation lazily loads records as efficiently as possible until the limit
+              # is reached.
+              def each
+                limits = @version.read_limits
+
+                page = self.page(page_size: limits[:page_size], )
+
+                @version.stream(page,
+                                limit: limits[:limit],
+                                page_limit: limits[:page_limit]).each {|x| yield x}
+              end
+
+              ##
+              # Retrieve a single page of EventInstance records from the API.
+              # Request is executed immediately.
+              # @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 EventInstance
+              def page(page_token: :unset, page_number: :unset, page_size: :unset)
+                params = Twilio::Values.of({
+                    'PageToken' => page_token,
+                    'Page' => page_number,
+                    'PageSize' => page_size,
+                })
+
+                response = @version.page('GET', @uri, params: params)
+
+                EventPage.new(@version, response, @solution)
+              end
+
+              ##
+              # Retrieve a single page of EventInstance records from the API.
+              # Request is executed immediately.
+              # @param [String] target_url API-generated URL for the requested results page
+              # @return [Page] Page of EventInstance
+              def get_page(target_url)
+                response = @version.domain.request(
+                    'GET',
+                    target_url
+                )
+                EventPage.new(@version, response, @solution)
+              end
+
+              ##
+              # Provide a user friendly representation
+              def to_s
+                '#<Twilio.Api.V2010.EventList>'
+              end
+            end
+
+            class EventPage < Page
+              ##
+              # Initialize the EventPage
+              # @param [Version] version Version that contains the resource
+              # @param [Response] response Response from the API
+              # @param [Hash] solution Path solution for the resource
+              # @return [EventPage] EventPage
+              def initialize(version, response, solution)
+                super(version, response)
+
+                # Path Solution
+                @solution = solution
+              end
+
+              ##
+              # Build an instance of EventInstance
+              # @param [Hash] payload Payload response from the API
+              # @return [EventInstance] EventInstance
+              def get_instance(payload)
+                EventInstance.new(
+                    @version,
+                    payload,
+                    account_sid: @solution[:account_sid],
+                    call_sid: @solution[:call_sid],
+                )
+              end
+
+              ##
+              # Provide a user friendly representation
+              def to_s
+                '<Twilio.Api.V2010.EventPage>'
+              end
+            end
+
+            class EventInstance < InstanceResource
+              ##
+              # Initialize the EventInstance
+              # @param [Version] version Version that contains the resource
+              # @param [Hash] payload payload that contains response from Twilio
+              # @param [String] account_sid The SID of the
+              #   {Account}[https://www.twilio.com/docs/iam/api/account] that created this Call
+              #   resource.
+              # @param [String] call_sid The unique string that that we created to identify this
+              #   Call resource.
+              # @return [EventInstance] EventInstance
+              def initialize(version, payload, account_sid: nil, call_sid: nil)
+                super(version)
+
+                # Marshaled Properties
+                @properties = {'request' => payload['request'], 'response' => payload['response'], }
+              end
+
+              ##
+              # @return [Hash] Call Request.
+              def request
+                @properties['request']
+              end
+
+              ##
+              # @return [Hash] Call Response with Events.
+              def response
+                @properties['response']
+              end
+
+              ##
+              # Provide a user friendly representation
+              def to_s
+                "<Twilio.Api.V2010.EventInstance>"
+              end
+
+              ##
+              # Provide a detailed, user friendly representation
+              def inspect
+                "<Twilio.Api.V2010.EventInstance>"
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end