pingram 1.0.39 → 1.0.40

data/lib/pingram/api/voice_api.rb

@@ -19,35 +19,29 @@ module Pingram
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
-    # Bind a phone number to a deployed agent for inbound routing
-    # @param agent_id [String] Agent id
-    # @param bind_number_request [BindNumberRequest] 
+    # Arm the shared test number so the next call from this user's phone uses this inbound behavior
+    # @param arm_voice_inbound_claim_request [ArmVoiceInboundClaimRequest] 
     # @param [Hash] opts the optional parameters
-    # @return [BindNumberResponse]
-    def voice_bind_number(agent_id, bind_number_request, opts = {})
-      data, _status_code, _headers = voice_bind_number_with_http_info(agent_id, bind_number_request, opts)
+    # @return [ArmVoiceInboundClaimResponse]
+    def voice_arm_inbound_claim(arm_voice_inbound_claim_request, opts = {})
+      data, _status_code, _headers = voice_arm_inbound_claim_with_http_info(arm_voice_inbound_claim_request, opts)
       data
     end
 
-    # Bind a phone number to a deployed agent for inbound routing
-    # @param agent_id [String] Agent id
-    # @param bind_number_request [BindNumberRequest] 
+    # Arm the shared test number so the next call from this user's phone uses this inbound behavior
+    # @param arm_voice_inbound_claim_request [ArmVoiceInboundClaimRequest] 
     # @param [Hash] opts the optional parameters
-    # @return [Array<(BindNumberResponse, Integer, Hash)>] BindNumberResponse data, response status code and response headers
-    def voice_bind_number_with_http_info(agent_id, bind_number_request, opts = {})
+    # @return [Array<(ArmVoiceInboundClaimResponse, Integer, Hash)>] ArmVoiceInboundClaimResponse data, response status code and response headers
+    def voice_arm_inbound_claim_with_http_info(arm_voice_inbound_claim_request, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: VoiceApi.voice_bind_number ...'
+        @api_client.config.logger.debug 'Calling API: VoiceApi.voice_arm_inbound_claim ...'
       end
-      # verify the required parameter 'agent_id' is set
-      if @api_client.config.client_side_validation && agent_id.nil?
-        fail ArgumentError, "Missing the required parameter 'agent_id' when calling VoiceApi.voice_bind_number"
-      end
-      # verify the required parameter 'bind_number_request' is set
-      if @api_client.config.client_side_validation && bind_number_request.nil?
-        fail ArgumentError, "Missing the required parameter 'bind_number_request' when calling VoiceApi.voice_bind_number"
+      # verify the required parameter 'arm_voice_inbound_claim_request' is set
+      if @api_client.config.client_side_validation && arm_voice_inbound_claim_request.nil?
+        fail ArgumentError, "Missing the required parameter 'arm_voice_inbound_claim_request' when calling VoiceApi.voice_arm_inbound_claim"
       end
       # resource path
-      local_var_path = '/voice/agents/{agentId}/numbers'.sub('{' + 'agentId' + '}', CGI.escape(agent_id.to_s))
+      local_var_path = '/voice/inbound-claims'
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -66,16 +60,16 @@ module Pingram
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(bind_number_request)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(arm_voice_inbound_claim_request)
 
       # return_type
-      return_type = opts[:debug_return_type] || 'BindNumberResponse'
+      return_type = opts[:debug_return_type] || 'ArmVoiceInboundClaimResponse'
 
       # auth_names (apiKey last so Bearer wins when multiple schemes set Authorization)
       auth_names = opts[:debug_auth_names] || ['endUserHashed', 'endUser', 'clientCredentials', 'apiKey']
 
       new_options = opts.merge(
-        :operation => :"VoiceApi.voice_bind_number",
+        :operation => :"VoiceApi.voice_arm_inbound_claim",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -86,12 +80,12 @@ module Pingram
 
       data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: VoiceApi#voice_bind_number\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: VoiceApi#voice_arm_inbound_claim\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Place an outbound call with an inline agent spec (ephemeral)
+    # Place an outbound call. The config is not saved.
     # @param voice_call_request [VoiceCallRequest] 
     # @param [Hash] opts the optional parameters
     # @return [VoiceCallResponse]
@@ -100,7 +94,7 @@ module Pingram
       data
     end
 
-    # Place an outbound call with an inline agent spec (ephemeral)
+    # Place an outbound call. The config is not saved.
     # @param voice_call_request [VoiceCallRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(VoiceCallResponse, Integer, Hash)>] VoiceCallResponse data, response status code and response headers
@@ -157,29 +151,29 @@ module Pingram
       return data, status_code, headers
     end
 
-    # Deploy a voice agent (persist spec for production routing)
-    # @param create_voice_agent_request [CreateVoiceAgentRequest] 
+    # Remove inbound call behavior from a number this account owns
+    # @param phone_number [String] E.164 phone number
     # @param [Hash] opts the optional parameters
-    # @return [CreateVoiceAgentResponse]
-    def voice_create_agent(create_voice_agent_request, opts = {})
-      data, _status_code, _headers = voice_create_agent_with_http_info(create_voice_agent_request, opts)
+    # @return [MessageResponse]
+    def voice_clear_number_inbound(phone_number, opts = {})
+      data, _status_code, _headers = voice_clear_number_inbound_with_http_info(phone_number, opts)
       data
     end
 
-    # Deploy a voice agent (persist spec for production routing)
-    # @param create_voice_agent_request [CreateVoiceAgentRequest] 
+    # Remove inbound call behavior from a number this account owns
+    # @param phone_number [String] E.164 phone number
     # @param [Hash] opts the optional parameters
-    # @return [Array<(CreateVoiceAgentResponse, Integer, Hash)>] CreateVoiceAgentResponse data, response status code and response headers
-    def voice_create_agent_with_http_info(create_voice_agent_request, opts = {})
+    # @return [Array<(MessageResponse, Integer, Hash)>] MessageResponse data, response status code and response headers
+    def voice_clear_number_inbound_with_http_info(phone_number, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: VoiceApi.voice_create_agent ...'
+        @api_client.config.logger.debug 'Calling API: VoiceApi.voice_clear_number_inbound ...'
       end
-      # verify the required parameter 'create_voice_agent_request' is set
-      if @api_client.config.client_side_validation && create_voice_agent_request.nil?
-        fail ArgumentError, "Missing the required parameter 'create_voice_agent_request' when calling VoiceApi.voice_create_agent"
+      # verify the required parameter 'phone_number' is set
+      if @api_client.config.client_side_validation && phone_number.nil?
+        fail ArgumentError, "Missing the required parameter 'phone_number' when calling VoiceApi.voice_clear_number_inbound"
       end
       # resource path
-      local_var_path = '/voice/agents'
+      local_var_path = '/voice/numbers/{phoneNumber}/inbound'.sub('{' + 'phoneNumber' + '}', CGI.escape(phone_number.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -188,26 +182,21 @@ module Pingram
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
-      # HTTP header 'Content-Type'
-      content_type = @api_client.select_header_content_type(['application/json'])
-      if !content_type.nil?
-          header_params['Content-Type'] = content_type
-      end
 
       # form parameters
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(create_voice_agent_request)
+      post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'CreateVoiceAgentResponse'
+      return_type = opts[:debug_return_type] || 'MessageResponse'
 
       # auth_names (apiKey last so Bearer wins when multiple schemes set Authorization)
       auth_names = opts[:debug_auth_names] || ['endUserHashed', 'endUser', 'clientCredentials', 'apiKey']
 
       new_options = opts.merge(
-        :operation => :"VoiceApi.voice_create_agent",
+        :operation => :"VoiceApi.voice_clear_number_inbound",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -216,14 +205,14 @@ module Pingram
         :return_type => return_type
       )
 
-      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: VoiceApi#voice_create_agent\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: VoiceApi#voice_clear_number_inbound\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Place an ephemeral browser playground call with an inline agent spec
+    # Place a browser playground call. Script calls use POST /voice/call.
     # @param voice_browser_call_request [VoiceBrowserCallRequest] 
     # @param [Hash] opts the optional parameters
     # @return [VoiceBrowserCallResponse]
@@ -232,7 +221,7 @@ module Pingram
       data
     end
 
-    # Place an ephemeral browser playground call with an inline agent spec
+    # Place a browser playground call. Script calls use POST /voice/call.
     # @param voice_browser_call_request [VoiceBrowserCallRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(VoiceBrowserCallResponse, Integer, Hash)>] VoiceBrowserCallResponse data, response status code and response headers
@@ -289,128 +278,6 @@ module Pingram
       return data, status_code, headers
     end
 
-    # Remove a deployed voice agent and unbind its numbers
-    # @param agent_id [String] Agent id
-    # @param [Hash] opts the optional parameters
-    # @return [DeleteVoiceAgentResponse]
-    def voice_delete_agent(agent_id, opts = {})
-      data, _status_code, _headers = voice_delete_agent_with_http_info(agent_id, opts)
-      data
-    end
-
-    # Remove a deployed voice agent and unbind its numbers
-    # @param agent_id [String] Agent id
-    # @param [Hash] opts the optional parameters
-    # @return [Array<(DeleteVoiceAgentResponse, Integer, Hash)>] DeleteVoiceAgentResponse data, response status code and response headers
-    def voice_delete_agent_with_http_info(agent_id, opts = {})
-      if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: VoiceApi.voice_delete_agent ...'
-      end
-      # verify the required parameter 'agent_id' is set
-      if @api_client.config.client_side_validation && agent_id.nil?
-        fail ArgumentError, "Missing the required parameter 'agent_id' when calling VoiceApi.voice_delete_agent"
-      end
-      # resource path
-      local_var_path = '/voice/agents/{agentId}'.sub('{' + 'agentId' + '}', CGI.escape(agent_id.to_s))
-
-      # query parameters
-      query_params = opts[:query_params] || {}
-
-      # header parameters
-      header_params = opts[:header_params] || {}
-      # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
-
-      # form parameters
-      form_params = opts[:form_params] || {}
-
-      # http body (model)
-      post_body = opts[:debug_body]
-
-      # return_type
-      return_type = opts[:debug_return_type] || 'DeleteVoiceAgentResponse'
-
-      # auth_names (apiKey last so Bearer wins when multiple schemes set Authorization)
-      auth_names = opts[:debug_auth_names] || ['endUserHashed', 'endUser', 'clientCredentials', 'apiKey']
-
-      new_options = opts.merge(
-        :operation => :"VoiceApi.voice_delete_agent",
-        :header_params => header_params,
-        :query_params => query_params,
-        :form_params => form_params,
-        :body => post_body,
-        :auth_names => auth_names,
-        :return_type => return_type
-      )
-
-      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
-      if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: VoiceApi#voice_delete_agent\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
-      end
-      return data, status_code, headers
-    end
-
-    # Get a deployed voice agent
-    # @param agent_id [String] Agent id
-    # @param [Hash] opts the optional parameters
-    # @return [GetVoiceAgentResponse]
-    def voice_get_agent(agent_id, opts = {})
-      data, _status_code, _headers = voice_get_agent_with_http_info(agent_id, opts)
-      data
-    end
-
-    # Get a deployed voice agent
-    # @param agent_id [String] Agent id
-    # @param [Hash] opts the optional parameters
-    # @return [Array<(GetVoiceAgentResponse, Integer, Hash)>] GetVoiceAgentResponse data, response status code and response headers
-    def voice_get_agent_with_http_info(agent_id, opts = {})
-      if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: VoiceApi.voice_get_agent ...'
-      end
-      # verify the required parameter 'agent_id' is set
-      if @api_client.config.client_side_validation && agent_id.nil?
-        fail ArgumentError, "Missing the required parameter 'agent_id' when calling VoiceApi.voice_get_agent"
-      end
-      # resource path
-      local_var_path = '/voice/agents/{agentId}'.sub('{' + 'agentId' + '}', CGI.escape(agent_id.to_s))
-
-      # query parameters
-      query_params = opts[:query_params] || {}
-
-      # header parameters
-      header_params = opts[:header_params] || {}
-      # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
-
-      # form parameters
-      form_params = opts[:form_params] || {}
-
-      # http body (model)
-      post_body = opts[:debug_body]
-
-      # return_type
-      return_type = opts[:debug_return_type] || 'GetVoiceAgentResponse'
-
-      # auth_names (apiKey last so Bearer wins when multiple schemes set Authorization)
-      auth_names = opts[:debug_auth_names] || ['endUserHashed', 'endUser', 'clientCredentials', 'apiKey']
-
-      new_options = opts.merge(
-        :operation => :"VoiceApi.voice_get_agent",
-        :header_params => header_params,
-        :query_params => query_params,
-        :form_params => form_params,
-        :body => post_body,
-        :auth_names => auth_names,
-        :return_type => return_type
-      )
-
-      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
-      if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: VoiceApi#voice_get_agent\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
-      end
-      return data, status_code, headers
-    end
-
     # Get a call with transcript timeline and recording playback URL
     # @param tracking_id [String] Call tracking id
     # @param [Hash] opts the optional parameters
@@ -472,64 +339,8 @@ module Pingram
       return data, status_code, headers
     end
 
-    # List deployed voice agents for the account
-    # @param [Hash] opts the optional parameters
-    # @return [ListVoiceAgentsResponse]
-    def voice_list_agents(opts = {})
-      data, _status_code, _headers = voice_list_agents_with_http_info(opts)
-      data
-    end
-
-    # List deployed voice agents for the account
-    # @param [Hash] opts the optional parameters
-    # @return [Array<(ListVoiceAgentsResponse, Integer, Hash)>] ListVoiceAgentsResponse data, response status code and response headers
-    def voice_list_agents_with_http_info(opts = {})
-      if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: VoiceApi.voice_list_agents ...'
-      end
-      # resource path
-      local_var_path = '/voice/agents'
-
-      # query parameters
-      query_params = opts[:query_params] || {}
-
-      # header parameters
-      header_params = opts[:header_params] || {}
-      # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
-
-      # form parameters
-      form_params = opts[:form_params] || {}
-
-      # http body (model)
-      post_body = opts[:debug_body]
-
-      # return_type
-      return_type = opts[:debug_return_type] || 'ListVoiceAgentsResponse'
-
-      # auth_names (apiKey last so Bearer wins when multiple schemes set Authorization)
-      auth_names = opts[:debug_auth_names] || ['endUserHashed', 'endUser', 'clientCredentials', 'apiKey']
-
-      new_options = opts.merge(
-        :operation => :"VoiceApi.voice_list_agents",
-        :header_params => header_params,
-        :query_params => query_params,
-        :form_params => form_params,
-        :body => post_body,
-        :auth_names => auth_names,
-        :return_type => return_type
-      )
-
-      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
-      if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: VoiceApi#voice_list_agents\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
-      end
-      return data, status_code, headers
-    end
-
     # List recent calls newest-first (30-day retention)
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :agent_id Only calls handled by this agent
     # @option opts [Float] :limit Page size (default 25, max 100)
     # @option opts [String] :cursor Pagination cursor from a previous response
     # @return [ListVoiceCallsResponse]
@@ -540,7 +351,6 @@ module Pingram
 
     # List recent calls newest-first (30-day retention)
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :agent_id Only calls handled by this agent
     # @option opts [Float] :limit Page size (default 25, max 100)
     # @option opts [String] :cursor Pagination cursor from a previous response
     # @return [Array<(ListVoiceCallsResponse, Integer, Hash)>] ListVoiceCallsResponse data, response status code and response headers
@@ -553,7 +363,6 @@ module Pingram
 
       # query parameters
       query_params = opts[:query_params] || {}
-      query_params[:'agentId'] = opts[:'agent_id'] if !opts[:'agent_id'].nil?
       query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
       query_params[:'cursor'] = opts[:'cursor'] if !opts[:'cursor'].nil?
 
@@ -591,102 +400,35 @@ module Pingram
       return data, status_code, headers
     end
 
-    # Unbind a phone number from a deployed agent
-    # @param agent_id [String] Agent id
+    # Store inbound call behavior on a number this account owns
     # @param phone_number [String] E.164 phone number
+    # @param inbound_config [InboundConfig] 
     # @param [Hash] opts the optional parameters
-    # @return [UnbindNumberResponse]
-    def voice_unbind_number(agent_id, phone_number, opts = {})
-      data, _status_code, _headers = voice_unbind_number_with_http_info(agent_id, phone_number, opts)
+    # @return [MessageResponse]
+    def voice_put_number_inbound(phone_number, inbound_config, opts = {})
+      data, _status_code, _headers = voice_put_number_inbound_with_http_info(phone_number, inbound_config, opts)
       data
     end
 
-    # Unbind a phone number from a deployed agent
-    # @param agent_id [String] Agent id
+    # Store inbound call behavior on a number this account owns
     # @param phone_number [String] E.164 phone number
+    # @param inbound_config [InboundConfig] 
     # @param [Hash] opts the optional parameters
-    # @return [Array<(UnbindNumberResponse, Integer, Hash)>] UnbindNumberResponse data, response status code and response headers
-    def voice_unbind_number_with_http_info(agent_id, phone_number, opts = {})
+    # @return [Array<(MessageResponse, Integer, Hash)>] MessageResponse data, response status code and response headers
+    def voice_put_number_inbound_with_http_info(phone_number, inbound_config, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: VoiceApi.voice_unbind_number ...'
-      end
-      # verify the required parameter 'agent_id' is set
-      if @api_client.config.client_side_validation && agent_id.nil?
-        fail ArgumentError, "Missing the required parameter 'agent_id' when calling VoiceApi.voice_unbind_number"
+        @api_client.config.logger.debug 'Calling API: VoiceApi.voice_put_number_inbound ...'
       end
       # verify the required parameter 'phone_number' is set
       if @api_client.config.client_side_validation && phone_number.nil?
-        fail ArgumentError, "Missing the required parameter 'phone_number' when calling VoiceApi.voice_unbind_number"
-      end
-      # resource path
-      local_var_path = '/voice/agents/{agentId}/numbers/{phoneNumber}'.sub('{' + 'agentId' + '}', CGI.escape(agent_id.to_s)).sub('{' + 'phoneNumber' + '}', CGI.escape(phone_number.to_s))
-
-      # query parameters
-      query_params = opts[:query_params] || {}
-
-      # header parameters
-      header_params = opts[:header_params] || {}
-      # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
-
-      # form parameters
-      form_params = opts[:form_params] || {}
-
-      # http body (model)
-      post_body = opts[:debug_body]
-
-      # return_type
-      return_type = opts[:debug_return_type] || 'UnbindNumberResponse'
-
-      # auth_names (apiKey last so Bearer wins when multiple schemes set Authorization)
-      auth_names = opts[:debug_auth_names] || ['endUserHashed', 'endUser', 'clientCredentials', 'apiKey']
-
-      new_options = opts.merge(
-        :operation => :"VoiceApi.voice_unbind_number",
-        :header_params => header_params,
-        :query_params => query_params,
-        :form_params => form_params,
-        :body => post_body,
-        :auth_names => auth_names,
-        :return_type => return_type
-      )
-
-      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
-      if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: VoiceApi#voice_unbind_number\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
-      end
-      return data, status_code, headers
-    end
-
-    # Publish changes to a deployed voice agent
-    # @param agent_id [String] Agent id
-    # @param update_voice_agent_request [UpdateVoiceAgentRequest] 
-    # @param [Hash] opts the optional parameters
-    # @return [UpdateVoiceAgentResponse]
-    def voice_update_agent(agent_id, update_voice_agent_request, opts = {})
-      data, _status_code, _headers = voice_update_agent_with_http_info(agent_id, update_voice_agent_request, opts)
-      data
-    end
-
-    # Publish changes to a deployed voice agent
-    # @param agent_id [String] Agent id
-    # @param update_voice_agent_request [UpdateVoiceAgentRequest] 
-    # @param [Hash] opts the optional parameters
-    # @return [Array<(UpdateVoiceAgentResponse, Integer, Hash)>] UpdateVoiceAgentResponse data, response status code and response headers
-    def voice_update_agent_with_http_info(agent_id, update_voice_agent_request, opts = {})
-      if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: VoiceApi.voice_update_agent ...'
-      end
-      # verify the required parameter 'agent_id' is set
-      if @api_client.config.client_side_validation && agent_id.nil?
-        fail ArgumentError, "Missing the required parameter 'agent_id' when calling VoiceApi.voice_update_agent"
+        fail ArgumentError, "Missing the required parameter 'phone_number' when calling VoiceApi.voice_put_number_inbound"
       end
-      # verify the required parameter 'update_voice_agent_request' is set
-      if @api_client.config.client_side_validation && update_voice_agent_request.nil?
-        fail ArgumentError, "Missing the required parameter 'update_voice_agent_request' when calling VoiceApi.voice_update_agent"
+      # verify the required parameter 'inbound_config' is set
+      if @api_client.config.client_side_validation && inbound_config.nil?
+        fail ArgumentError, "Missing the required parameter 'inbound_config' when calling VoiceApi.voice_put_number_inbound"
       end
       # resource path
-      local_var_path = '/voice/agents/{agentId}'.sub('{' + 'agentId' + '}', CGI.escape(agent_id.to_s))
+      local_var_path = '/voice/numbers/{phoneNumber}/inbound'.sub('{' + 'phoneNumber' + '}', CGI.escape(phone_number.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -705,16 +447,16 @@ module Pingram
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(update_voice_agent_request)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(inbound_config)
 
       # return_type
-      return_type = opts[:debug_return_type] || 'UpdateVoiceAgentResponse'
+      return_type = opts[:debug_return_type] || 'MessageResponse'
 
       # auth_names (apiKey last so Bearer wins when multiple schemes set Authorization)
       auth_names = opts[:debug_auth_names] || ['endUserHashed', 'endUser', 'clientCredentials', 'apiKey']
 
       new_options = opts.merge(
-        :operation => :"VoiceApi.voice_update_agent",
+        :operation => :"VoiceApi.voice_put_number_inbound",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -725,7 +467,7 @@ module Pingram
 
       data, status_code, headers = @api_client.call_api(:PUT, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: VoiceApi#voice_update_agent\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: VoiceApi#voice_put_number_inbound\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end

data/lib/pingram/api/webhooks_api.rb

@@ -19,7 +19,7 @@ module Pingram
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
-    # Create a webhook endpoint. Pingram POSTs signed JSON to the URL when one of the subscribed events happens. The response includes id and a signing secret starting with pingram_whsecret_. Save it and verify the X-Pingram-Signature header. Updates keep this secret. At most 10 endpoints per account. The URL must be a public HTTPS URL and should return 2xx.
+    # Create a webhook endpoint on a server outside Pingram. Pingram later POSTs signed JSON to that URL when one of the subscribed events happens. This call only saves the endpoint; it does not send a webhook and does not modify the destination server. The response includes id and a signing secret starting with pingram_whsecret_. Save it and verify the X-Pingram-Signature header. Updates keep this secret. At most 10 endpoints per account. The URL must be a public HTTPS URL and should return 2xx.
     # @param webhook_endpoint_upsert_request [WebhookEndpointUpsertRequest] 
     # @param [Hash] opts the optional parameters
     # @return [WebhookEndpoint]
@@ -28,7 +28,7 @@ module Pingram
       data
     end
 
-    # Create a webhook endpoint. Pingram POSTs signed JSON to the URL when one of the subscribed events happens. The response includes id and a signing secret starting with pingram_whsecret_. Save it and verify the X-Pingram-Signature header. Updates keep this secret. At most 10 endpoints per account. The URL must be a public HTTPS URL and should return 2xx.
+    # Create a webhook endpoint on a server outside Pingram. Pingram later POSTs signed JSON to that URL when one of the subscribed events happens. This call only saves the endpoint; it does not send a webhook and does not modify the destination server. The response includes id and a signing secret starting with pingram_whsecret_. Save it and verify the X-Pingram-Signature header. Updates keep this secret. At most 10 endpoints per account. The URL must be a public HTTPS URL and should return 2xx.
     # @param webhook_endpoint_upsert_request [WebhookEndpointUpsertRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(WebhookEndpoint, Integer, Hash)>] WebhookEndpoint data, response status code and response headers
@@ -201,7 +201,7 @@ module Pingram
       return data, status_code, headers
     end
 
-    # Replace one webhook endpoint's URL and its full event subscription. endpointId comes from list or create. The signing secret stays the same. events is the complete set; omitting an event unsubscribes it. The URL must be a public HTTPS URL.
+    # Replace one webhook endpoint's URL and its full event subscription. The URL is a server outside Pingram. endpointId comes from list or create. The signing secret stays the same. events is the complete set; omitting an event unsubscribes it, and the previous URL stops receiving events. The previous URL and event list are not kept. The URL must be a public HTTPS URL.
     # @param endpoint_id [String] Id of the webhook endpoint, from list or create.
     # @param webhook_endpoint_upsert_request [WebhookEndpointUpsertRequest] 
     # @param [Hash] opts the optional parameters
@@ -211,7 +211,7 @@ module Pingram
       data
     end
 
-    # Replace one webhook endpoint&#39;s URL and its full event subscription. endpointId comes from list or create. The signing secret stays the same. events is the complete set; omitting an event unsubscribes it. The URL must be a public HTTPS URL.
+    # Replace one webhook endpoint&#39;s URL and its full event subscription. The URL is a server outside Pingram. endpointId comes from list or create. The signing secret stays the same. events is the complete set; omitting an event unsubscribes it, and the previous URL stops receiving events. The previous URL and event list are not kept. The URL must be a public HTTPS URL.
     # @param endpoint_id [String] Id of the webhook endpoint, from list or create.
     # @param webhook_endpoint_upsert_request [WebhookEndpointUpsertRequest] 
     # @param [Hash] opts the optional parameters

data/lib/pingram/api_client.rb

@@ -32,7 +32,7 @@ module Pingram
     # @option config [Configuration] Configuration for initializing the object, default to Configuration.default
     def initialize(config = Configuration.default)
       @config = config
-      @user_agent = "pingram-ruby/1.0.39"
+      @user_agent = "pingram-ruby/1.0.40"
       @default_headers = {
         'Content-Type' => 'application/json',
         'User-Agent' => @user_agent