twilio-ruby 5.31.1 → 5.54.0

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

@@ -16,7 +16,7 @@ module Twilio
             # Initialize the ShortCodeList
             # @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
             #   ShortCode resource.
             # @return [ShortCodeList] ShortCodeList
             def initialize(version, account_sid: nil)
@@ -114,11 +114,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               ShortCodePage.new(@version, response, @solution)
             end
 
@@ -176,7 +174,7 @@ module Twilio
             # Initialize the ShortCodeContext
             # @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
             #   ShortCode resource(s) to fetch.
             # @param [String] sid The Twilio-provided string that uniquely identifies the
             #   ShortCode resource to fetch
@@ -190,16 +188,10 @@ module Twilio
             end
 
             ##
-            # Fetch a ShortCodeInstance
+            # Fetch the ShortCodeInstance
             # @return [ShortCodeInstance] Fetched ShortCodeInstance
             def fetch
-              params = Twilio::Values.of({})
-
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
+              payload = @version.fetch('GET', @uri)
 
               ShortCodeInstance.new(@version, payload, account_sid: @solution[:account_sid], sid: @solution[:sid], )
             end
@@ -230,11 +222,7 @@ module Twilio
                   'SmsFallbackMethod' => sms_fallback_method,
               })
 
-              payload = @version.update(
-                  'POST',
-                  @uri,
-                  data: data,
-              )
+              payload = @version.update('POST', @uri, data: data)
 
               ShortCodeInstance.new(@version, payload, account_sid: @solution[:account_sid], sid: @solution[:sid], )
             end
@@ -260,7 +248,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
             #   ShortCode resource.
             # @param [String] sid The Twilio-provided string that uniquely identifies the
             #   ShortCode resource to fetch
@@ -373,7 +361,7 @@ module Twilio
             end
 
             ##
-            # Fetch a ShortCodeInstance
+            # Fetch the ShortCodeInstance
             # @return [ShortCodeInstance] Fetched ShortCodeInstance
             def fetch
               context.fetch

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

@@ -87,11 +87,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               SigningKeyPage.new(@version, response, @solution)
             end
 
@@ -160,16 +158,10 @@ module Twilio
             end
 
             ##
-            # Fetch a SigningKeyInstance
+            # Fetch the SigningKeyInstance
             # @return [SigningKeyInstance] Fetched SigningKeyInstance
             def fetch
-              params = Twilio::Values.of({})
-
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
+              payload = @version.fetch('GET', @uri)
 
               SigningKeyInstance.new(
                   @version,
@@ -186,11 +178,7 @@ module Twilio
             def update(friendly_name: :unset)
               data = Twilio::Values.of({'FriendlyName' => friendly_name, })
 
-              payload = @version.update(
-                  'POST',
-                  @uri,
-                  data: data,
-              )
+              payload = @version.update('POST', @uri, data: data)
 
               SigningKeyInstance.new(
                   @version,
@@ -201,10 +189,10 @@ module Twilio
             end
 
             ##
-            # Deletes the SigningKeyInstance
+            # Delete the SigningKeyInstance
             # @return [Boolean] true if delete succeeds, false otherwise
             def delete
-              @version.delete('delete', @uri)
+               @version.delete('DELETE', @uri)
             end
 
             ##
@@ -283,7 +271,7 @@ module Twilio
             end
 
             ##
-            # Fetch a SigningKeyInstance
+            # Fetch the SigningKeyInstance
             # @return [SigningKeyInstance] Fetched SigningKeyInstance
             def fetch
               context.fetch
@@ -298,7 +286,7 @@ module Twilio
             end
 
             ##
-            # Deletes the SigningKeyInstance
+            # Delete the SigningKeyInstance
             # @return [Boolean] true if delete succeeds, false otherwise
             def delete
               context.delete

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

@@ -88,11 +88,9 @@ module Twilio
                     'Page' => page_number,
                     'PageSize' => page_size,
                 })
-                response = @version.page(
-                    'GET',
-                    @uri,
-                    params
-                )
+
+                response = @version.page('GET', @uri, params: params)
+
                 CredentialListPage.new(@version, response, @solution)
               end
 
@@ -110,19 +108,14 @@ module Twilio
               end
 
               ##
-              # Retrieve a single page of CredentialListInstance records from the API.
-              # Request is executed immediately.
+              # Create the CredentialListInstance
               # @param [String] friendly_name A human readable descriptive text that describes
               #   the CredentialList, up to 64 characters long.
-              # @return [CredentialListInstance] Newly created CredentialListInstance
+              # @return [CredentialListInstance] Created CredentialListInstance
               def create(friendly_name: nil)
                 data = Twilio::Values.of({'FriendlyName' => friendly_name, })
 
-                payload = @version.create(
-                    'POST',
-                    @uri,
-                    data: data
-                )
+                payload = @version.create('POST', @uri, data: data)
 
                 CredentialListInstance.new(@version, payload, account_sid: @solution[:account_sid], )
               end
@@ -184,16 +177,10 @@ module Twilio
               end
 
               ##
-              # Fetch a CredentialListInstance
+              # Fetch the CredentialListInstance
               # @return [CredentialListInstance] Fetched CredentialListInstance
               def fetch
-                params = Twilio::Values.of({})
-
-                payload = @version.fetch(
-                    'GET',
-                    @uri,
-                    params,
-                )
+                payload = @version.fetch('GET', @uri)
 
                 CredentialListInstance.new(
                     @version,
@@ -211,11 +198,7 @@ module Twilio
               def update(friendly_name: nil)
                 data = Twilio::Values.of({'FriendlyName' => friendly_name, })
 
-                payload = @version.update(
-                    'POST',
-                    @uri,
-                    data: data,
-                )
+                payload = @version.update('POST', @uri, data: data)
 
                 CredentialListInstance.new(
                     @version,
@@ -226,10 +209,10 @@ module Twilio
               end
 
               ##
-              # Deletes the CredentialListInstance
+              # Delete the CredentialListInstance
               # @return [Boolean] true if delete succeeds, false otherwise
               def delete
-                @version.delete('delete', @uri)
+                 @version.delete('DELETE', @uri)
               end
 
               ##
@@ -352,7 +335,7 @@ module Twilio
               end
 
               ##
-              # Fetch a CredentialListInstance
+              # Fetch the CredentialListInstance
               # @return [CredentialListInstance] Fetched CredentialListInstance
               def fetch
                 context.fetch
@@ -368,7 +351,7 @@ module Twilio
               end
 
               ##
-              # Deletes the CredentialListInstance
+              # Delete the CredentialListInstance
               # @return [Boolean] true if delete succeeds, false otherwise
               def delete
                 context.delete

data/lib/twilio-ruby/rest/api/v2010/account/sip/credential_list/credential.rb

@@ -91,11 +91,9 @@ module Twilio
                       'Page' => page_number,
                       'PageSize' => page_size,
                   })
-                  response = @version.page(
-                      'GET',
-                      @uri,
-                      params
-                  )
+
+                  response = @version.page('GET', @uri, params: params)
+
                   CredentialPage.new(@version, response, @solution)
                 end
 
@@ -113,23 +111,18 @@ module Twilio
                 end
 
                 ##
-                # Retrieve a single page of CredentialInstance records from the API.
-                # Request is executed immediately.
+                # Create the CredentialInstance
                 # @param [String] username The username that will be passed when authenticating
                 #   SIP requests. The username should be sent in response to Twilio's challenge of
                 #   the initial INVITE. It can be up to 32 characters long.
                 # @param [String] password The password that the username will use when
                 #   authenticating SIP requests. The password must be a minimum of 12 characters,
                 #   contain at least 1 digit, and have mixed case. (eg `IWasAtSignal2018`)
-                # @return [CredentialInstance] Newly created CredentialInstance
+                # @return [CredentialInstance] Created CredentialInstance
                 def create(username: nil, password: nil)
                   data = Twilio::Values.of({'Username' => username, 'Password' => password, })
 
-                  payload = @version.create(
-                      'POST',
-                      @uri,
-                      data: data
-                  )
+                  payload = @version.create('POST', @uri, data: data)
 
                   CredentialInstance.new(
                       @version,
@@ -199,16 +192,10 @@ module Twilio
                 end
 
                 ##
-                # Fetch a CredentialInstance
+                # Fetch the CredentialInstance
                 # @return [CredentialInstance] Fetched CredentialInstance
                 def fetch
-                  params = Twilio::Values.of({})
-
-                  payload = @version.fetch(
-                      'GET',
-                      @uri,
-                      params,
-                  )
+                  payload = @version.fetch('GET', @uri)
 
                   CredentialInstance.new(
                       @version,
@@ -228,11 +215,7 @@ module Twilio
                 def update(password: :unset)
                   data = Twilio::Values.of({'Password' => password, })
 
-                  payload = @version.update(
-                      'POST',
-                      @uri,
-                      data: data,
-                  )
+                  payload = @version.update('POST', @uri, data: data)
 
                   CredentialInstance.new(
                       @version,
@@ -244,10 +227,10 @@ module Twilio
                 end
 
                 ##
-                # Deletes the CredentialInstance
+                # Delete the CredentialInstance
                 # @return [Boolean] true if delete succeeds, false otherwise
                 def delete
-                  @version.delete('delete', @uri)
+                   @version.delete('DELETE', @uri)
                 end
 
                 ##
@@ -358,7 +341,7 @@ module Twilio
                 end
 
                 ##
-                # Fetch a CredentialInstance
+                # Fetch the CredentialInstance
                 # @return [CredentialInstance] Fetched CredentialInstance
                 def fetch
                   context.fetch
@@ -375,7 +358,7 @@ module Twilio
                 end
 
                 ##
-                # Deletes the CredentialInstance
+                # Delete the CredentialInstance
                 # @return [Boolean] true if delete succeeds, false otherwise
                 def delete
                   context.delete

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

@@ -88,11 +88,9 @@ module Twilio
                     'Page' => page_number,
                     'PageSize' => page_size,
                 })
-                response = @version.page(
-                    'GET',
-                    @uri,
-                    params
-                )
+
+                response = @version.page('GET', @uri, params: params)
+
                 DomainPage.new(@version, response, @solution)
               end
 
@@ -110,10 +108,10 @@ module Twilio
               end
 
               ##
-              # Retrieve a single page of DomainInstance records from the API.
-              # Request is executed immediately.
+              # Create the DomainInstance
               # @param [String] domain_name The unique address you reserve on Twilio to which
-              #   you route your SIP traffic. Domain names can contain letters, digits, and "-".
+              #   you route your SIP traffic. Domain names can contain letters, digits, and "-"
+              #   and must end with `sip.twilio.com`.
               # @param [String] friendly_name A descriptive string that you created to describe
               #   the resource. It can be up to 64 characters long.
               # @param [String] voice_url The URL we should when the domain receives a call.
@@ -130,8 +128,19 @@ module Twilio
               # @param [Boolean] sip_registration Whether to allow SIP Endpoints to register
               #   with the domain to receive calls. Can be `true` or `false`. `true` allows SIP
               #   Endpoints to register with the domain to receive calls, `false` does not.
-              # @return [DomainInstance] Newly created DomainInstance
-              def create(domain_name: nil, friendly_name: :unset, voice_url: :unset, voice_method: :unset, voice_fallback_url: :unset, voice_fallback_method: :unset, voice_status_callback_url: :unset, voice_status_callback_method: :unset, sip_registration: :unset)
+              # @param [Boolean] emergency_calling_enabled Whether emergency calling is enabled
+              #   for the domain. If enabled, allows emergency calls on the domain from phone
+              #   numbers with validated addresses.
+              # @param [Boolean] secure Whether secure SIP is enabled for the domain. If
+              #   enabled, TLS will be enforced and SRTP will be negotiated on all incoming calls
+              #   to this sip domain.
+              # @param [String] byoc_trunk_sid The SID of the BYOC Trunk(Bring Your Own Carrier)
+              #   resource that the Sip Domain will be associated with.
+              # @param [String] emergency_caller_sid Whether an emergency caller sid is
+              #   configured for the domain. If present, this phone number will be used as the
+              #   callback for the emergency call.
+              # @return [DomainInstance] Created DomainInstance
+              def create(domain_name: nil, friendly_name: :unset, voice_url: :unset, voice_method: :unset, voice_fallback_url: :unset, voice_fallback_method: :unset, voice_status_callback_url: :unset, voice_status_callback_method: :unset, sip_registration: :unset, emergency_calling_enabled: :unset, secure: :unset, byoc_trunk_sid: :unset, emergency_caller_sid: :unset)
                 data = Twilio::Values.of({
                     'DomainName' => domain_name,
                     'FriendlyName' => friendly_name,
@@ -142,13 +151,13 @@ module Twilio
                     'VoiceStatusCallbackUrl' => voice_status_callback_url,
                     'VoiceStatusCallbackMethod' => voice_status_callback_method,
                     'SipRegistration' => sip_registration,
+                    'EmergencyCallingEnabled' => emergency_calling_enabled,
+                    'Secure' => secure,
+                    'ByocTrunkSid' => byoc_trunk_sid,
+                    'EmergencyCallerSid' => emergency_caller_sid,
                 })
 
-                payload = @version.create(
-                    'POST',
-                    @uri,
-                    data: data
-                )
+                payload = @version.create('POST', @uri, data: data)
 
                 DomainInstance.new(@version, payload, account_sid: @solution[:account_sid], )
               end
@@ -194,7 +203,7 @@ module Twilio
               # Initialize the DomainContext
               # @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
               #   SipDomain resource to fetch.
               # @param [String] sid The Twilio-provided string that uniquely identifies the
               #   SipDomain resource to fetch.
@@ -213,16 +222,10 @@ module Twilio
               end
 
               ##
-              # Fetch a DomainInstance
+              # Fetch the DomainInstance
               # @return [DomainInstance] Fetched DomainInstance
               def fetch
-                params = Twilio::Values.of({})
-
-                payload = @version.fetch(
-                    'GET',
-                    @uri,
-                    params,
-                )
+                payload = @version.fetch('GET', @uri)
 
                 DomainInstance.new(@version, payload, account_sid: @solution[:account_sid], sid: @solution[:sid], )
               end
@@ -246,9 +249,21 @@ module Twilio
               #   with the domain to receive calls. Can be `true` or `false`. `true` allows SIP
               #   Endpoints to register with the domain to receive calls, `false` does not.
               # @param [String] domain_name The unique address you reserve on Twilio to which
-              #   you route your SIP traffic. Domain names can contain letters, digits, and "-".
+              #   you route your SIP traffic. Domain names can contain letters, digits, and "-"
+              #   and must end with `sip.twilio.com`.
+              # @param [Boolean] emergency_calling_enabled Whether emergency calling is enabled
+              #   for the domain. If enabled, allows emergency calls on the domain from phone
+              #   numbers with validated addresses.
+              # @param [Boolean] secure Whether secure SIP is enabled for the domain. If
+              #   enabled, TLS will be enforced and SRTP will be negotiated on all incoming calls
+              #   to this sip domain.
+              # @param [String] byoc_trunk_sid The SID of the BYOC Trunk(Bring Your Own Carrier)
+              #   resource that the Sip Domain will be associated with.
+              # @param [String] emergency_caller_sid Whether an emergency caller sid is
+              #   configured for the domain. If present, this phone number will be used as the
+              #   callback for the emergency call.
               # @return [DomainInstance] Updated DomainInstance
-              def update(friendly_name: :unset, voice_fallback_method: :unset, voice_fallback_url: :unset, voice_method: :unset, voice_status_callback_method: :unset, voice_status_callback_url: :unset, voice_url: :unset, sip_registration: :unset, domain_name: :unset)
+              def update(friendly_name: :unset, voice_fallback_method: :unset, voice_fallback_url: :unset, voice_method: :unset, voice_status_callback_method: :unset, voice_status_callback_url: :unset, voice_url: :unset, sip_registration: :unset, domain_name: :unset, emergency_calling_enabled: :unset, secure: :unset, byoc_trunk_sid: :unset, emergency_caller_sid: :unset)
                 data = Twilio::Values.of({
                     'FriendlyName' => friendly_name,
                     'VoiceFallbackMethod' => voice_fallback_method,
@@ -259,22 +274,22 @@ module Twilio
                     'VoiceUrl' => voice_url,
                     'SipRegistration' => sip_registration,
                     'DomainName' => domain_name,
+                    'EmergencyCallingEnabled' => emergency_calling_enabled,
+                    'Secure' => secure,
+                    'ByocTrunkSid' => byoc_trunk_sid,
+                    'EmergencyCallerSid' => emergency_caller_sid,
                 })
 
-                payload = @version.update(
-                    'POST',
-                    @uri,
-                    data: data,
-                )
+                payload = @version.update('POST', @uri, data: data)
 
                 DomainInstance.new(@version, payload, account_sid: @solution[:account_sid], sid: @solution[:sid], )
               end
 
               ##
-              # Deletes the DomainInstance
+              # Delete the DomainInstance
               # @return [Boolean] true if delete succeeds, false otherwise
               def delete
-                @version.delete('delete', @uri)
+                 @version.delete('DELETE', @uri)
               end
 
               ##
@@ -389,6 +404,10 @@ module Twilio
                     'voice_url' => payload['voice_url'],
                     'subresource_uris' => payload['subresource_uris'],
                     'sip_registration' => payload['sip_registration'],
+                    'emergency_calling_enabled' => payload['emergency_calling_enabled'],
+                    'secure' => payload['secure'],
+                    'byoc_trunk_sid' => payload['byoc_trunk_sid'],
+                    'emergency_caller_sid' => payload['emergency_caller_sid'],
                 }
 
                 # Context
@@ -510,7 +529,31 @@ module Twilio
               end
 
               ##
-              # Fetch a DomainInstance
+              # @return [Boolean] Whether emergency calling is enabled for the domain.
+              def emergency_calling_enabled
+                @properties['emergency_calling_enabled']
+              end
+
+              ##
+              # @return [Boolean] Whether secure SIP is enabled for the domain
+              def secure
+                @properties['secure']
+              end
+
+              ##
+              # @return [String] The SID of the BYOC Trunk resource.
+              def byoc_trunk_sid
+                @properties['byoc_trunk_sid']
+              end
+
+              ##
+              # @return [String] Whether an emergency caller sid is configured for the domain.
+              def emergency_caller_sid
+                @properties['emergency_caller_sid']
+              end
+
+              ##
+              # Fetch the DomainInstance
               # @return [DomainInstance] Fetched DomainInstance
               def fetch
                 context.fetch
@@ -535,9 +578,21 @@ module Twilio
               #   with the domain to receive calls. Can be `true` or `false`. `true` allows SIP
               #   Endpoints to register with the domain to receive calls, `false` does not.
               # @param [String] domain_name The unique address you reserve on Twilio to which
-              #   you route your SIP traffic. Domain names can contain letters, digits, and "-".
+              #   you route your SIP traffic. Domain names can contain letters, digits, and "-"
+              #   and must end with `sip.twilio.com`.
+              # @param [Boolean] emergency_calling_enabled Whether emergency calling is enabled
+              #   for the domain. If enabled, allows emergency calls on the domain from phone
+              #   numbers with validated addresses.
+              # @param [Boolean] secure Whether secure SIP is enabled for the domain. If
+              #   enabled, TLS will be enforced and SRTP will be negotiated on all incoming calls
+              #   to this sip domain.
+              # @param [String] byoc_trunk_sid The SID of the BYOC Trunk(Bring Your Own Carrier)
+              #   resource that the Sip Domain will be associated with.
+              # @param [String] emergency_caller_sid Whether an emergency caller sid is
+              #   configured for the domain. If present, this phone number will be used as the
+              #   callback for the emergency call.
               # @return [DomainInstance] Updated DomainInstance
-              def update(friendly_name: :unset, voice_fallback_method: :unset, voice_fallback_url: :unset, voice_method: :unset, voice_status_callback_method: :unset, voice_status_callback_url: :unset, voice_url: :unset, sip_registration: :unset, domain_name: :unset)
+              def update(friendly_name: :unset, voice_fallback_method: :unset, voice_fallback_url: :unset, voice_method: :unset, voice_status_callback_method: :unset, voice_status_callback_url: :unset, voice_url: :unset, sip_registration: :unset, domain_name: :unset, emergency_calling_enabled: :unset, secure: :unset, byoc_trunk_sid: :unset, emergency_caller_sid: :unset)
                 context.update(
                     friendly_name: friendly_name,
                     voice_fallback_method: voice_fallback_method,
@@ -548,11 +603,15 @@ module Twilio
                     voice_url: voice_url,
                     sip_registration: sip_registration,
                     domain_name: domain_name,
+                    emergency_calling_enabled: emergency_calling_enabled,
+                    secure: secure,
+                    byoc_trunk_sid: byoc_trunk_sid,
+                    emergency_caller_sid: emergency_caller_sid,
                 )
               end
 
               ##
-              # Deletes the DomainInstance
+              # Delete the DomainInstance
               # @return [Boolean] true if delete succeeds, false otherwise
               def delete
                 context.delete