twilio-ruby 5.40.0 → 5.41.0

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
@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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.