RubyGems - twilio-ruby - Versions diffs - 5.40.0 → 5.41.0 - Mend

twilio-ruby 5.40.0 → 5.41.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (344) hide show

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

@@ -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
@@ -448,9 +449,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.
@@ -588,7 +589,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 +823,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.

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

@@ -17,7 +17,7 @@ module Twilio
               # Initialize the FeedbackList
               # @param [Version] version Version that contains the resource
               # @param [String] account_sid The unique id of the
-              #   [Account](https://www.twilio.com/docs/iam/api/account) responsible for this
+              #   {Account}[https://www.twilio.com/docs/iam/api/account] responsible for this
               #   resource.
               # @param [String] call_sid The unique string that that we created to identify this
               #   Call resource.
@@ -75,7 +75,7 @@ module Twilio
               # Initialize the FeedbackContext
               # @param [Version] version Version that contains the resource
               # @param [String] account_sid The unique id of the
-              #   [Account](https://www.twilio.com/docs/iam/api/account) responsible for this
+              #   {Account}[https://www.twilio.com/docs/iam/api/account] responsible for this
               #   resource.
               # @param [String] call_sid The call sid that uniquely identifies the call
               # @return [FeedbackContext] FeedbackContext
@@ -174,7 +174,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 unique id of the
-              #   [Account](https://www.twilio.com/docs/iam/api/account) responsible for this
+              #   {Account}[https://www.twilio.com/docs/iam/api/account] responsible for this
               #   resource.
               # @param [String] call_sid The unique string that that we created to identify this
               #   Call resource.

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

@@ -17,7 +17,7 @@ module Twilio
               # Initialize the FeedbackSummaryList
               # @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 [FeedbackSummaryList] FeedbackSummaryList
               def initialize(version, account_sid: nil)
@@ -97,7 +97,7 @@ module Twilio
               # Initialize the FeedbackSummaryContext
               # @param [Version] version Version that contains the resource
               # @param [String] account_sid The unique id of the
-              #   [Account](https://www.twilio.com/docs/iam/api/account) responsible for this
+              #   {Account}[https://www.twilio.com/docs/iam/api/account] responsible for this
               #   resource.
               # @param [String] sid A 34 character string that uniquely identifies this
               #   resource.
@@ -152,7 +152,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 A 34 character string that uniquely identifies this
               #   resource.

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

@@ -17,10 +17,10 @@ module Twilio
               # Initialize the NotificationList
               # @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
               #   Notification resource.
               # @param [String] call_sid The SID of the
-              #   [Call](https://www.twilio.com/docs/voice/api/call-resource) the Call
+              #   {Call}[https://www.twilio.com/docs/voice/api/call-resource] the Call
               #   Notification resource is associated with.
               # @return [NotificationList] NotificationList
               def initialize(version, account_sid: nil, call_sid: nil)
@@ -192,10 +192,10 @@ module Twilio
               # Initialize the NotificationContext
               # @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
               #   Notification resource to fetch.
               # @param [String] call_sid The
-              #   [Call](https://www.twilio.com/docs/voice/api/call-resource) SID of the Call
+              #   {Call}[https://www.twilio.com/docs/voice/api/call-resource] SID of the Call
               #   Notification resource to fetch.
               # @param [String] sid The Twilio-provided string that uniquely identifies the Call
               #   Notification resource to fetch.
@@ -244,10 +244,10 @@ 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 the Call
+              #   {Account}[https://www.twilio.com/docs/iam/api/account] that created the Call
               #   Notification resource.
               # @param [String] call_sid The SID of the
-              #   [Call](https://www.twilio.com/docs/voice/api/call-resource) the Call
+              #   {Call}[https://www.twilio.com/docs/voice/api/call-resource] the Call
               #   Notification resource is associated with.
               # @param [String] sid The Twilio-provided string that uniquely identifies the Call
               #   Notification resource to fetch.

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

@@ -19,10 +19,10 @@ module Twilio
               # Initialize the PaymentList
               # @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 Payments
+              #   {Account}[https://www.twilio.com/docs/iam/api/account] that created the Payments
               #   resource.
               # @param [String] call_sid The SID of the
-              #   [Call](https://www.twilio.com/docs/voice/api/call-resource) the Payments
+              #   {Call}[https://www.twilio.com/docs/voice/api/call-resource] the Payments
               #   resource is associated with. This will refer to the call sid that is producing
               #   the payment card (credit/ACH) information thru DTMF.
               # @return [PaymentList] PaymentList
@@ -41,17 +41,17 @@ module Twilio
               #   transactions. This should be a unique string value per API call and can be a
               #   randomly generated.
               # @param [String] status_callback Provide an absolute or relative URL to receive
-              #   status updates regarding your Pay session. Read more about the [expected
+              #   status updates regarding your Pay session. Read more about the {expected
               #   StatusCallback
-              #   values](https://www.twilio.com/docs/voice/api/payment-resource#statuscallback)
+              #   values}[https://www.twilio.com/docs/voice/api/payment-resource#statuscallback]
               # @param [payment.BankAccountType] bank_account_type Type of bank account if
               #   payment source is ACH. One of `consumer-checking`, `consumer-savings`, or
               #   `commercial-checking`. The default value is `consumer-checking`.
               # @param [String] charge_amount A positive decimal value less than 1,000,000 to
               #   charge against the credit card or bank account. Default currency can be
               #   overwritten with `currency` field. Leave blank or set to 0 to tokenize.
-              # @param [String] currency The currency of the `charge_amount`, formatted as [ISO
-              #   4127](http://www.iso.org/iso/home/standards/currency_codes.htm) format. The
+              # @param [String] currency The currency of the `charge_amount`, formatted as {ISO
+              #   4127}[http://www.iso.org/iso/home/standards/currency_codes.htm] format. The
               #   default value is `USD` and all values allowed from the <Pay> Connector are
               #   accepted.
               # @param [String] description The description can be used to provide more details
@@ -65,11 +65,11 @@ module Twilio
               #   this many digits.
               # @param [Hash] parameter A single level JSON string that is required when
               #   accepting certain information specific only to ACH payments. The information
-              #   that has to be included here depends on the <Pay> Connector. [Read
-              #   more](https://www.twilio.com/console/voice/pay-connectors).
+              #   that has to be included here depends on the <Pay> Connector. {Read
+              #   more}[https://www.twilio.com/console/voice/pay-connectors].
               # @param [String] payment_connector This is the unique name corresponding to the
               #   Payment Gateway Connector installed in the Twilio Add-ons. Learn more about
-              #   [<Pay> Connectors](https://www.twilio.com/console/voice/pay-connectors). The
+              #   {<Pay> Connectors}[https://www.twilio.com/console/voice/pay-connectors]. The
               #   default value is `Default`.
               # @param [payment.PaymentMethod] payment_method Type of payment being captured.
               #   One of `credit-card` or `ach-debit`. The default value is `credit-card`.
@@ -170,7 +170,7 @@ module Twilio
               # Initialize the PaymentContext
               # @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 will update the
+              #   {Account}[https://www.twilio.com/docs/iam/api/account] that will update the
               #   resource.
               # @param [String] call_sid The SID of the call that will update the resource. This
               #   should be the same call sid that was used to create payments resource.
@@ -192,7 +192,10 @@ module Twilio
               #   randomly generated.
               # @param [String] status_callback Provide an absolute or relative URL to receive
               #   status updates regarding your Pay session. Read more about the
-              #   [Update](https://www.twilio.com/docs/voice/api/payment-resource#statuscallback-update) and [Complete/Cancel](https://www.twilio.com/docs/voice/api/payment-resource#statuscallback-cancelcomplete) POST requests.
+              #   {Update}[https://www.twilio.com/docs/voice/api/payment-resource#statuscallback-update]
+              #   and
+              #   {Complete/Cancel}[https://www.twilio.com/docs/voice/api/payment-resource#statuscallback-cancelcomplete]
+              #   POST requests.
               # @param [payment.Capture] capture The piece of payment information that you wish
               #   the caller to enter. Must be one of `payment-card-number`, `expiration-date`,
               #   `security-code`, `postal-code`, `bank-routing-number`, or `bank-account-number`.
@@ -243,10 +246,10 @@ 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 the Payments
+              #   {Account}[https://www.twilio.com/docs/iam/api/account] that created the Payments
               #   resource.
               # @param [String] call_sid The SID of the
-              #   [Call](https://www.twilio.com/docs/voice/api/call-resource) the Payments
+              #   {Call}[https://www.twilio.com/docs/voice/api/call-resource] the Payments
               #   resource is associated with. This will refer to the call sid that is producing
               #   the payment card (credit/ACH) information thru DTMF.
               # @param [String] sid The SID of Payments session that needs to be updated.
@@ -329,7 +332,10 @@ module Twilio
               #   randomly generated.
               # @param [String] status_callback Provide an absolute or relative URL to receive
               #   status updates regarding your Pay session. Read more about the
-              #   [Update](https://www.twilio.com/docs/voice/api/payment-resource#statuscallback-update) and [Complete/Cancel](https://www.twilio.com/docs/voice/api/payment-resource#statuscallback-cancelcomplete) POST requests.
+              #   {Update}[https://www.twilio.com/docs/voice/api/payment-resource#statuscallback-update]
+              #   and
+              #   {Complete/Cancel}[https://www.twilio.com/docs/voice/api/payment-resource#statuscallback-cancelcomplete]
+              #   POST requests.
               # @param [payment.Capture] capture The piece of payment information that you wish
               #   the caller to enter. Must be one of `payment-card-number`, `expiration-date`,
               #   `security-code`, `postal-code`, `bank-routing-number`, or `bank-account-number`.

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

@@ -17,10 +17,10 @@ module Twilio
               # Initialize the RecordingList
               # @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
+              #   {Account}[https://www.twilio.com/docs/iam/api/account] that created the
               #   Recording resource.
               # @param [String] call_sid The SID of the
-              #   [Call](https://www.twilio.com/docs/voice/api/call-resource) the Recording
+              #   {Call}[https://www.twilio.com/docs/voice/api/call-resource] the Recording
               #   resource is associated with.
               # @return [RecordingList] RecordingList
               def initialize(version, account_sid: nil, call_sid: nil)
@@ -40,8 +40,8 @@ module Twilio
               # @param [String] recording_status_callback The URL we should call using the
               #   `recording_status_callback_method` on each recording event specified in
               #   `recording_status_callback_event`. For more information, see
-              #   [RecordingStatusCallback
-              #   parameters](https://www.twilio.com/docs/voice/api/recording#recordingstatuscallback).
+              #   {RecordingStatusCallback
+              #   parameters}[https://www.twilio.com/docs/voice/api/recording#recordingstatuscallback].
               # @param [String] recording_status_callback_method The HTTP method we should use
               #   to call `recording_status_callback`. Can be: `GET` or `POST` and the default is
               #   `POST`.
@@ -222,10 +222,10 @@ module Twilio
               # Initialize the RecordingContext
               # @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
+              #   {Account}[https://www.twilio.com/docs/iam/api/account] that created the
               #   Recording resource to fetch.
               # @param [String] call_sid The
-              #   [Call](https://www.twilio.com/docs/voice/api/call-resource) SID of the resource
+              #   {Call}[https://www.twilio.com/docs/voice/api/call-resource] SID of the resource
               #   to fetch.
               # @param [String] sid The Twilio-provided string that uniquely identifies the
               #   Recording resource to fetch.
@@ -305,10 +305,10 @@ 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 the
+              #   {Account}[https://www.twilio.com/docs/iam/api/account] that created the
               #   Recording resource.
               # @param [String] call_sid The SID of the
-              #   [Call](https://www.twilio.com/docs/voice/api/call-resource) the Recording
+              #   {Call}[https://www.twilio.com/docs/voice/api/call-resource] the Recording
               #   resource is associated with.
               # @param [String] sid The Twilio-provided string that uniquely identifies the
               #   Recording resource to fetch.

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

@@ -16,7 +16,7 @@ module Twilio
             # Initialize the ConferenceList
             # @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
+            #   {Account}[https://www.twilio.com/docs/iam/api/account] that created this
             #   Conference resource.
             # @return [ConferenceList] ConferenceList
             def initialize(version, account_sid: nil)
@@ -207,7 +207,7 @@ module Twilio
             # Initialize the ConferenceContext
             # @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
+            #   {Account}[https://www.twilio.com/docs/iam/api/account] that created the
             #   Conference resource(s) to fetch.
             # @param [String] sid The Twilio-provided string that uniquely identifies the
             #   Conference resource to fetch
@@ -331,7 +331,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
+            #   {Account}[https://www.twilio.com/docs/iam/api/account] that created this
             #   Conference resource.
             # @param [String] sid The Twilio-provided string that uniquely identifies the
             #   Conference resource to fetch

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

@@ -17,7 +17,7 @@ module Twilio
               # Initialize the ParticipantList
               # @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
+              #   {Account}[https://www.twilio.com/docs/iam/api/account] that created the
               #   Participant resource.
               # @param [String] conference_sid The SID of the conference the participant is in.
               # @return [ParticipantList] ParticipantList
@@ -33,20 +33,21 @@ module Twilio
               # Create the ParticipantInstance
               # @param [String] from The phone number, Client identifier, or username portion of
               #   SIP address that made this call. Phone numbers are in
-              #   [E.164](https://www.twilio.com/docs/glossary/what-e164) format (e.g.,
+              #   {E.164}[https://www.twilio.com/docs/glossary/what-e164] format (e.g.,
               #   +16175551212). Client identifiers are formatted `client:name`. 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.
+              #   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. If
               #   `to` is sip address, this value of `from` should be a username portion to be
               #   used to populate the P-Asserted-Identity header that is passed to the SIP
               #   endpoint.
               # @param [String] to The phone number, SIP address, or Client identifier that
               #   received this call. Phone numbers are in
-              #   [E.164](https://www.twilio.com/docs/glossary/what-e164) format (e.g.,
+              #   {E.164}[https://www.twilio.com/docs/glossary/what-e164] format (e.g.,
               #   +16175551212). SIP addresses are formatted as `sip:name@company.com`. Client
-              #   identifiers are formatted `client:name`. [Custom
-              #   parameters](https://www.twilio.com/docs/voice/api/conference-participant-resource#custom-parameters) may also be specified.
+              #   identifiers are formatted `client:name`. {Custom
+              #   parameters}[https://www.twilio.com/docs/voice/api/conference-participant-resource#custom-parameters]
+              #   may also be specified.
               # @param [String] status_callback The URL we should call using the
               #   `status_callback_method` to send status information to your application.
               # @param [String] status_callback_method The HTTP method we should use to call
@@ -79,8 +80,8 @@ module Twilio
               #   participant leaves. Can be: `true` or `false` and defaults to `false`.
               # @param [String] wait_url The URL we should call using the `wait_method` for the
               #   music to play while participants are waiting for the conference to start. The
-              #   default value is the URL of our standard hold music. [Learn more about hold
-              #   music](https://www.twilio.com/labs/twimlets/holdmusic).
+              #   default value is the URL of our standard hold music. {Learn more about hold
+              #   music}[https://www.twilio.com/labs/twimlets/holdmusic].
               # @param [String] wait_method The HTTP method we should use to call `wait_url`.
               #   Can be `GET` or `POST` and the default is `POST`. When using a static audio
               #   file, this should be `GET` so that we can cache the file.
@@ -118,7 +119,9 @@ module Twilio
               # @param [String] sip_auth_username The SIP username used for authentication.
               # @param [String] sip_auth_password The SIP password for authentication.
               # @param [String] region The
-              #   [region](https://support.twilio.com/hc/en-us/articles/223132167-How-global-low-latency-routing-and-region-selection-work-for-conferences-and-Client-calls) where we should mix the recorded audio. Can be:`us1`, `ie1`, `de1`, `sg1`, `br1`, `au1`, or `jp1`.
+              #   {region}[https://support.twilio.com/hc/en-us/articles/223132167-How-global-low-latency-routing-and-region-selection-work-for-conferences-and-Client-calls]
+              #   where we should mix the recorded audio. Can be:`us1`, `ie1`, `de1`, `sg1`,
+              #   `br1`, `au1`, or `jp1`.
               # @param [String] conference_recording_status_callback The URL we should call
               #   using the `conference_recording_status_callback_method` when the conference
               #   recording is available.
@@ -149,15 +152,18 @@ module Twilio
               #   it will otherwise be ignored. (Beta)
               # @param [String] caller_id The phone number, Client identifier, or username
               #   portion of SIP address that made this call. Phone numbers are in
-              #   [E.164](https://www.twilio.com/docs/glossary/what-e164) format (e.g.,
+              #   {E.164}[https://www.twilio.com/docs/glossary/what-e164] format (e.g.,
               #   +16175551212). Client identifiers are formatted `client:name`. 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.
+              #   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, `callerId` must also be a phone number.
               #   If `to` is sip address, this value of `callerId` should be a username portion to
               #   be used to populate the From header that is passed to the SIP endpoint.
+              # @param [String] call_reason The Reason for the outgoing call. Use it to specify
+              #   the purpose of the call that is presented on the called party's phone. (Branded
+              #   Calls Beta)
               # @return [ParticipantInstance] Created ParticipantInstance
-              def create(from: nil, to: nil, status_callback: :unset, status_callback_method: :unset, status_callback_event: :unset, label: :unset, timeout: :unset, record: :unset, muted: :unset, beep: :unset, start_conference_on_enter: :unset, end_conference_on_exit: :unset, wait_url: :unset, wait_method: :unset, early_media: :unset, max_participants: :unset, conference_record: :unset, conference_trim: :unset, conference_status_callback: :unset, conference_status_callback_method: :unset, conference_status_callback_event: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, sip_auth_username: :unset, sip_auth_password: :unset, region: :unset, conference_recording_status_callback: :unset, conference_recording_status_callback_method: :unset, recording_status_callback_event: :unset, conference_recording_status_callback_event: :unset, coaching: :unset, call_sid_to_coach: :unset, jitter_buffer_size: :unset, byoc: :unset, caller_id: :unset)
+              def create(from: nil, to: nil, status_callback: :unset, status_callback_method: :unset, status_callback_event: :unset, label: :unset, timeout: :unset, record: :unset, muted: :unset, beep: :unset, start_conference_on_enter: :unset, end_conference_on_exit: :unset, wait_url: :unset, wait_method: :unset, early_media: :unset, max_participants: :unset, conference_record: :unset, conference_trim: :unset, conference_status_callback: :unset, conference_status_callback_method: :unset, conference_status_callback_event: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, sip_auth_username: :unset, sip_auth_password: :unset, region: :unset, conference_recording_status_callback: :unset, conference_recording_status_callback_method: :unset, recording_status_callback_event: :unset, conference_recording_status_callback_event: :unset, coaching: :unset, call_sid_to_coach: :unset, jitter_buffer_size: :unset, byoc: :unset, caller_id: :unset, call_reason: :unset)
                 data = Twilio::Values.of({
                     'From' => from,
                     'To' => to,
@@ -195,6 +201,7 @@ module Twilio
                     'JitterBufferSize' => jitter_buffer_size,
                     'Byoc' => byoc,
                     'CallerId' => caller_id,
+                    'CallReason' => call_reason,
                 })
                 payload = @version.create('POST', @uri, data: data)
@@ -360,12 +367,12 @@ module Twilio
               # Initialize the ParticipantContext
               # @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
+              #   {Account}[https://www.twilio.com/docs/iam/api/account] that created the
               #   Participant resource to fetch.
               # @param [String] conference_sid The SID of the conference with the participant to
               #   fetch.
               # @param [String] call_sid The
-              #   [Call](https://www.twilio.com/docs/voice/api/call-resource) SID or label of the
+              #   {Call}[https://www.twilio.com/docs/voice/api/call-resource] SID or label of the
               #   participant to fetch. Non URL safe characters in a label must be percent
               #   encoded, for example, a space character is represented as %20.
               # @return [ParticipantContext] ParticipantContext
@@ -413,8 +420,8 @@ module Twilio
               #   `announce_url`. Can be: `GET` or `POST` and defaults to `POST`.
               # @param [String] wait_url The URL we should call using the `wait_method` for the
               #   music to play while participants are waiting for the conference to start. The
-              #   default value is the URL of our standard hold music. [Learn more about hold
-              #   music](https://www.twilio.com/labs/twimlets/holdmusic).
+              #   default value is the URL of our standard hold music. {Learn more about hold
+              #   music}[https://www.twilio.com/labs/twimlets/holdmusic].
               # @param [String] wait_method The HTTP method we should use to call `wait_url`.
               #   Can be `GET` or `POST` and the default is `POST`. When using a static audio
               #   file, this should be `GET` so that we can cache the file.
@@ -484,11 +491,11 @@ 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 the
+              #   {Account}[https://www.twilio.com/docs/iam/api/account] that created the
               #   Participant resource.
               # @param [String] conference_sid The SID of the conference the participant is in.
               # @param [String] call_sid The
-              #   [Call](https://www.twilio.com/docs/voice/api/call-resource) SID or label of the
+              #   {Call}[https://www.twilio.com/docs/voice/api/call-resource] SID or label of the
               #   participant to fetch. Non URL safe characters in a label must be percent
               #   encoded, for example, a space character is represented as %20.
               # @return [ParticipantInstance] ParticipantInstance
@@ -650,8 +657,8 @@ module Twilio
               #   `announce_url`. Can be: `GET` or `POST` and defaults to `POST`.
               # @param [String] wait_url The URL we should call using the `wait_method` for the
               #   music to play while participants are waiting for the conference to start. The
-              #   default value is the URL of our standard hold music. [Learn more about hold
-              #   music](https://www.twilio.com/labs/twimlets/holdmusic).
+              #   default value is the URL of our standard hold music. {Learn more about hold
+              #   music}[https://www.twilio.com/labs/twimlets/holdmusic].
               # @param [String] wait_method The HTTP method we should use to call `wait_url`.
               #   Can be `GET` or `POST` and the default is `POST`. When using a static audio
               #   file, this should be `GET` so that we can cache the file.