twilio-ruby 5.20.0 → 5.47.0

data/lib/twilio-ruby/rest/preview/hosted_numbers.rb

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio

data/lib/twilio-ruby/rest/preview/hosted_numbers/authorization_document.rb

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -33,8 +33,9 @@ module Twilio
           #   signing.
           # @param [authorization_document.Status] status Status of an instance resource. It
           #   can hold one of the values: 1. opened 2. signing, 3. signed LOA, 4. canceled, 5.
-          #   failed. See the section entitled [Status
-          #   Values](https://www.twilio.com/docs/api/phone-numbers/hosted-number-authorization-documents#status-values) for more information on each of these statuses.
+          #   failed. See the section entitled {Status
+          #   Values}[https://www.twilio.com/docs/api/phone-numbers/hosted-number-authorization-documents#status-values]
+          #   for more information on each of these statuses.
           # @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
@@ -54,8 +55,9 @@ module Twilio
           #   signing.
           # @param [authorization_document.Status] status Status of an instance resource. It
           #   can hold one of the values: 1. opened 2. signing, 3. signed LOA, 4. canceled, 5.
-          #   failed. See the section entitled [Status
-          #   Values](https://www.twilio.com/docs/api/phone-numbers/hosted-number-authorization-documents#status-values) for more information on each of these statuses.
+          #   failed. See the section entitled {Status
+          #   Values}[https://www.twilio.com/docs/api/phone-numbers/hosted-number-authorization-documents#status-values]
+          #   for more information on each of these statuses.
           # @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
@@ -92,8 +94,9 @@ module Twilio
           #   signing.
           # @param [authorization_document.Status] status Status of an instance resource. It
           #   can hold one of the values: 1. opened 2. signing, 3. signed LOA, 4. canceled, 5.
-          #   failed. See the section entitled [Status
-          #   Values](https://www.twilio.com/docs/api/phone-numbers/hosted-number-authorization-documents#status-values) for more information on each of these statuses.
+          #   failed. See the section entitled {Status
+          #   Values}[https://www.twilio.com/docs/api/phone-numbers/hosted-number-authorization-documents#status-values]
+          #   for more information on each of these statuses.
           # @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
@@ -106,11 +109,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params: params)
+
             AuthorizationDocumentPage.new(@version, response, @solution)
           end
 
@@ -128,11 +129,10 @@ module Twilio
           end
 
           ##
-          # Retrieve a single page of AuthorizationDocumentInstance records from the API.
-          # Request is executed immediately.
-          # @param [String] hosted_number_order_sids A list of HostedNumberOrder sids that
-          #   this AuthorizationDocument will authorize for hosting phone number capabilities
-          #   on Twilio's platform.
+          # Create the AuthorizationDocumentInstance
+          # @param [Array[String]] hosted_number_order_sids A list of HostedNumberOrder sids
+          #   that this AuthorizationDocument will authorize for hosting phone number
+          #   capabilities on Twilio's platform.
           # @param [String] address_sid A 34 character string that uniquely identifies the
           #   Address resource that is associated with this AuthorizationDocument.
           # @param [String] email Email that this AuthorizationDocument will be sent to for
@@ -141,9 +141,9 @@ module Twilio
           #   Authorization Document for this phone number.
           # @param [String] contact_phone_number The contact phone number of the person
           #   authorized to sign the Authorization Document.
-          # @param [String] cc_emails Email recipients who will be informed when an
+          # @param [Array[String]] cc_emails Email recipients who will be informed when an
           #   Authorization Document has been sent and signed.
-          # @return [AuthorizationDocumentInstance] Newly created AuthorizationDocumentInstance
+          # @return [AuthorizationDocumentInstance] Created AuthorizationDocumentInstance
           def create(hosted_number_order_sids: nil, address_sid: nil, email: nil, contact_title: nil, contact_phone_number: nil, cc_emails: :unset)
             data = Twilio::Values.of({
                 'HostedNumberOrderSids' => Twilio.serialize_list(hosted_number_order_sids) { |e| e },
@@ -154,11 +154,7 @@ module Twilio
                 'CcEmails' => Twilio.serialize_list(cc_emails) { |e| e },
             })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data)
 
             AuthorizationDocumentInstance.new(@version, payload, )
           end
@@ -222,35 +218,30 @@ module Twilio
           end
 
           ##
-          # Fetch a AuthorizationDocumentInstance
+          # Fetch the AuthorizationDocumentInstance
           # @return [AuthorizationDocumentInstance] Fetched AuthorizationDocumentInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             AuthorizationDocumentInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
           # Update the AuthorizationDocumentInstance
-          # @param [String] hosted_number_order_sids A list of HostedNumberOrder sids that
-          #   this AuthorizationDocument will authorize for hosting phone number capabilities
-          #   on Twilio's platform.
+          # @param [Array[String]] hosted_number_order_sids A list of HostedNumberOrder sids
+          #   that this AuthorizationDocument will authorize for hosting phone number
+          #   capabilities on Twilio's platform.
           # @param [String] address_sid A 34 character string that uniquely identifies the
           #   Address resource that is associated with this AuthorizationDocument.
           # @param [String] email Email that this AuthorizationDocument will be sent to for
           #   signing.
-          # @param [String] cc_emails Email recipients who will be informed when an
+          # @param [Array[String]] cc_emails Email recipients who will be informed when an
           #   Authorization Document has been sent and signed
           # @param [authorization_document.Status] status Status of an instance resource. It
           #   can hold one of the values: 1. opened 2. signing, 3. signed LOA, 4. canceled, 5.
-          #   failed. See the section entitled [Status
-          #   Values](https://www.twilio.com/docs/api/phone-numbers/hosted-number-authorization-documents#status-values) for more information on each of these statuses.
+          #   failed. See the section entitled {Status
+          #   Values}[https://www.twilio.com/docs/api/phone-numbers/hosted-number-authorization-documents#status-values]
+          #   for more information on each of these statuses.
           # @param [String] contact_title The title of the person authorized to sign the
           #   Authorization Document for this phone number.
           # @param [String] contact_phone_number The contact phone number of the person
@@ -267,11 +258,7 @@ module Twilio
                 'ContactPhoneNumber' => contact_phone_number,
             })
 
-            payload = @version.update(
-                'POST',
-                @uri,
-                data: data,
-            )
+            payload = @version.update('POST', @uri, data: data)
 
             AuthorizationDocumentInstance.new(@version, payload, sid: @solution[:sid], )
           end
@@ -297,6 +284,13 @@ module Twilio
             context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
             "#<Twilio.Preview.HostedNumbers.AuthorizationDocumentContext #{context}>"
           end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Preview.HostedNumbers.AuthorizationDocumentContext #{context}>"
+          end
         end
 
         ##
@@ -366,7 +360,7 @@ module Twilio
           end
 
           ##
-          # @return [String] A list of emails.
+          # @return [Array[String]] A list of emails.
           def cc_emails
             @properties['cc_emails']
           end
@@ -396,7 +390,7 @@ module Twilio
           end
 
           ##
-          # Fetch a AuthorizationDocumentInstance
+          # Fetch the AuthorizationDocumentInstance
           # @return [AuthorizationDocumentInstance] Fetched AuthorizationDocumentInstance
           def fetch
             context.fetch
@@ -404,19 +398,20 @@ module Twilio
 
           ##
           # Update the AuthorizationDocumentInstance
-          # @param [String] hosted_number_order_sids A list of HostedNumberOrder sids that
-          #   this AuthorizationDocument will authorize for hosting phone number capabilities
-          #   on Twilio's platform.
+          # @param [Array[String]] hosted_number_order_sids A list of HostedNumberOrder sids
+          #   that this AuthorizationDocument will authorize for hosting phone number
+          #   capabilities on Twilio's platform.
           # @param [String] address_sid A 34 character string that uniquely identifies the
           #   Address resource that is associated with this AuthorizationDocument.
           # @param [String] email Email that this AuthorizationDocument will be sent to for
           #   signing.
-          # @param [String] cc_emails Email recipients who will be informed when an
+          # @param [Array[String]] cc_emails Email recipients who will be informed when an
           #   Authorization Document has been sent and signed
           # @param [authorization_document.Status] status Status of an instance resource. It
           #   can hold one of the values: 1. opened 2. signing, 3. signed LOA, 4. canceled, 5.
-          #   failed. See the section entitled [Status
-          #   Values](https://www.twilio.com/docs/api/phone-numbers/hosted-number-authorization-documents#status-values) for more information on each of these statuses.
+          #   failed. See the section entitled {Status
+          #   Values}[https://www.twilio.com/docs/api/phone-numbers/hosted-number-authorization-documents#status-values]
+          #   for more information on each of these statuses.
           # @param [String] contact_title The title of the person authorized to sign the
           #   Authorization Document for this phone number.
           # @param [String] contact_phone_number The contact phone number of the person

data/lib/twilio-ruby/rest/preview/hosted_numbers/authorization_document/dependent_hosted_number_order.rb

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -34,8 +34,9 @@ module Twilio
             # memory before returning.
             # @param [dependent_hosted_number_order.Status] status Status of an instance
             #   resource. It can hold one of the values: 1. opened 2. signing, 3. signed LOA, 4.
-            #   canceled, 5. failed. See the section entitled [Status
-            #   Values](https://www.twilio.com/docs/api/phone-numbers/hosted-number-authorization-documents#status-values) for more information on each of these statuses.
+            #   canceled, 5. failed. See the section entitled {Status
+            #   Values}[https://www.twilio.com/docs/api/phone-numbers/hosted-number-authorization-documents#status-values]
+            #   for more information on each of these statuses.
             # @param [String] phone_number An E164 formatted phone number hosted by this
             #   HostedNumberOrder.
             # @param [String] incoming_phone_number_sid A 34 character string that uniquely
@@ -70,8 +71,9 @@ module Twilio
             # is reached.
             # @param [dependent_hosted_number_order.Status] status Status of an instance
             #   resource. It can hold one of the values: 1. opened 2. signing, 3. signed LOA, 4.
-            #   canceled, 5. failed. See the section entitled [Status
-            #   Values](https://www.twilio.com/docs/api/phone-numbers/hosted-number-authorization-documents#status-values) for more information on each of these statuses.
+            #   canceled, 5. failed. See the section entitled {Status
+            #   Values}[https://www.twilio.com/docs/api/phone-numbers/hosted-number-authorization-documents#status-values]
+            #   for more information on each of these statuses.
             # @param [String] phone_number An E164 formatted phone number hosted by this
             #   HostedNumberOrder.
             # @param [String] incoming_phone_number_sid A 34 character string that uniquely
@@ -122,8 +124,9 @@ module Twilio
             # Request is executed immediately.
             # @param [dependent_hosted_number_order.Status] status Status of an instance
             #   resource. It can hold one of the values: 1. opened 2. signing, 3. signed LOA, 4.
-            #   canceled, 5. failed. See the section entitled [Status
-            #   Values](https://www.twilio.com/docs/api/phone-numbers/hosted-number-authorization-documents#status-values) for more information on each of these statuses.
+            #   canceled, 5. failed. See the section entitled {Status
+            #   Values}[https://www.twilio.com/docs/api/phone-numbers/hosted-number-authorization-documents#status-values]
+            #   for more information on each of these statuses.
             # @param [String] phone_number An E164 formatted phone number hosted by this
             #   HostedNumberOrder.
             # @param [String] incoming_phone_number_sid A 34 character string that uniquely
@@ -148,11 +151,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               DependentHostedNumberOrderPage.new(@version, response, @solution)
             end
 
@@ -342,7 +343,7 @@ module Twilio
             end
 
             ##
-            # @return [String] A list of emails.
+            # @return [Array[String]] A list of emails.
             def cc_emails
               @properties['cc_emails']
             end
@@ -378,7 +379,7 @@ module Twilio
             end
 
             ##
-            # @return [String] List of IDs for ownership verification calls.
+            # @return [Array[String]] List of IDs for ownership verification calls.
             def verification_call_sids
               @properties['verification_call_sids']
             end

data/lib/twilio-ruby/rest/preview/hosted_numbers/hosted_number_order.rb

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -142,11 +142,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params: params)
+
             HostedNumberOrderPage.new(@version, response, @solution)
           end
 
@@ -164,10 +162,9 @@ module Twilio
           end
 
           ##
-          # Retrieve a single page of HostedNumberOrderInstance records from the API.
-          # Request is executed immediately.
+          # Create the HostedNumberOrderInstance
           # @param [String] phone_number The number to host in
-          #   [+E.164](https://en.wikipedia.org/wiki/E.164) format
+          #   {+E.164}[https://en.wikipedia.org/wiki/E.164] format
           # @param [Boolean] sms_capability Used to specify that the SMS capability will be
           #   hosted on Twilio's platform.
           # @param [String] account_sid This defaults to the AccountSid of the authorization
@@ -178,8 +175,8 @@ module Twilio
           # @param [String] unique_name Optional. Provides a unique and addressable name to
           #   be assigned to this HostedNumberOrder, assigned by the developer, to be
           #   optionally used in addition to SID.
-          # @param [String] cc_emails Optional. A list of emails that the LOA document for
-          #   this HostedNumberOrder will be carbon copied to.
+          # @param [Array[String]] cc_emails Optional. A list of emails that the LOA
+          #   document for this HostedNumberOrder will be carbon copied to.
           # @param [String] sms_url The URL that Twilio should request when somebody sends
           #   an SMS to the phone number. This will be copied onto the IncomingPhoneNumber
           #   resource.
@@ -211,7 +208,7 @@ module Twilio
           # @param [String] verification_document_sid Optional. The unique sid identifier of
           #   the Identity Document that represents the document for verifying ownership of
           #   the number to be hosted. Required when VerificationType is phone-bill.
-          # @return [HostedNumberOrderInstance] Newly created HostedNumberOrderInstance
+          # @return [HostedNumberOrderInstance] Created HostedNumberOrderInstance
           def create(phone_number: nil, sms_capability: nil, account_sid: :unset, friendly_name: :unset, unique_name: :unset, cc_emails: :unset, sms_url: :unset, sms_method: :unset, sms_fallback_url: :unset, sms_fallback_method: :unset, status_callback_url: :unset, status_callback_method: :unset, sms_application_sid: :unset, address_sid: :unset, email: :unset, verification_type: :unset, verification_document_sid: :unset)
             data = Twilio::Values.of({
                 'PhoneNumber' => phone_number,
@@ -233,11 +230,7 @@ module Twilio
                 'VerificationDocumentSid' => verification_document_sid,
             })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data)
 
             HostedNumberOrderInstance.new(@version, payload, )
           end
@@ -298,25 +291,19 @@ module Twilio
           end
 
           ##
-          # Fetch a HostedNumberOrderInstance
+          # Fetch the HostedNumberOrderInstance
           # @return [HostedNumberOrderInstance] Fetched HostedNumberOrderInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             HostedNumberOrderInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
-          # Deletes the HostedNumberOrderInstance
-          # @return [Boolean] true if delete succeeds, true otherwise
+          # Delete the HostedNumberOrderInstance
+          # @return [Boolean] true if delete succeeds, false otherwise
           def delete
-            @version.delete('delete', @uri)
+             @version.delete('DELETE', @uri)
           end
 
           ##
@@ -328,8 +315,8 @@ module Twilio
           #   used in addition to SID.
           # @param [String] email Email of the owner of this phone number that is being
           #   hosted.
-          # @param [String] cc_emails Optional. A list of emails that LOA document for this
-          #   HostedNumberOrder will be carbon copied to.
+          # @param [Array[String]] cc_emails Optional. A list of emails that LOA document
+          #   for this HostedNumberOrder will be carbon copied to.
           # @param [hosted_number_order.Status] status User can only post to
           #   `pending-verification` status to transition the HostedNumberOrder to initiate a
           #   verification call or verification of ownership with a copy of a phone bill.
@@ -359,11 +346,7 @@ module Twilio
                 'CallDelay' => call_delay,
             })
 
-            payload = @version.update(
-                'POST',
-                @uri,
-                data: data,
-            )
+            payload = @version.update('POST', @uri, data: data)
 
             HostedNumberOrderInstance.new(@version, payload, sid: @solution[:sid], )
           end
@@ -374,6 +357,13 @@ module Twilio
             context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
             "#<Twilio.Preview.HostedNumbers.HostedNumberOrderContext #{context}>"
           end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Preview.HostedNumbers.HostedNumberOrderContext #{context}>"
+          end
         end
 
         ##
@@ -523,7 +513,7 @@ module Twilio
           end
 
           ##
-          # @return [String] A list of emails.
+          # @return [Array[String]] A list of emails.
           def cc_emails
             @properties['cc_emails']
           end
@@ -565,21 +555,21 @@ module Twilio
           end
 
           ##
-          # @return [String] List of IDs for ownership verification calls.
+          # @return [Array[String]] List of IDs for ownership verification calls.
           def verification_call_sids
             @properties['verification_call_sids']
           end
 
           ##
-          # Fetch a HostedNumberOrderInstance
+          # Fetch the HostedNumberOrderInstance
           # @return [HostedNumberOrderInstance] Fetched HostedNumberOrderInstance
           def fetch
             context.fetch
           end
 
           ##
-          # Deletes the HostedNumberOrderInstance
-          # @return [Boolean] true if delete succeeds, true otherwise
+          # Delete the HostedNumberOrderInstance
+          # @return [Boolean] true if delete succeeds, false otherwise
           def delete
             context.delete
           end
@@ -593,8 +583,8 @@ module Twilio
           #   used in addition to SID.
           # @param [String] email Email of the owner of this phone number that is being
           #   hosted.
-          # @param [String] cc_emails Optional. A list of emails that LOA document for this
-          #   HostedNumberOrder will be carbon copied to.
+          # @param [Array[String]] cc_emails Optional. A list of emails that LOA document
+          #   for this HostedNumberOrder will be carbon copied to.
           # @param [hosted_number_order.Status] status User can only post to
           #   `pending-verification` status to transition the HostedNumberOrder to initiate a
           #   verification call or verification of ownership with a copy of a phone bill.