bandwidth-sdk 3.3.0 → 3.8.0

data/lib/bandwidth/two_factor_auth_lib/two_factor_auth/exceptions/invalid_request_exception.rb

@@ -0,0 +1,29 @@
+# bandwidth
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module Bandwidth
+  # InvalidRequest class.
+  class InvalidRequestException < APIException
+    # An error message pertaining to what the issue could be
+    # @return [String]
+    attr_accessor :result
+
+    # The constructor.
+    # @param [String] The reason for raising an exception.
+    # @param [HttpResponse] The HttpReponse of the API call.
+    def initialize(reason, response)
+      super(reason, response)
+      hash = APIHelper.json_deserialize(@response.raw_body)
+      unbox(hash)
+    end
+
+    # Populates this object by extracting properties from a hash.
+    # @param [Hash] The deserialized response sent by the server in the
+    # response body.
+    def unbox(hash)
+      @result = hash['result']
+    end
+  end
+end

data/lib/bandwidth/two_factor_auth_lib/two_factor_auth/models/two_factor_code_request_schema.rb

@@ -6,22 +6,38 @@
 module Bandwidth
   # TwoFactorCodeRequestSchema Model.
   class TwoFactorCodeRequestSchema < BaseModel
-    # TODO: Write general description for this method
+    # The phone number to send the 2fa code to.
     # @return [String]
     attr_accessor :to
 
-    # TODO: Write general description for this method
+    # The application phone number, the sender of the 2fa code.
     # @return [String]
     attr_accessor :from
 
-    # TODO: Write general description for this method
+    # The application unique ID, obtained from Bandwidth.
     # @return [String]
     attr_accessor :application_id
 
-    # TODO: Write general description for this method
+    # An optional field to denote what scope or action the 2fa code is
+    # addressing.  If not supplied, defaults to "2FA".
     # @return [String]
     attr_accessor :scope
 
+    # The message format of the 2fa code.  There are three values that the
+    # system will replace "{CODE}", "{NAME}", "{SCOPE}".  The "{SCOPE}" and
+    # "{NAME} value template are optional, while "{CODE}" must be supplied.  As
+    # the name would suggest, code will be replace with the actual 2fa code. 
+    # Name is replaced with the application name, configured during provisioning
+    # of 2fa.  The scope value is the same value sent during the call and
+    # partitioned by the server.
+    # @return [String]
+    attr_accessor :message
+
+    # The number of digits for your 2fa code.  The valid number ranges from 2 to
+    # 8, inclusively.
+    # @return [Float]
+    attr_accessor :digits
+
     # A mapping from model property names to API property names.
     def self.names
       @_hash = {} if @_hash.nil?
@@ -29,17 +45,23 @@ module Bandwidth
       @_hash['from'] = 'from'
       @_hash['application_id'] = 'applicationId'
       @_hash['scope'] = 'scope'
+      @_hash['message'] = 'message'
+      @_hash['digits'] = 'digits'
       @_hash
     end
 
     def initialize(to = nil,
                    from = nil,
                    application_id = nil,
+                   message = nil,
+                   digits = nil,
                    scope = nil)
       @to = to
       @from = from
       @application_id = application_id
       @scope = scope
+      @message = message
+      @digits = digits
     end
 
     # Creates an instance of the object from a hash.
@@ -50,12 +72,16 @@ module Bandwidth
       to = hash['to']
       from = hash['from']
       application_id = hash['applicationId']
+      message = hash['message']
+      digits = hash['digits']
       scope = hash['scope']
 
       # Create object from extracted values.
       TwoFactorCodeRequestSchema.new(to,
                                      from,
                                      application_id,
+                                     message,
+                                     digits,
                                      scope)
     end
   end

data/lib/bandwidth/two_factor_auth_lib/two_factor_auth/models/two_factor_verify_request_schema.rb

@@ -6,23 +6,36 @@
 module Bandwidth
   # TwoFactorVerifyRequestSchema Model.
   class TwoFactorVerifyRequestSchema < BaseModel
-    # TODO: Write general description for this method
+    # The phone number to send the 2fa code to.
     # @return [String]
     attr_accessor :to
 
-    # TODO: Write general description for this method
+    # The application phone number, the sender of the 2fa code.
     # @return [String]
     attr_accessor :from
 
-    # TODO: Write general description for this method
+    # The application unique ID, obtained from Bandwidth.
     # @return [String]
     attr_accessor :application_id
 
-    # TODO: Write general description for this method
+    # An optional field to denote what scope or action the 2fa code is
+    # addressing.  If not supplied, defaults to "2FA".
     # @return [String]
     attr_accessor :scope
 
-    # TODO: Write general description for this method
+    # The number of digits for your 2fa code.  The valid number ranges from 2 to
+    # 8, inclusively.
+    # @return [Float]
+    attr_accessor :digits
+
+    # The time period, in minutes, to validate the 2fa code.  By setting this to
+    # 3 minutes, it will mean any code generated within the last 3 minutes are
+    # still valid.  The valid range for expiration time is between 0 and 15
+    # minutes, exclusively and inclusively, respectively.
+    # @return [Float]
+    attr_accessor :expiration_time_in_minutes
+
+    # The generated 2fa code to check if valid
     # @return [String]
     attr_accessor :code
 
@@ -33,6 +46,8 @@ module Bandwidth
       @_hash['from'] = 'from'
       @_hash['application_id'] = 'applicationId'
       @_hash['scope'] = 'scope'
+      @_hash['digits'] = 'digits'
+      @_hash['expiration_time_in_minutes'] = 'expirationTimeInMinutes'
       @_hash['code'] = 'code'
       @_hash
     end
@@ -40,12 +55,16 @@ module Bandwidth
     def initialize(to = nil,
                    from = nil,
                    application_id = nil,
-                   scope = nil,
-                   code = nil)
+                   digits = nil,
+                   expiration_time_in_minutes = nil,
+                   code = nil,
+                   scope = nil)
       @to = to
       @from = from
       @application_id = application_id
       @scope = scope
+      @digits = digits
+      @expiration_time_in_minutes = expiration_time_in_minutes
       @code = code
     end
 
@@ -57,15 +76,19 @@ module Bandwidth
       to = hash['to']
       from = hash['from']
       application_id = hash['applicationId']
-      scope = hash['scope']
+      digits = hash['digits']
+      expiration_time_in_minutes = hash['expirationTimeInMinutes']
       code = hash['code']
+      scope = hash['scope']
 
       # Create object from extracted values.
       TwoFactorVerifyRequestSchema.new(to,
                                        from,
                                        application_id,
-                                       scope,
-                                       code)
+                                       digits,
+                                       expiration_time_in_minutes,
+                                       code,
+                                       scope)
     end
   end
 end

data/lib/bandwidth/voice_lib/bxml/verbs/bridge.rb

@@ -0,0 +1,22 @@
+require_relative 'xml_verb'
+
+module Bandwidth 
+  module Voice 
+    # The Bridge verb allows you to connect 2 calls 
+    class Bridge
+      include XmlVerb
+
+      def to_bxml(xml)
+        xml.Bridge(call_id, compact_hash({
+         'bridgeCompleteUrl' => bridge_complete_url,
+         'bridgeCompleteMethod' => bridge_complete_method,
+         'bridgeTargetCompleteUrl' => bridge_target_complete_url,
+         'bridgeTargetCompleteMethod' => bridge_target_complete_method,
+         'username' => username,
+         'password' => password,
+         'tag' => tag
+        }))
+      end
+    end
+  end
+end

data/lib/bandwidth/voice_lib/bxml/verbs/conference.rb

@@ -0,0 +1,28 @@
+require_relative 'xml_verb'
+
+module Bandwidth 
+  module Voice 
+    # The Conference verb is used to add callees to conferences 
+    class Conference
+      include XmlVerb
+
+      def to_bxml(xml)
+        if not call_ids_to_coach.nil?
+          coach_ids = call_ids_to_coach.instance_of?(String) ? call_ids_to_coach : call_ids_to_coach.join(",")
+        else
+          coach_ids = nil
+        end
+        xml.Conference(conference_name, compact_hash({
+         'mute' => mute,
+         'hold' => hold,
+         'callIdsToCoach' => coach_ids,
+         'conferenceEventUrl' => conference_event_url,
+         'conferenceEventMethod' => conference_event_method,
+         'username' => username,
+         'password' => password,
+         'tag' => tag
+        }))
+      end
+    end
+  end
+end

data/lib/bandwidth/voice_lib/voice.rb

@@ -12,6 +12,9 @@ require_relative 'voice/models/api_call_state_response.rb'
 require_relative 'voice/models/api_create_call_request.rb'
 require_relative 'voice/models/api_modify_call_request.rb'
 require_relative 'voice/models/api_transcribe_recording_request.rb'
+require_relative 'voice/models/call_engine_modify_conference_request.rb'
+require_relative 'voice/models/conference_detail.rb'
+require_relative 'voice/models/conference_member_detail.rb'
 require_relative 'voice/models/modify_call_recording_state.rb'
 require_relative 'voice/models/recording_metadata_response.rb'
 require_relative 'voice/models/transcript.rb'
@@ -19,6 +22,7 @@ require_relative 'voice/models/transcription.rb'
 require_relative 'voice/models/transcription_response.rb'
 require_relative 'voice/models/answer_method_enum.rb'
 require_relative 'voice/models/callback_method_enum.rb'
+require_relative 'voice/models/conference_event_method_enum.rb'
 require_relative 'voice/models/direction_enum.rb'
 require_relative 'voice/models/disconnect_cause_enum.rb'
 require_relative 'voice/models/disconnect_method_enum.rb'
@@ -29,6 +33,7 @@ require_relative 'voice/models/state1_enum.rb'
 require_relative 'voice/models/state2_enum.rb'
 require_relative 'voice/models/status_enum.rb'
 require_relative 'voice/models/status1_enum.rb'
+require_relative 'voice/models/status2_enum.rb'
 
 # Exceptions
 require_relative 'voice/exceptions/api_error_response_exception.rb'

data/lib/bandwidth/voice_lib/voice/client.rb

@@ -22,7 +22,10 @@ module Bandwidth
                        two_factor_auth_basic_auth_user_name: 'TODO: Replace',
                        two_factor_auth_basic_auth_password: 'TODO: Replace',
                        voice_basic_auth_user_name: 'TODO: Replace',
-                       voice_basic_auth_password: 'TODO: Replace', config: nil)
+                       voice_basic_auth_password: 'TODO: Replace',
+                       web_rtc_basic_auth_user_name: 'TODO: Replace',
+                       web_rtc_basic_auth_password: 'TODO: Replace',
+                       config: nil)
           @config = if config.nil?
                       Configuration.new(timeout: timeout,
                                         max_retries: max_retries,
@@ -34,7 +37,9 @@ module Bandwidth
                                         two_factor_auth_basic_auth_user_name: two_factor_auth_basic_auth_user_name,
                                         two_factor_auth_basic_auth_password: two_factor_auth_basic_auth_password,
                                         voice_basic_auth_user_name: voice_basic_auth_user_name,
-                                        voice_basic_auth_password: voice_basic_auth_password)
+                                        voice_basic_auth_password: voice_basic_auth_password,
+                                        web_rtc_basic_auth_user_name: web_rtc_basic_auth_user_name,
+                                        web_rtc_basic_auth_password: web_rtc_basic_auth_password)
                     else
                       config
                     end

data/lib/bandwidth/voice_lib/voice/controllers/api_controller.rb

@@ -22,7 +22,7 @@ module Voice
       _query_builder << '/api/v2/accounts/{accountId}/calls'
       _query_builder = APIHelper.append_url_with_template_parameters(
         _query_builder,
-        'accountId' => account_id
+        'accountId' => { 'value' => account_id, 'encode' => true }
       )
       _query_url = APIHelper.clean_url _query_builder
 
@@ -44,20 +44,19 @@ module Voice
       # Validate response against endpoint and global error codes.
       if _response.status_code == 400
         raise ApiErrorResponseException.new(
-          'Something\'s not quite right... Either your request is invalid or' \
-          ' you\'re requesting it at a bad time. Please fix it' \
-          ' before trying again.',
+          'Something\'s not quite right... Your request is invalid. Please' \
+          ' fix it before trying again.',
           _response
         )
       elsif _response.status_code == 401
         raise APIException.new(
-          'Please authenticate yourself.',
+          'Your credentials are invalid. Please use your Bandwidth dashboard' \
+          ' credentials to authenticate to the API.',
           _response
         )
       elsif _response.status_code == 403
         raise ApiErrorResponseException.new(
-          'Your credentials are invalid. Please use your API credentials for' \
-          ' the Bandwidth Dashboard.',
+          'User unauthorized to perform this action.',
           _response
         )
       elsif _response.status_code == 404
@@ -87,7 +86,9 @@ module Voice
 
       # Return appropriate response type.
       decoded = APIHelper.json_deserialize(_response.raw_body)
-      ApiResponse.new(_response, data: ApiCallResponse.from_hash(decoded))
+      ApiResponse.new(
+        _response, data: ApiCallResponse.from_hash(decoded)
+      )
     end
 
     # Returns near-realtime metadata about the specified call
@@ -101,8 +102,8 @@ module Voice
       _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}'
       _query_builder = APIHelper.append_url_with_template_parameters(
         _query_builder,
-        'accountId' => account_id,
-        'callId' => call_id
+        'accountId' => { 'value' => account_id, 'encode' => true },
+        'callId' => { 'value' => call_id, 'encode' => true }
       )
       _query_url = APIHelper.clean_url _query_builder
 
@@ -122,20 +123,19 @@ module Voice
       # Validate response against endpoint and global error codes.
       if _response.status_code == 400
         raise ApiErrorResponseException.new(
-          'Something\'s not quite right... Either your request is invalid or' \
-          ' you\'re requesting it at a bad time. Please fix it' \
-          ' before trying again.',
+          'Something\'s not quite right... Your request is invalid. Please' \
+          ' fix it before trying again.',
           _response
         )
       elsif _response.status_code == 401
         raise APIException.new(
-          'Please authenticate yourself.',
+          'Your credentials are invalid. Please use your Bandwidth dashboard' \
+          ' credentials to authenticate to the API.',
           _response
         )
       elsif _response.status_code == 403
         raise ApiErrorResponseException.new(
-          'Your credentials are invalid. Please use your API credentials for' \
-          ' the Bandwidth Dashboard.',
+          'User unauthorized to perform this action.',
           _response
         )
       elsif _response.status_code == 404
@@ -165,7 +165,9 @@ module Voice
 
       # Return appropriate response type.
       decoded = APIHelper.json_deserialize(_response.raw_body)
-      ApiResponse.new(_response, data: ApiCallStateResponse.from_hash(decoded))
+      ApiResponse.new(
+        _response, data: ApiCallStateResponse.from_hash(decoded)
+      )
     end
 
     # Interrupts and replaces an active call's BXML document
@@ -181,8 +183,8 @@ module Voice
       _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}'
       _query_builder = APIHelper.append_url_with_template_parameters(
         _query_builder,
-        'accountId' => account_id,
-        'callId' => call_id
+        'accountId' => { 'value' => account_id, 'encode' => true },
+        'callId' => { 'value' => call_id, 'encode' => true }
       )
       _query_url = APIHelper.clean_url _query_builder
 
@@ -203,20 +205,19 @@ module Voice
       # Validate response against endpoint and global error codes.
       if _response.status_code == 400
         raise ApiErrorResponseException.new(
-          'Something\'s not quite right... Either your request is invalid or' \
-          ' you\'re requesting it at a bad time. Please fix it' \
-          ' before trying again.',
+          'Something\'s not quite right... Your request is invalid. Please' \
+          ' fix it before trying again.',
           _response
         )
       elsif _response.status_code == 401
         raise APIException.new(
-          'Please authenticate yourself.',
+          'Your credentials are invalid. Please use your Bandwidth dashboard' \
+          ' credentials to authenticate to the API.',
           _response
         )
       elsif _response.status_code == 403
         raise ApiErrorResponseException.new(
-          'Your credentials are invalid. Please use your API credentials for' \
-          ' the Bandwidth Dashboard.',
+          'User unauthorized to perform this action.',
           _response
         )
       elsif _response.status_code == 404
@@ -261,8 +262,8 @@ module Voice
       _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}/recording'
       _query_builder = APIHelper.append_url_with_template_parameters(
         _query_builder,
-        'accountId' => account_id,
-        'callId' => call_id
+        'accountId' => { 'value' => account_id, 'encode' => true },
+        'callId' => { 'value' => call_id, 'encode' => true }
       )
       _query_url = APIHelper.clean_url _query_builder
 
@@ -283,20 +284,19 @@ module Voice
       # Validate response against endpoint and global error codes.
       if _response.status_code == 400
         raise ApiErrorResponseException.new(
-          'Something\'s not quite right... Either your request is invalid or' \
-          ' you\'re requesting it at a bad time. Please fix it' \
-          ' before trying again.',
+          'Something\'s not quite right... Your request is invalid. Please' \
+          ' fix it before trying again.',
           _response
         )
       elsif _response.status_code == 401
         raise APIException.new(
-          'Please authenticate yourself.',
+          'Your credentials are invalid. Please use your Bandwidth dashboard' \
+          ' credentials to authenticate to the API.',
           _response
         )
       elsif _response.status_code == 403
         raise ApiErrorResponseException.new(
-          'Your credentials are invalid. Please use your API credentials for' \
-          ' the Bandwidth Dashboard.',
+          'User unauthorized to perform this action.',
           _response
         )
       elsif _response.status_code == 404
@@ -348,8 +348,8 @@ module Voice
       _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}/recordings'
       _query_builder = APIHelper.append_url_with_template_parameters(
         _query_builder,
-        'accountId' => account_id,
-        'callId' => call_id
+        'accountId' => { 'value' => account_id, 'encode' => true },
+        'callId' => { 'value' => call_id, 'encode' => true }
       )
       _query_builder = APIHelper.append_url_with_query_parameters(
         _query_builder,
@@ -376,20 +376,19 @@ module Voice
       # Validate response against endpoint and global error codes.
       if _response.status_code == 400
         raise ApiErrorResponseException.new(
-          'Something\'s not quite right... Either your request is invalid or' \
-          ' you\'re requesting it at a bad time. Please fix it' \
-          ' before trying again.',
+          'Something\'s not quite right... Your request is invalid. Please' \
+          ' fix it before trying again.',
           _response
         )
       elsif _response.status_code == 401
         raise APIException.new(
-          'Please authenticate yourself.',
+          'Your credentials are invalid. Please use your Bandwidth dashboard' \
+          ' credentials to authenticate to the API.',
           _response
         )
       elsif _response.status_code == 403
         raise ApiErrorResponseException.new(
-          'Your credentials are invalid. Please use your API credentials for' \
-          ' the Bandwidth Dashboard.',
+          'User unauthorized to perform this action.',
           _response
         )
       elsif _response.status_code == 404
@@ -438,9 +437,9 @@ module Voice
       _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}/recordings/{recordingId}'
       _query_builder = APIHelper.append_url_with_template_parameters(
         _query_builder,
-        'accountId' => account_id,
-        'callId' => call_id,
-        'recordingId' => recording_id
+        'accountId' => { 'value' => account_id, 'encode' => true },
+        'callId' => { 'value' => call_id, 'encode' => true },
+        'recordingId' => { 'value' => recording_id, 'encode' => true }
       )
       _query_url = APIHelper.clean_url _query_builder
 
@@ -460,20 +459,19 @@ module Voice
       # Validate response against endpoint and global error codes.
       if _response.status_code == 400
         raise ApiErrorResponseException.new(
-          'Something\'s not quite right... Either your request is invalid or' \
-          ' you\'re requesting it at a bad time. Please fix it' \
-          ' before trying again.',
+          'Something\'s not quite right... Your request is invalid. Please' \
+          ' fix it before trying again.',
           _response
         )
       elsif _response.status_code == 401
         raise APIException.new(
-          'Please authenticate yourself.',
+          'Your credentials are invalid. Please use your Bandwidth dashboard' \
+          ' credentials to authenticate to the API.',
           _response
         )
       elsif _response.status_code == 403
         raise ApiErrorResponseException.new(
-          'Your credentials are invalid. Please use your API credentials for' \
-          ' the Bandwidth Dashboard.',
+          'User unauthorized to perform this action.',
           _response
         )
       elsif _response.status_code == 404
@@ -503,8 +501,9 @@ module Voice
 
       # Return appropriate response type.
       decoded = APIHelper.json_deserialize(_response.raw_body)
-      ApiResponse.new(_response,
-                      data: RecordingMetadataResponse.from_hash(decoded))
+      ApiResponse.new(
+        _response, data: RecordingMetadataResponse.from_hash(decoded)
+      )
     end
 
     # Deletes the specified recording
@@ -520,9 +519,9 @@ module Voice
       _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}/recordings/{recordingId}'
       _query_builder = APIHelper.append_url_with_template_parameters(
         _query_builder,
-        'accountId' => account_id,
-        'callId' => call_id,
-        'recordingId' => recording_id
+        'accountId' => { 'value' => account_id, 'encode' => true },
+        'callId' => { 'value' => call_id, 'encode' => true },
+        'recordingId' => { 'value' => recording_id, 'encode' => true }
       )
       _query_url = APIHelper.clean_url _query_builder
 
@@ -536,20 +535,19 @@ module Voice
       # Validate response against endpoint and global error codes.
       if _response.status_code == 400
         raise ApiErrorResponseException.new(
-          'Something\'s not quite right... Either your request is invalid or' \
-          ' you\'re requesting it at a bad time. Please fix it' \
-          ' before trying again.',
+          'Something\'s not quite right... Your request is invalid. Please' \
+          ' fix it before trying again.',
           _response
         )
       elsif _response.status_code == 401
         raise APIException.new(
-          'Please authenticate yourself.',
+          'Your credentials are invalid. Please use your Bandwidth dashboard' \
+          ' credentials to authenticate to the API.',
           _response
         )
       elsif _response.status_code == 403
         raise ApiErrorResponseException.new(
-          'Your credentials are invalid. Please use your API credentials for' \
-          ' the Bandwidth Dashboard.',
+          'User unauthorized to perform this action.',
           _response
         )
       elsif _response.status_code == 404
@@ -594,9 +592,9 @@ module Voice
       _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}/recordings/{recordingId}/media'
       _query_builder = APIHelper.append_url_with_template_parameters(
         _query_builder,
-        'accountId' => account_id,
-        'callId' => call_id,
-        'recordingId' => recording_id
+        'accountId' => { 'value' => account_id, 'encode' => true },
+        'callId' => { 'value' => call_id, 'encode' => true },
+        'recordingId' => { 'value' => recording_id, 'encode' => true }
       )
       _query_url = APIHelper.clean_url _query_builder
 
@@ -610,20 +608,19 @@ module Voice
       # Validate response against endpoint and global error codes.
       if _response.status_code == 400
         raise ApiErrorResponseException.new(
-          'Something\'s not quite right... Either your request is invalid or' \
-          ' you\'re requesting it at a bad time. Please fix it' \
-          ' before trying again.',
+          'Something\'s not quite right... Your request is invalid. Please' \
+          ' fix it before trying again.',
           _response
         )
       elsif _response.status_code == 401
         raise APIException.new(
-          'Please authenticate yourself.',
+          'Your credentials are invalid. Please use your Bandwidth dashboard' \
+          ' credentials to authenticate to the API.',
           _response
         )
       elsif _response.status_code == 403
         raise ApiErrorResponseException.new(
-          'Your credentials are invalid. Please use your API credentials for' \
-          ' the Bandwidth Dashboard.',
+          'User unauthorized to perform this action.',
           _response
         )
       elsif _response.status_code == 404
@@ -652,7 +649,9 @@ module Voice
       validate_response(_response)
 
       # Return appropriate response type.
-      ApiResponse.new(_response, data: _response.raw_body)
+      ApiResponse.new(
+        _response, data: _response.raw_body
+      )
     end
 
     # Deletes the specified recording's media
@@ -668,9 +667,9 @@ module Voice
       _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}/recordings/{recordingId}/media'
       _query_builder = APIHelper.append_url_with_template_parameters(
         _query_builder,
-        'accountId' => account_id,
-        'callId' => call_id,
-        'recordingId' => recording_id
+        'accountId' => { 'value' => account_id, 'encode' => true },
+        'callId' => { 'value' => call_id, 'encode' => true },
+        'recordingId' => { 'value' => recording_id, 'encode' => true }
       )
       _query_url = APIHelper.clean_url _query_builder
 
@@ -684,20 +683,19 @@ module Voice
       # Validate response against endpoint and global error codes.
       if _response.status_code == 400
         raise ApiErrorResponseException.new(
-          'Something\'s not quite right... Either your request is invalid or' \
-          ' you\'re requesting it at a bad time. Please fix it' \
-          ' before trying again.',
+          'Something\'s not quite right... Your request is invalid. Please' \
+          ' fix it before trying again.',
           _response
         )
       elsif _response.status_code == 401
         raise APIException.new(
-          'Please authenticate yourself.',
+          'Your credentials are invalid. Please use your Bandwidth dashboard' \
+          ' credentials to authenticate to the API.',
           _response
         )
       elsif _response.status_code == 403
         raise ApiErrorResponseException.new(
-          'Your credentials are invalid. Please use your API credentials for' \
-          ' the Bandwidth Dashboard.',
+          'User unauthorized to perform this action.',
           _response
         )
       elsif _response.status_code == 404
@@ -742,9 +740,9 @@ module Voice
       _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}/recordings/{recordingId}/transcription'
       _query_builder = APIHelper.append_url_with_template_parameters(
         _query_builder,
-        'accountId' => account_id,
-        'callId' => call_id,
-        'recordingId' => recording_id
+        'accountId' => { 'value' => account_id, 'encode' => true },
+        'callId' => { 'value' => call_id, 'encode' => true },
+        'recordingId' => { 'value' => recording_id, 'encode' => true }
       )
       _query_url = APIHelper.clean_url _query_builder
 
@@ -764,20 +762,19 @@ module Voice
       # Validate response against endpoint and global error codes.
       if _response.status_code == 400
         raise ApiErrorResponseException.new(
-          'Something\'s not quite right... Either your request is invalid or' \
-          ' you\'re requesting it at a bad time. Please fix it' \
-          ' before trying again.',
+          'Something\'s not quite right... Your request is invalid. Please' \
+          ' fix it before trying again.',
           _response
         )
       elsif _response.status_code == 401
         raise APIException.new(
-          'Please authenticate yourself.',
+          'Your credentials are invalid. Please use your Bandwidth dashboard' \
+          ' credentials to authenticate to the API.',
           _response
         )
       elsif _response.status_code == 403
         raise ApiErrorResponseException.new(
-          'Your credentials are invalid. Please use your API credentials for' \
-          ' the Bandwidth Dashboard.',
+          'User unauthorized to perform this action.',
           _response
         )
       elsif _response.status_code == 404
@@ -807,7 +804,9 @@ module Voice
 
       # Return appropriate response type.
       decoded = APIHelper.json_deserialize(_response.raw_body)
-      ApiResponse.new(_response, data: TranscriptionResponse.from_hash(decoded))
+      ApiResponse.new(
+        _response, data: TranscriptionResponse.from_hash(decoded)
+      )
     end
 
     # Requests that the specified recording be transcribed
@@ -825,9 +824,9 @@ module Voice
       _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}/recordings/{recordingId}/transcription'
       _query_builder = APIHelper.append_url_with_template_parameters(
         _query_builder,
-        'accountId' => account_id,
-        'callId' => call_id,
-        'recordingId' => recording_id
+        'accountId' => { 'value' => account_id, 'encode' => true },
+        'callId' => { 'value' => call_id, 'encode' => true },
+        'recordingId' => { 'value' => recording_id, 'encode' => true }
       )
       _query_url = APIHelper.clean_url _query_builder
 
@@ -848,20 +847,19 @@ module Voice
       # Validate response against endpoint and global error codes.
       if _response.status_code == 400
         raise ApiErrorResponseException.new(
-          'Something\'s not quite right... Either your request is invalid or' \
-          ' you\'re requesting it at a bad time. Please fix it' \
-          ' before trying again.',
+          'Something\'s not quite right... Your request is invalid. Please' \
+          ' fix it before trying again.',
           _response
         )
       elsif _response.status_code == 401
         raise APIException.new(
-          'Please authenticate yourself.',
+          'Your credentials are invalid. Please use your Bandwidth dashboard' \
+          ' credentials to authenticate to the API.',
           _response
         )
       elsif _response.status_code == 403
         raise ApiErrorResponseException.new(
-          'Your credentials are invalid. Please use your API credentials for' \
-          ' the Bandwidth Dashboard.',
+          'User unauthorized to perform this action.',
           _response
         )
       elsif _response.status_code == 404
@@ -912,9 +910,9 @@ module Voice
       _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}/recordings/{recordingId}/transcription'
       _query_builder = APIHelper.append_url_with_template_parameters(
         _query_builder,
-        'accountId' => account_id,
-        'callId' => call_id,
-        'recordingId' => recording_id
+        'accountId' => { 'value' => account_id, 'encode' => true },
+        'callId' => { 'value' => call_id, 'encode' => true },
+        'recordingId' => { 'value' => recording_id, 'encode' => true }
       )
       _query_url = APIHelper.clean_url _query_builder
 
@@ -928,20 +926,19 @@ module Voice
       # Validate response against endpoint and global error codes.
       if _response.status_code == 400
         raise ApiErrorResponseException.new(
-          'Something\'s not quite right... Either your request is invalid or' \
-          ' you\'re requesting it at a bad time. Please fix it' \
-          ' before trying again.',
+          'Something\'s not quite right... Your request is invalid. Please' \
+          ' fix it before trying again.',
           _response
         )
       elsif _response.status_code == 401
         raise APIException.new(
-          'Please authenticate yourself.',
+          'Your credentials are invalid. Please use your Bandwidth dashboard' \
+          ' credentials to authenticate to the API.',
           _response
         )
       elsif _response.status_code == 403
         raise ApiErrorResponseException.new(
-          'Your credentials are invalid. Please use your API credentials for' \
-          ' the Bandwidth Dashboard.',
+          'User unauthorized to perform this action.',
           _response
         )
       elsif _response.status_code == 404
@@ -973,6 +970,247 @@ module Voice
       ApiResponse.new(_response)
     end
 
+    # Returns information about the specified conference
+    # @param [String] account_id Required parameter: Example:
+    # @param [String] conference_id Required parameter: Example:
+    # @return [ConferenceDetail] response from the API call
+    def get_conference_by_id(account_id,
+                             conference_id)
+      # Prepare query url.
+      _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
+      _query_builder << '/api/v2/accounts/{accountId}/conferences/{conferenceId}'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'accountId' => { 'value' => account_id, 'encode' => true },
+        'conferenceId' => { 'value' => conference_id, 'encode' => true }
+      )
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.get(
+        _query_url,
+        headers: _headers
+      )
+      VoiceBasicAuth.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Validate response against endpoint and global error codes.
+      if _response.status_code == 400
+        raise ApiErrorResponseException.new(
+          'Something\'s not quite right... Your request is invalid. Please' \
+          ' fix it before trying again.',
+          _response
+        )
+      elsif _response.status_code == 401
+        raise APIException.new(
+          'Your credentials are invalid. Please use your Bandwidth dashboard' \
+          ' credentials to authenticate to the API.',
+          _response
+        )
+      elsif _response.status_code == 403
+        raise ApiErrorResponseException.new(
+          'User unauthorized to perform this action.',
+          _response
+        )
+      elsif _response.status_code == 404
+        raise ApiErrorResponseException.new(
+          'The resource specified cannot be found or does not belong to you.',
+          _response
+        )
+      elsif _response.status_code == 415
+        raise ApiErrorResponseException.new(
+          'We don\'t support that media type. If a request body is required,' \
+          ' please send it to us as `application/json`.',
+          _response
+        )
+      elsif _response.status_code == 429
+        raise ApiErrorResponseException.new(
+          'You\'re sending requests to this endpoint too frequently. Please' \
+          ' slow your request rate down and try again.',
+          _response
+        )
+      elsif _response.status_code == 500
+        raise ApiErrorResponseException.new(
+          'Something unexpected happened. Please try again.',
+          _response
+        )
+      end
+      validate_response(_response)
+
+      # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body)
+      ApiResponse.new(
+        _response, data: ConferenceDetail.from_hash(decoded)
+      )
+    end
+
+    # Modify the conference state
+    # @param [String] account_id Required parameter: Example:
+    # @param [String] conference_id Required parameter: Example:
+    # @param [CallEngineModifyConferenceRequest] body Optional parameter:
+    # Example:
+    # @return [void] response from the API call
+    def modify_conference(account_id,
+                          conference_id,
+                          body: nil)
+      # Prepare query url.
+      _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
+      _query_builder << '/api/v2/accounts/{accountId}/conferences/{conferenceId}'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'accountId' => { 'value' => account_id, 'encode' => true },
+        'conferenceId' => { 'value' => conference_id, 'encode' => true }
+      )
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'content-type' => 'application/json; charset=utf-8'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.post(
+        _query_url,
+        headers: _headers,
+        parameters: body.to_json
+      )
+      VoiceBasicAuth.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Validate response against endpoint and global error codes.
+      if _response.status_code == 400
+        raise ApiErrorResponseException.new(
+          'Something\'s not quite right... Your request is invalid. Please' \
+          ' fix it before trying again.',
+          _response
+        )
+      elsif _response.status_code == 401
+        raise APIException.new(
+          'Your credentials are invalid. Please use your Bandwidth dashboard' \
+          ' credentials to authenticate to the API.',
+          _response
+        )
+      elsif _response.status_code == 403
+        raise ApiErrorResponseException.new(
+          'User unauthorized to perform this action.',
+          _response
+        )
+      elsif _response.status_code == 404
+        raise ApiErrorResponseException.new(
+          'The resource specified cannot be found or does not belong to you.',
+          _response
+        )
+      elsif _response.status_code == 415
+        raise ApiErrorResponseException.new(
+          'We don\'t support that media type. If a request body is required,' \
+          ' please send it to us as `application/json`.',
+          _response
+        )
+      elsif _response.status_code == 429
+        raise ApiErrorResponseException.new(
+          'You\'re sending requests to this endpoint too frequently. Please' \
+          ' slow your request rate down and try again.',
+          _response
+        )
+      elsif _response.status_code == 500
+        raise ApiErrorResponseException.new(
+          'Something unexpected happened. Please try again.',
+          _response
+        )
+      end
+      validate_response(_response)
+
+      # Return appropriate response type.
+      ApiResponse.new(_response)
+    end
+
+    # Returns information about the specified conference member
+    # @param [String] account_id Required parameter: Example:
+    # @param [String] conference_id Required parameter: Example:
+    # @param [String] member_id Required parameter: Example:
+    # @return [ConferenceMemberDetail] response from the API call
+    def get_conference_member(account_id,
+                              conference_id,
+                              member_id)
+      # Prepare query url.
+      _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
+      _query_builder << '/api/v2/accounts/{accountId}/conferences/{conferenceId}/members/{memberId}'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'accountId' => { 'value' => account_id, 'encode' => true },
+        'conferenceId' => { 'value' => conference_id, 'encode' => true },
+        'memberId' => { 'value' => member_id, 'encode' => true }
+      )
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.get(
+        _query_url,
+        headers: _headers
+      )
+      VoiceBasicAuth.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Validate response against endpoint and global error codes.
+      if _response.status_code == 400
+        raise ApiErrorResponseException.new(
+          'Something\'s not quite right... Your request is invalid. Please' \
+          ' fix it before trying again.',
+          _response
+        )
+      elsif _response.status_code == 401
+        raise APIException.new(
+          'Your credentials are invalid. Please use your Bandwidth dashboard' \
+          ' credentials to authenticate to the API.',
+          _response
+        )
+      elsif _response.status_code == 403
+        raise ApiErrorResponseException.new(
+          'User unauthorized to perform this action.',
+          _response
+        )
+      elsif _response.status_code == 404
+        raise ApiErrorResponseException.new(
+          'The resource specified cannot be found or does not belong to you.',
+          _response
+        )
+      elsif _response.status_code == 415
+        raise ApiErrorResponseException.new(
+          'We don\'t support that media type. If a request body is required,' \
+          ' please send it to us as `application/json`.',
+          _response
+        )
+      elsif _response.status_code == 429
+        raise ApiErrorResponseException.new(
+          'You\'re sending requests to this endpoint too frequently. Please' \
+          ' slow your request rate down and try again.',
+          _response
+        )
+      elsif _response.status_code == 500
+        raise ApiErrorResponseException.new(
+          'Something unexpected happened. Please try again.',
+          _response
+        )
+      end
+      validate_response(_response)
+
+      # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body)
+      ApiResponse.new(
+        _response, data: ConferenceMemberDetail.from_hash(decoded)
+      )
+    end
+
     # Returns a list of metadata for the recordings associated with the
     # specified account. The list can be filtered by the optional from, to,
     # minStartTime, and maxStartTime arguments. The list is capped at 1000
@@ -993,7 +1231,7 @@ module Voice
       _query_builder << '/api/v2/accounts/{accountId}/recordings'
       _query_builder = APIHelper.append_url_with_template_parameters(
         _query_builder,
-        'accountId' => account_id
+        'accountId' => { 'value' => account_id, 'encode' => true }
       )
       _query_builder = APIHelper.append_url_with_query_parameters(
         _query_builder,
@@ -1020,20 +1258,19 @@ module Voice
       # Validate response against endpoint and global error codes.
       if _response.status_code == 400
         raise ApiErrorResponseException.new(
-          'Something\'s not quite right... Either your request is invalid or' \
-          ' you\'re requesting it at a bad time. Please fix it' \
-          ' before trying again.',
+          'Something\'s not quite right... Your request is invalid. Please' \
+          ' fix it before trying again.',
           _response
         )
       elsif _response.status_code == 401
         raise APIException.new(
-          'Please authenticate yourself.',
+          'Your credentials are invalid. Please use your Bandwidth dashboard' \
+          ' credentials to authenticate to the API.',
           _response
         )
       elsif _response.status_code == 403
         raise ApiErrorResponseException.new(
-          'Your credentials are invalid. Please use your API credentials for' \
-          ' the Bandwidth Dashboard.',
+          'User unauthorized to perform this action.',
           _response
         )
       elsif _response.status_code == 404