bandwidth-sdk 2.2.2 → 3.12.1

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

@@ -17,20 +17,31 @@ module Bandwidth
 
         def initialize(timeout: 60, max_retries: 0, retry_interval: 1,
                        backoff_factor: 1, environment: Environment::PRODUCTION,
+                       base_url: 'https://www.example.com',
                        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,
                                         retry_interval: retry_interval,
                                         backoff_factor: backoff_factor,
                                         environment: environment,
+                                        base_url: base_url,
                                         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

@@ -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
@@ -332,31 +332,16 @@ 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,
-                                                from: nil,
-                                                to: nil,
-                                                min_start_time: nil,
-                                                max_start_time: nil)
+                                                call_id)
       # Prepare query url.
       _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
       _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
-      )
-      _query_builder = APIHelper.append_url_with_query_parameters(
-        _query_builder,
-        'from' => from,
-        'to' => to,
-        'minStartTime' => min_start_time,
-        'maxStartTime' => max_start_time
+        'accountId' => { 'value' => account_id, 'encode' => true },
+        'callId' => { 'value' => call_id, 'encode' => true }
       )
       _query_url = APIHelper.clean_url _query_builder
 
@@ -376,20 +361,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 +422,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 +444,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 +486,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 +504,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 +520,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 +577,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 +593,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 +634,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 +652,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 +668,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 +725,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 +747,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 +789,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 +809,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 +832,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 +895,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 +911,273 @@ 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(
+          '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 conferences in the account
+    # @param [String] account_id Required parameter: Example:
+    # @param [Integer] page_size Optional parameter: Example:1000
+    # @param [String] page_token Optional parameter: Example:
+    # @param [String] name Optional parameter: Example:
+    # @param [String] min_created_time Optional parameter: Example:
+    # @param [String] max_created_time Optional parameter: Example:
+    # @return [List of ConferenceDetail] response from the API call
+    def get_conferences_by_account(account_id,
+                                   page_size: 1000,
+                                   page_token: nil,
+                                   name: nil,
+                                   min_created_time: nil,
+                                   max_created_time: nil)
+      # Prepare query url.
+      _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
+      _query_builder << '/api/v2/accounts/{accountId}/conferences'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'accountId' => { 'value' => account_id, 'encode' => true }
+      )
+      _query_builder = APIHelper.append_url_with_query_parameters(
+        _query_builder,
+        'pageSize' => page_size,
+        'pageToken' => page_token,
+        'name' => name,
+        'minCreatedTime' => min_created_time,
+        'maxCreatedTime' => max_created_time
+      )
+      _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: decoded.map { |element| ConferenceDetail.from_hash(element) }
+      )
+    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(
-          '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 +1209,408 @@ module Voice
       ApiResponse.new(_response)
     end
 
+    # Updates settings for a particular conference member
+    # @param [String] account_id Required parameter: Example:
+    # @param [String] conference_id Required parameter: Example:
+    # @param [String] call_id Required parameter: Example:
+    # @param [ConferenceMemberDetail] body Optional parameter: Example:
+    # @return [void] response from the API call
+    def modify_conference_member(account_id,
+                                 conference_id,
+                                 call_id,
+                                 body: nil)
+      # Prepare query url.
+      _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
+      _query_builder << '/api/v2/accounts/{accountId}/conferences/{conferenceId}/members/{callId}'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'accountId' => { 'value' => account_id, 'encode' => true },
+        'conferenceId' => { 'value' => conference_id, 'encode' => true },
+        'callId' => { 'value' => call_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.put(
+        _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 (potentially empty) list of metadata for the recordings that
+    # took place during the specified conference
+    # @param [String] account_id Required parameter: Example:
+    # @param [String] conference_id Required parameter: Example:
+    # @return [List of ConferenceRecordingMetadataResponse] response from the API call
+    def get_query_metadata_for_account_and_conference(account_id,
+                                                      conference_id)
+      # Prepare query url.
+      _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
+      _query_builder << '/api/v2/accounts/{accountId}/conferences/{conferenceId}/recordings'
+      _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: decoded.map { |element| ConferenceRecordingMetadataResponse.from_hash(element) }
+      )
+    end
+
+    # Returns metadata for the specified recording
+    # @param [String] account_id Required parameter: Example:
+    # @param [String] conference_id Required parameter: Example:
+    # @param [String] recording_id Required parameter: Example:
+    # @return [RecordingMetadataResponse] response from the API call
+    def get_metadata_for_conference_recording(account_id,
+                                              conference_id,
+                                              recording_id)
+      # Prepare query url.
+      _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
+      _query_builder << '/api/v2/accounts/{accountId}/conferences/{conferenceId}/recordings/{recordingId}'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'accountId' => { 'value' => account_id, 'encode' => true },
+        'conferenceId' => { 'value' => conference_id, 'encode' => true },
+        'recordingId' => { 'value' => recording_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: RecordingMetadataResponse.from_hash(decoded)
+      )
+    end
+
+    # Downloads the specified recording
+    # @param [String] account_id Required parameter: Example:
+    # @param [String] conference_id Required parameter: Example:
+    # @param [String] recording_id Required parameter: Example:
+    # @return [Binary] response from the API call
+    def get_stream_conference_recording_media(account_id,
+                                              conference_id,
+                                              recording_id)
+      # Prepare query url.
+      _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
+      _query_builder << '/api/v2/accounts/{accountId}/conferences/{conferenceId}/recordings/{recordingId}/media'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'accountId' => { 'value' => account_id, 'encode' => true },
+        'conferenceId' => { 'value' => conference_id, 'encode' => true },
+        'recordingId' => { 'value' => recording_id, 'encode' => true }
+      )
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.get(
+        _query_url
+      )
+      VoiceBasicAuth.apply(config, _request)
+      _response = execute_request(_request, binary: true)
+
+      # 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, data: _response.raw_body
+      )
+    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 +1631,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 +1658,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