bandwidth-sdk 2.1.1 → 3.7.0

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

@@ -28,8 +28,16 @@ module Bandwidth
                s.to_bxml(xml)
              end
            end
+           def nest_verbs_list(xml, property)
+             if property
+               property.each do |verb|
+                 verb.to_bxml(xml)
+               end
+             end
+           end
           embedded_xml(xml, speak_sentence, SpeakSentence)
           embedded_xml(xml, play_audio, PlayAudio)
+          nest_verbs_list(xml, nested_verbs)
         end
       end
     end

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

@@ -8,6 +8,8 @@ module Bandwidth
         xml.PhoneNumber(number, compact_hash({
           'transferAnswerUrl' => transfer_answer_url,
           'transferAnswerMethod' => transfer_answer_method,
+          'transferDisconnectUrl' => transfer_disconnect_url,
+          'transferDisconnectMethod' => transfer_disconnect_method,
           'username' => username,
           'password' => password,
           'tag' => tag

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

@@ -17,7 +17,11 @@ module Bandwidth
          'recordingAvailableMethod' => recording_available_method,
          'terminatingDigits' => terminating_digits,
          'maxDuration' => max_duration,
-         'fileFormat' => file_format
+         'fileFormat' => file_format,
+         'transcribe' => transcribe,
+         'transcriptionAvailableUrl' => transcription_available_url,
+         'transcriptionAvailableMethod' => transcription_available_method,
+         'silenceTimeout' => silence_timeout
         }))
       end
     end

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

@@ -6,7 +6,10 @@ module Bandwidth
       include XmlVerb
 
       def to_bxml(xml)
-        xml.SendDtmf(dtmf)
+        xml.SendDtmf(dtmf, compact_hash({
+            'toneDuration' => tone_duration,
+            'toneInterval' => tone_interval
+        }))
       end
     end
   end

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

@@ -14,7 +14,10 @@ module Bandwidth
          'recordingAvailableUrl' => recording_available_url,
          'recordingAvailableMethod' => recording_available_method,
          'fileFormat' => file_format,
-         'multiChannel' => multi_channel
+         'multiChannel' => multi_channel,
+         'transcribe' => transcribe,
+         'transcriptionAvailableUrl' => transcription_available_url,
+         'transcriptionAvailableMethod' => transcription_available_method
         }))
       end
     end

data/lib/bandwidth/voice_lib/voice.rb

@@ -8,23 +8,32 @@ require_relative 'voice/client.rb'
 
 # Models
 require_relative 'voice/models/api_call_response.rb'
+require_relative 'voice/models/api_call_state_response.rb'
 require_relative 'voice/models/api_create_call_request.rb'
-require_relative 'voice/models/api_get_account_recordings_metadata_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/modify_call_recording_state.rb'
 require_relative 'voice/models/recording_metadata_response.rb'
+require_relative 'voice/models/transcript.rb'
+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/direction_enum.rb'
+require_relative 'voice/models/disconnect_cause_enum.rb'
 require_relative 'voice/models/disconnect_method_enum.rb'
 require_relative 'voice/models/file_format_enum.rb'
 require_relative 'voice/models/redirect_method_enum.rb'
 require_relative 'voice/models/state_enum.rb'
 require_relative 'voice/models/state1_enum.rb'
-require_relative 'voice/models/transcription_status_enum.rb'
-require_relative 'voice/models/type_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/error_response_exception.rb'
+require_relative 'voice/exceptions/api_error_response_exception.rb'
 # Controllers
 require_relative 'voice/controllers/base_controller.rb'
 require_relative 'voice/controllers/api_controller.rb'

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

@@ -19,8 +19,13 @@ module Bandwidth
                        backoff_factor: 1, environment: Environment::PRODUCTION,
                        messaging_basic_auth_user_name: 'TODO: Replace',
                        messaging_basic_auth_password: 'TODO: Replace',
+                       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,
@@ -29,8 +34,12 @@ module Bandwidth
                                         environment: environment,
                                         messaging_basic_auth_user_name: messaging_basic_auth_user_name,
                                         messaging_basic_auth_password: messaging_basic_auth_password,
+                                        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

@@ -11,7 +11,7 @@ module Voice
       super(config, http_call_back: http_call_back)
     end
 
-    # Creates a call request
+    # Creates an outbound call
     # @param [String] account_id Required parameter: Example:
     # @param [ApiCreateCallRequest] body Optional parameter: Example:
     # @return [ApiCallResponse] response from the API call
@@ -43,36 +43,41 @@ module Voice
 
       # Validate response against endpoint and global error codes.
       if _response.status_code == 400
-        raise ErrorResponseException.new(
-          'Something didn\'t look right about that request. Please fix it' \
-          ' before trying again.',
+        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(
-          '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 ErrorResponseException.new(
-          'Your credentials are invalid. Please use your API credentials for' \
-          ' the Bandwidth Dashboard.',
+        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 ErrorResponseException.new(
-          'We don\'t support that media type. Please send us' \
-          ' `application/json`.',
+        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 ErrorResponseException.new(
+        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 ErrorResponseException.new(
+        raise ApiErrorResponseException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -84,6 +89,83 @@ module Voice
       ApiResponse.new(_response, data: ApiCallResponse.from_hash(decoded))
     end
 
+    # Returns near-realtime metadata about the specified call
+    # @param [String] account_id Required parameter: Example:
+    # @param [String] call_id Required parameter: Example:
+    # @return [ApiCallStateResponse] response from the API call
+    def get_call_state(account_id,
+                       call_id)
+      # Prepare query url.
+      _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
+      _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'accountId' => account_id,
+        'callId' => call_id
+      )
+      _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: ApiCallStateResponse.from_hash(decoded))
+    end
+
     # Interrupts and replaces an active call's BXML document
     # @param [String] account_id Required parameter: Example:
     # @param [String] call_id Required parameter: Example:
@@ -118,40 +200,41 @@ module Voice
 
       # Validate response against endpoint and global error codes.
       if _response.status_code == 400
-        raise APIException.new(
-          'The call can\'t be modified in its current state',
+        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(
-          '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 ErrorResponseException.new(
-          'Your credentials are invalid. Please use your API credentials for' \
-          ' the Bandwidth Dashboard.',
+        raise ApiErrorResponseException.new(
+          'User unauthorized to perform this action.',
           _response
         )
       elsif _response.status_code == 404
-        raise APIException.new(
-          'The call never existed, no longer exists, or is inaccessible to you',
+        raise ApiErrorResponseException.new(
+          'The resource specified cannot be found or does not belong to you.',
           _response
         )
       elsif _response.status_code == 415
-        raise ErrorResponseException.new(
-          'We don\'t support that media type. Please send us' \
-          ' `application/json`.',
+        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 ErrorResponseException.new(
+        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 ErrorResponseException.new(
+        raise ApiErrorResponseException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -196,40 +279,41 @@ module Voice
 
       # Validate response against endpoint and global error codes.
       if _response.status_code == 400
-        raise APIException.new(
-          'The call can\'t be modified in its current state',
+        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(
-          '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 ErrorResponseException.new(
-          'Your credentials are invalid. Please use your API credentials for' \
-          ' the Bandwidth Dashboard.',
+        raise ApiErrorResponseException.new(
+          'User unauthorized to perform this action.',
           _response
         )
       elsif _response.status_code == 404
-        raise APIException.new(
-          'The call never existed, no longer exists, or is inaccessible to you',
+        raise ApiErrorResponseException.new(
+          'The resource specified cannot be found or does not belong to you.',
           _response
         )
       elsif _response.status_code == 415
-        raise ErrorResponseException.new(
-          'We don\'t support that media type. Please send us' \
-          ' `application/json`.',
+        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 ErrorResponseException.new(
+        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 ErrorResponseException.new(
+        raise ApiErrorResponseException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -244,9 +328,17 @@ module Voice
     # took place during the specified call
     # @param [String] account_id Required parameter: Example:
     # @param [String] call_id Required parameter: Example:
+    # @param [String] from Optional parameter: Example:
+    # @param [String] to Optional parameter: Example:
+    # @param [String] min_start_time Optional parameter: Example:
+    # @param [String] max_start_time Optional parameter: Example:
     # @return [List of RecordingMetadataResponse] response from the API call
     def get_query_metadata_for_account_and_call(account_id,
-                                                call_id)
+                                                call_id,
+                                                from: nil,
+                                                to: nil,
+                                                min_start_time: nil,
+                                                max_start_time: nil)
       # Prepare query url.
       _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
       _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}/recordings'
@@ -255,6 +347,13 @@ module Voice
         'accountId' => account_id,
         'callId' => call_id
       )
+      _query_builder = APIHelper.append_url_with_query_parameters(
+        _query_builder,
+        'from' => from,
+        'to' => to,
+        'minStartTime' => min_start_time,
+        'maxStartTime' => max_start_time
+      )
       _query_url = APIHelper.clean_url _query_builder
 
       # Prepare headers.
@@ -272,36 +371,41 @@ module Voice
 
       # Validate response against endpoint and global error codes.
       if _response.status_code == 400
-        raise ErrorResponseException.new(
-          'Something didn\'t look right about that request. Please fix it' \
-          ' before trying again.',
+        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(
-          '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 ErrorResponseException.new(
-          'Your credentials are invalid. Please use your API credentials for' \
-          ' the Bandwidth Dashboard.',
+        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 ErrorResponseException.new(
-          'We don\'t support that media type. Please send us' \
-          ' `application/json`.',
+        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 ErrorResponseException.new(
+        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 ErrorResponseException.new(
+        raise ApiErrorResponseException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -350,42 +454,41 @@ module Voice
 
       # Validate response against endpoint and global error codes.
       if _response.status_code == 400
-        raise ErrorResponseException.new(
-          'Something didn\'t look right about that request. Please fix it' \
-          ' before trying again.',
+        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(
-          '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 ErrorResponseException.new(
-          'Your credentials are invalid. Please use your API credentials for' \
-          ' the Bandwidth Dashboard.',
+        raise ApiErrorResponseException.new(
+          'User unauthorized to perform this action.',
           _response
         )
       elsif _response.status_code == 404
-        raise APIException.new(
-          'The recording never existed, no longer exists, or is inaccessible' \
-          ' to you',
+        raise ApiErrorResponseException.new(
+          'The resource specified cannot be found or does not belong to you.',
           _response
         )
       elsif _response.status_code == 415
-        raise ErrorResponseException.new(
-          'We don\'t support that media type. Please send us' \
-          ' `application/json`.',
+        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 ErrorResponseException.new(
+        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 ErrorResponseException.new(
+        raise ApiErrorResponseException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -426,42 +529,41 @@ module Voice
 
       # Validate response against endpoint and global error codes.
       if _response.status_code == 400
-        raise ErrorResponseException.new(
-          'Something didn\'t look right about that request. Please fix it' \
-          ' before trying again.',
+        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(
-          '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 ErrorResponseException.new(
-          'Your credentials are invalid. Please use your API credentials for' \
-          ' the Bandwidth Dashboard.',
+        raise ApiErrorResponseException.new(
+          'User unauthorized to perform this action.',
           _response
         )
       elsif _response.status_code == 404
-        raise APIException.new(
-          'The recording never existed, no longer exists, or is inaccessible' \
-          ' to you',
+        raise ApiErrorResponseException.new(
+          'The resource specified cannot be found or does not belong to you.',
           _response
         )
       elsif _response.status_code == 415
-        raise ErrorResponseException.new(
-          'We don\'t support that media type. Please send us' \
-          ' `application/json`.',
+        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 ErrorResponseException.new(
+        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 ErrorResponseException.new(
+        raise ApiErrorResponseException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -500,42 +602,41 @@ module Voice
 
       # Validate response against endpoint and global error codes.
       if _response.status_code == 400
-        raise ErrorResponseException.new(
-          'Something didn\'t look right about that request. Please fix it' \
-          ' before trying again.',
+        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(
-          '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 ErrorResponseException.new(
-          'Your credentials are invalid. Please use your API credentials for' \
-          ' the Bandwidth Dashboard.',
+        raise ApiErrorResponseException.new(
+          'User unauthorized to perform this action.',
           _response
         )
       elsif _response.status_code == 404
-        raise APIException.new(
-          'The recording never existed, no longer exists, or is inaccessible' \
-          ' to you',
+        raise ApiErrorResponseException.new(
+          'The resource specified cannot be found or does not belong to you.',
           _response
         )
       elsif _response.status_code == 415
-        raise ErrorResponseException.new(
-          'We don\'t support that media type. Please send us' \
-          ' `application/json`.',
+        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 ErrorResponseException.new(
+        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 ErrorResponseException.new(
+        raise ApiErrorResponseException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -546,11 +647,415 @@ module Voice
       ApiResponse.new(_response, data: _response.raw_body)
     end
 
-    # Returns a (potentially empty; capped at 1000) list of metadata for the
-    # recordings associated with the specified account
+    # Deletes the specified recording's media
     # @param [String] account_id Required parameter: Example:
+    # @param [String] call_id Required parameter: Example:
+    # @param [String] recording_id Required parameter: Example:
+    # @return [void] response from the API call
+    def delete_recording_media(account_id,
+                               call_id,
+                               recording_id)
+      # Prepare query url.
+      _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
+      _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
+      )
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.delete(
+        _query_url
+      )
+      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
+
+    # Downloads the specified transcription
+    # @param [String] account_id Required parameter: Example:
+    # @param [String] call_id Required parameter: Example:
+    # @param [String] recording_id Required parameter: Example:
+    # @return [TranscriptionResponse] response from the API call
+    def get_recording_transcription(account_id,
+                                    call_id,
+                                    recording_id)
+      # Prepare query url.
+      _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
+      _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
+      )
+      _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: TranscriptionResponse.from_hash(decoded))
+    end
+
+    # Requests that the specified recording be transcribed
+    # @param [String] account_id Required parameter: Example:
+    # @param [String] call_id Required parameter: Example:
+    # @param [String] recording_id Required parameter: Example:
+    # @param [ApiTranscribeRecordingRequest] body Optional parameter: Example:
+    # @return [void] response from the API call
+    def create_transcribe_recording(account_id,
+                                    call_id,
+                                    recording_id,
+                                    body: nil)
+      # Prepare query url.
+      _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
+      _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
+      )
+      _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 == 410
+        raise ApiErrorResponseException.new(
+          'The media for this recording has been deleted, so we can\'t' \
+          ' transcribe it',
+          _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
+
+    # Deletes the specified recording's transcription
+    # @param [String] account_id Required parameter: Example:
+    # @param [String] call_id Required parameter: Example:
+    # @param [String] recording_id Required parameter: Example:
+    # @return [void] response from the API call
+    def delete_recording_transcription(account_id,
+                                       call_id,
+                                       recording_id)
+      # Prepare query url.
+      _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
+      _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
+      )
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.delete(
+        _query_url
+      )
+      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
+
+    # 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' => account_id,
+        'conferenceId' => conference_id
+      )
+      _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 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
+    # entries and may be empty if no recordings match the specified criteria.
+    # @param [String] account_id Required parameter: Example:
+    # @param [String] from Optional parameter: Example:
+    # @param [String] to Optional parameter: Example:
+    # @param [String] min_start_time Optional parameter: Example:
+    # @param [String] max_start_time Optional parameter: Example:
     # @return [List of RecordingMetadataResponse] response from the API call
-    def get_query_metadata_for_account(account_id)
+    def get_query_metadata_for_account(account_id,
+                                       from: nil,
+                                       to: nil,
+                                       min_start_time: nil,
+                                       max_start_time: nil)
       # Prepare query url.
       _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
       _query_builder << '/api/v2/accounts/{accountId}/recordings'
@@ -558,6 +1063,13 @@ module Voice
         _query_builder,
         'accountId' => account_id
       )
+      _query_builder = APIHelper.append_url_with_query_parameters(
+        _query_builder,
+        'from' => from,
+        'to' => to,
+        'minStartTime' => min_start_time,
+        'maxStartTime' => max_start_time
+      )
       _query_url = APIHelper.clean_url _query_builder
 
       # Prepare headers.
@@ -575,36 +1087,41 @@ module Voice
 
       # Validate response against endpoint and global error codes.
       if _response.status_code == 400
-        raise ErrorResponseException.new(
-          'Something didn\'t look right about that request. Please fix it' \
-          ' before trying again.',
+        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(
-          '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 ErrorResponseException.new(
-          'Your credentials are invalid. Please use your API credentials for' \
-          ' the Bandwidth Dashboard.',
+        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 ErrorResponseException.new(
-          'We don\'t support that media type. Please send us' \
-          ' `application/json`.',
+        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 ErrorResponseException.new(
+        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 ErrorResponseException.new(
+        raise ApiErrorResponseException.new(
           'Something unexpected happened. Please try again.',
           _response
         )