vapi_server_sdk 0.4.0 → 0.9.1

data/lib/vapi_server_sdk/types/create_computer_tool_dto.rb

@@ -1,20 +1,13 @@
 # frozen_string_literal: true
 
 require_relative "create_computer_tool_dto_messages_item"
-require_relative "open_ai_function"
 require_relative "server"
+require_relative "open_ai_function"
 require "ostruct"
 require "json"
 
 module Vapi
   class CreateComputerToolDto
-    # @return [Boolean] This determines if the tool is async.
-    #  If async, the assistant will move forward without waiting for your server to
-    #  respond. This is useful if you just want to trigger something on your server.
-    #  If sync, the assistant will wait for your server to respond. This is useful if
-    #  want assistant to respond with the result from your server.
-    #  Defaults to synchronous (`false`).
-    attr_reader :async
     # @return [Array<Vapi::CreateComputerToolDtoMessagesItem>] These are the messages that will be spoken to the user as the tool is running.
     #  For some tools, this is auto-filled based on special fields like
     #  `tool.destinations`. For others like the function tool, these can be custom
@@ -22,6 +15,17 @@ module Vapi
     attr_reader :messages
     # @return [String] The sub type of tool.
     attr_reader :sub_type
+    # @return [Vapi::Server]
+    #  This is the server where a `tool-calls` webhook will be sent.
+    #  Notes:
+    #  - Webhook is sent to this server when a tool call is made.
+    #  - Webhook contains the call, assistant, and phone number objects.
+    #  - Webhook contains the variables set on the assistant.
+    #  - Webhook is sent to the first available URL in this order:
+    #  {{tool.server.url}}, {{assistant.server.url}}, {{phoneNumber.server.url}},
+    #  {{org.server.url}}.
+    #  - Webhook expects a response with tool call result.
+    attr_reader :server
     # @return [String] The name of the tool, fixed to 'computer'
     attr_reader :name
     # @return [Float] The display width in pixels
@@ -40,13 +44,6 @@ module Vapi
     #  "request-complete" messages. One of these messages will be triggered if the
     #  `messages[].conditions` matches the "reason" argument.
     attr_reader :function
-    # @return [Vapi::Server] This is the server that will be hit when this tool is requested by the model.
-    #  All requests will be sent with the call object among other things. You can find
-    #  more details in the Server URL documentation.
-    #  This overrides the serverUrl set on the org and the phoneNumber. Order of
-    #  precedence: highest tool.server.url, then assistant.serverUrl, then
-    #  phoneNumber.serverUrl, then org.serverUrl.
-    attr_reader :server
     # @return [OpenStruct] Additional properties unmapped to the current class definition
     attr_reader :additional_properties
     # @return [Object]
@@ -55,17 +52,21 @@ module Vapi
 
     OMIT = Object.new
 
-    # @param async [Boolean] This determines if the tool is async.
-    #  If async, the assistant will move forward without waiting for your server to
-    #  respond. This is useful if you just want to trigger something on your server.
-    #  If sync, the assistant will wait for your server to respond. This is useful if
-    #  want assistant to respond with the result from your server.
-    #  Defaults to synchronous (`false`).
     # @param messages [Array<Vapi::CreateComputerToolDtoMessagesItem>] These are the messages that will be spoken to the user as the tool is running.
     #  For some tools, this is auto-filled based on special fields like
     #  `tool.destinations`. For others like the function tool, these can be custom
     #  configured.
     # @param sub_type [String] The sub type of tool.
+    # @param server [Vapi::Server]
+    #  This is the server where a `tool-calls` webhook will be sent.
+    #  Notes:
+    #  - Webhook is sent to this server when a tool call is made.
+    #  - Webhook contains the call, assistant, and phone number objects.
+    #  - Webhook contains the variables set on the assistant.
+    #  - Webhook is sent to the first available URL in this order:
+    #  {{tool.server.url}}, {{assistant.server.url}}, {{phoneNumber.server.url}},
+    #  {{org.server.url}}.
+    #  - Webhook expects a response with tool call result.
     # @param name [String] The name of the tool, fixed to 'computer'
     # @param display_width_px [Float] The display width in pixels
     # @param display_height_px [Float] The display height in pixels
@@ -79,36 +80,28 @@ module Vapi
     #  argument "reason". Then, in `messages` array, you can have many
     #  "request-complete" messages. One of these messages will be triggered if the
     #  `messages[].conditions` matches the "reason" argument.
-    # @param server [Vapi::Server] This is the server that will be hit when this tool is requested by the model.
-    #  All requests will be sent with the call object among other things. You can find
-    #  more details in the Server URL documentation.
-    #  This overrides the serverUrl set on the org and the phoneNumber. Order of
-    #  precedence: highest tool.server.url, then assistant.serverUrl, then
-    #  phoneNumber.serverUrl, then org.serverUrl.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vapi::CreateComputerToolDto]
-    def initialize(sub_type:, name:, display_width_px:, display_height_px:, async: OMIT, messages: OMIT,
-                   display_number: OMIT, function: OMIT, server: OMIT, additional_properties: nil)
-      @async = async if async != OMIT
+    def initialize(sub_type:, name:, display_width_px:, display_height_px:, messages: OMIT, server: OMIT,
+                   display_number: OMIT, function: OMIT, additional_properties: nil)
       @messages = messages if messages != OMIT
       @sub_type = sub_type
+      @server = server if server != OMIT
       @name = name
       @display_width_px = display_width_px
       @display_height_px = display_height_px
       @display_number = display_number if display_number != OMIT
       @function = function if function != OMIT
-      @server = server if server != OMIT
       @additional_properties = additional_properties
       @_field_set = {
-        "async": async,
         "messages": messages,
         "subType": sub_type,
+        "server": server,
         "name": name,
         "displayWidthPx": display_width_px,
         "displayHeightPx": display_height_px,
         "displayNumber": display_number,
-        "function": function,
-        "server": server
+        "function": function
       }.reject do |_k, v|
         v == OMIT
       end
@@ -121,12 +114,17 @@ module Vapi
     def self.from_json(json_object:)
       struct = JSON.parse(json_object, object_class: OpenStruct)
       parsed_json = JSON.parse(json_object)
-      async = parsed_json["async"]
       messages = parsed_json["messages"]&.map do |item|
         item = item.to_json
         Vapi::CreateComputerToolDtoMessagesItem.from_json(json_object: item)
       end
       sub_type = parsed_json["subType"]
+      if parsed_json["server"].nil?
+        server = nil
+      else
+        server = parsed_json["server"].to_json
+        server = Vapi::Server.from_json(json_object: server)
+      end
       name = parsed_json["name"]
       display_width_px = parsed_json["displayWidthPx"]
       display_height_px = parsed_json["displayHeightPx"]
@@ -137,22 +135,15 @@ module Vapi
         function = parsed_json["function"].to_json
         function = Vapi::OpenAiFunction.from_json(json_object: function)
       end
-      if parsed_json["server"].nil?
-        server = nil
-      else
-        server = parsed_json["server"].to_json
-        server = Vapi::Server.from_json(json_object: server)
-      end
       new(
-        async: async,
         messages: messages,
         sub_type: sub_type,
+        server: server,
         name: name,
         display_width_px: display_width_px,
         display_height_px: display_height_px,
         display_number: display_number,
         function: function,
-        server: server,
         additional_properties: struct
       )
     end
@@ -171,15 +162,14 @@ module Vapi
     # @param obj [Object]
     # @return [Void]
     def self.validate_raw(obj:)
-      obj.async&.is_a?(Boolean) != false || raise("Passed value for field obj.async is not the expected type, validation failed.")
       obj.messages&.is_a?(Array) != false || raise("Passed value for field obj.messages is not the expected type, validation failed.")
       obj.sub_type.is_a?(String) != false || raise("Passed value for field obj.sub_type is not the expected type, validation failed.")
+      obj.server.nil? || Vapi::Server.validate_raw(obj: obj.server)
       obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
       obj.display_width_px.is_a?(Float) != false || raise("Passed value for field obj.display_width_px is not the expected type, validation failed.")
       obj.display_height_px.is_a?(Float) != false || raise("Passed value for field obj.display_height_px is not the expected type, validation failed.")
       obj.display_number&.is_a?(Float) != false || raise("Passed value for field obj.display_number is not the expected type, validation failed.")
       obj.function.nil? || Vapi::OpenAiFunction.validate_raw(obj: obj.function)
-      obj.server.nil? || Vapi::Server.validate_raw(obj: obj.server)
     end
   end
 end

data/lib/vapi_server_sdk/types/create_customer_dto.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require_relative "assistant_overrides"
 require "ostruct"
 require "json"
 
@@ -18,6 +19,11 @@ module Vapi
     attr_reader :number_e_164_check_enabled
     # @return [String] This is the extension that will be dialed after the call is answered.
     attr_reader :extension
+    # @return [Vapi::AssistantOverrides] These are the overrides for the assistant's settings and template variables
+    #  specific to this customer.
+    #  This allows customization of the assistant's behavior for individual customers
+    #  in batch calls.
+    attr_reader :assistant_overrides
     # @return [String] This is the number of the customer.
     attr_reader :number
     # @return [String] This is the SIP URI of the customer.
@@ -26,6 +32,10 @@ module Vapi
     #  For SIP inbound calls, this is extracted from the `From` SIP header with format
     #  `"Display Name" <sip:username@domain>`.
     attr_reader :name
+    # @return [String] This is the email of the customer.
+    attr_reader :email
+    # @return [String] This is the external ID of the customer.
+    attr_reader :external_id
     # @return [OpenStruct] Additional properties unmapped to the current class definition
     attr_reader :additional_properties
     # @return [Object]
@@ -45,27 +55,39 @@ module Vapi
     #  characters (regex: `/^\+?[a-zA-Z0-9]+$/`).
     #  @default true (E164 check is enabled)
     # @param extension [String] This is the extension that will be dialed after the call is answered.
+    # @param assistant_overrides [Vapi::AssistantOverrides] These are the overrides for the assistant's settings and template variables
+    #  specific to this customer.
+    #  This allows customization of the assistant's behavior for individual customers
+    #  in batch calls.
     # @param number [String] This is the number of the customer.
     # @param sip_uri [String] This is the SIP URI of the customer.
     # @param name [String] This is the name of the customer. This is just for your own reference.
     #  For SIP inbound calls, this is extracted from the `From` SIP header with format
     #  `"Display Name" <sip:username@domain>`.
+    # @param email [String] This is the email of the customer.
+    # @param external_id [String] This is the external ID of the customer.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vapi::CreateCustomerDto]
-    def initialize(number_e_164_check_enabled: OMIT, extension: OMIT, number: OMIT, sip_uri: OMIT, name: OMIT,
-                   additional_properties: nil)
+    def initialize(number_e_164_check_enabled: OMIT, extension: OMIT, assistant_overrides: OMIT, number: OMIT,
+                   sip_uri: OMIT, name: OMIT, email: OMIT, external_id: OMIT, additional_properties: nil)
       @number_e_164_check_enabled = number_e_164_check_enabled if number_e_164_check_enabled != OMIT
       @extension = extension if extension != OMIT
+      @assistant_overrides = assistant_overrides if assistant_overrides != OMIT
       @number = number if number != OMIT
       @sip_uri = sip_uri if sip_uri != OMIT
       @name = name if name != OMIT
+      @email = email if email != OMIT
+      @external_id = external_id if external_id != OMIT
       @additional_properties = additional_properties
       @_field_set = {
         "numberE164CheckEnabled": number_e_164_check_enabled,
         "extension": extension,
+        "assistantOverrides": assistant_overrides,
         "number": number,
         "sipUri": sip_uri,
-        "name": name
+        "name": name,
+        "email": email,
+        "externalId": external_id
       }.reject do |_k, v|
         v == OMIT
       end
@@ -80,15 +102,26 @@ module Vapi
       parsed_json = JSON.parse(json_object)
       number_e_164_check_enabled = parsed_json["numberE164CheckEnabled"]
       extension = parsed_json["extension"]
+      if parsed_json["assistantOverrides"].nil?
+        assistant_overrides = nil
+      else
+        assistant_overrides = parsed_json["assistantOverrides"].to_json
+        assistant_overrides = Vapi::AssistantOverrides.from_json(json_object: assistant_overrides)
+      end
       number = parsed_json["number"]
       sip_uri = parsed_json["sipUri"]
       name = parsed_json["name"]
+      email = parsed_json["email"]
+      external_id = parsed_json["externalId"]
       new(
         number_e_164_check_enabled: number_e_164_check_enabled,
         extension: extension,
+        assistant_overrides: assistant_overrides,
         number: number,
         sip_uri: sip_uri,
         name: name,
+        email: email,
+        external_id: external_id,
         additional_properties: struct
       )
     end
@@ -109,9 +142,12 @@ module Vapi
     def self.validate_raw(obj:)
       obj.number_e_164_check_enabled&.is_a?(Boolean) != false || raise("Passed value for field obj.number_e_164_check_enabled is not the expected type, validation failed.")
       obj.extension&.is_a?(String) != false || raise("Passed value for field obj.extension is not the expected type, validation failed.")
+      obj.assistant_overrides.nil? || Vapi::AssistantOverrides.validate_raw(obj: obj.assistant_overrides)
       obj.number&.is_a?(String) != false || raise("Passed value for field obj.number is not the expected type, validation failed.")
       obj.sip_uri&.is_a?(String) != false || raise("Passed value for field obj.sip_uri is not the expected type, validation failed.")
       obj.name&.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
+      obj.email&.is_a?(String) != false || raise("Passed value for field obj.email is not the expected type, validation failed.")
+      obj.external_id&.is_a?(String) != false || raise("Passed value for field obj.external_id is not the expected type, validation failed.")
     end
   end
 end

data/lib/vapi_server_sdk/types/create_dtmf_tool_dto.rb

@@ -2,19 +2,11 @@
 
 require_relative "create_dtmf_tool_dto_messages_item"
 require_relative "open_ai_function"
-require_relative "server"
 require "ostruct"
 require "json"
 
 module Vapi
   class CreateDtmfToolDto
-    # @return [Boolean] This determines if the tool is async.
-    #  If async, the assistant will move forward without waiting for your server to
-    #  respond. This is useful if you just want to trigger something on your server.
-    #  If sync, the assistant will wait for your server to respond. This is useful if
-    #  want assistant to respond with the result from your server.
-    #  Defaults to synchronous (`false`).
-    attr_reader :async
     # @return [Array<Vapi::CreateDtmfToolDtoMessagesItem>] These are the messages that will be spoken to the user as the tool is running.
     #  For some tools, this is auto-filled based on special fields like
     #  `tool.destinations`. For others like the function tool, these can be custom
@@ -30,13 +22,6 @@ module Vapi
     #  "request-complete" messages. One of these messages will be triggered if the
     #  `messages[].conditions` matches the "reason" argument.
     attr_reader :function
-    # @return [Vapi::Server] This is the server that will be hit when this tool is requested by the model.
-    #  All requests will be sent with the call object among other things. You can find
-    #  more details in the Server URL documentation.
-    #  This overrides the serverUrl set on the org and the phoneNumber. Order of
-    #  precedence: highest tool.server.url, then assistant.serverUrl, then
-    #  phoneNumber.serverUrl, then org.serverUrl.
-    attr_reader :server
     # @return [OpenStruct] Additional properties unmapped to the current class definition
     attr_reader :additional_properties
     # @return [Object]
@@ -45,12 +30,6 @@ module Vapi
 
     OMIT = Object.new
 
-    # @param async [Boolean] This determines if the tool is async.
-    #  If async, the assistant will move forward without waiting for your server to
-    #  respond. This is useful if you just want to trigger something on your server.
-    #  If sync, the assistant will wait for your server to respond. This is useful if
-    #  want assistant to respond with the result from your server.
-    #  Defaults to synchronous (`false`).
     # @param messages [Array<Vapi::CreateDtmfToolDtoMessagesItem>] These are the messages that will be spoken to the user as the tool is running.
     #  For some tools, this is auto-filled based on special fields like
     #  `tool.destinations`. For others like the function tool, these can be custom
@@ -64,21 +43,13 @@ module Vapi
     #  argument "reason". Then, in `messages` array, you can have many
     #  "request-complete" messages. One of these messages will be triggered if the
     #  `messages[].conditions` matches the "reason" argument.
-    # @param server [Vapi::Server] This is the server that will be hit when this tool is requested by the model.
-    #  All requests will be sent with the call object among other things. You can find
-    #  more details in the Server URL documentation.
-    #  This overrides the serverUrl set on the org and the phoneNumber. Order of
-    #  precedence: highest tool.server.url, then assistant.serverUrl, then
-    #  phoneNumber.serverUrl, then org.serverUrl.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vapi::CreateDtmfToolDto]
-    def initialize(async: OMIT, messages: OMIT, function: OMIT, server: OMIT, additional_properties: nil)
-      @async = async if async != OMIT
+    def initialize(messages: OMIT, function: OMIT, additional_properties: nil)
       @messages = messages if messages != OMIT
       @function = function if function != OMIT
-      @server = server if server != OMIT
       @additional_properties = additional_properties
-      @_field_set = { "async": async, "messages": messages, "function": function, "server": server }.reject do |_k, v|
+      @_field_set = { "messages": messages, "function": function }.reject do |_k, v|
         v == OMIT
       end
     end
@@ -90,7 +61,6 @@ module Vapi
     def self.from_json(json_object:)
       struct = JSON.parse(json_object, object_class: OpenStruct)
       parsed_json = JSON.parse(json_object)
-      async = parsed_json["async"]
       messages = parsed_json["messages"]&.map do |item|
         item = item.to_json
         Vapi::CreateDtmfToolDtoMessagesItem.from_json(json_object: item)
@@ -101,17 +71,9 @@ module Vapi
         function = parsed_json["function"].to_json
         function = Vapi::OpenAiFunction.from_json(json_object: function)
       end
-      if parsed_json["server"].nil?
-        server = nil
-      else
-        server = parsed_json["server"].to_json
-        server = Vapi::Server.from_json(json_object: server)
-      end
       new(
-        async: async,
         messages: messages,
         function: function,
-        server: server,
         additional_properties: struct
       )
     end
@@ -130,10 +92,8 @@ module Vapi
     # @param obj [Object]
     # @return [Void]
     def self.validate_raw(obj:)
-      obj.async&.is_a?(Boolean) != false || raise("Passed value for field obj.async is not the expected type, validation failed.")
       obj.messages&.is_a?(Array) != false || raise("Passed value for field obj.messages is not the expected type, validation failed.")
       obj.function.nil? || Vapi::OpenAiFunction.validate_raw(obj: obj.function)
-      obj.server.nil? || Vapi::Server.validate_raw(obj: obj.server)
     end
   end
 end

data/lib/vapi_server_sdk/types/create_end_call_tool_dto.rb

@@ -2,19 +2,11 @@
 
 require_relative "create_end_call_tool_dto_messages_item"
 require_relative "open_ai_function"
-require_relative "server"
 require "ostruct"
 require "json"
 
 module Vapi
   class CreateEndCallToolDto
-    # @return [Boolean] This determines if the tool is async.
-    #  If async, the assistant will move forward without waiting for your server to
-    #  respond. This is useful if you just want to trigger something on your server.
-    #  If sync, the assistant will wait for your server to respond. This is useful if
-    #  want assistant to respond with the result from your server.
-    #  Defaults to synchronous (`false`).
-    attr_reader :async
     # @return [Array<Vapi::CreateEndCallToolDtoMessagesItem>] These are the messages that will be spoken to the user as the tool is running.
     #  For some tools, this is auto-filled based on special fields like
     #  `tool.destinations`. For others like the function tool, these can be custom
@@ -30,13 +22,6 @@ module Vapi
     #  "request-complete" messages. One of these messages will be triggered if the
     #  `messages[].conditions` matches the "reason" argument.
     attr_reader :function
-    # @return [Vapi::Server] This is the server that will be hit when this tool is requested by the model.
-    #  All requests will be sent with the call object among other things. You can find
-    #  more details in the Server URL documentation.
-    #  This overrides the serverUrl set on the org and the phoneNumber. Order of
-    #  precedence: highest tool.server.url, then assistant.serverUrl, then
-    #  phoneNumber.serverUrl, then org.serverUrl.
-    attr_reader :server
     # @return [OpenStruct] Additional properties unmapped to the current class definition
     attr_reader :additional_properties
     # @return [Object]
@@ -45,12 +30,6 @@ module Vapi
 
     OMIT = Object.new
 
-    # @param async [Boolean] This determines if the tool is async.
-    #  If async, the assistant will move forward without waiting for your server to
-    #  respond. This is useful if you just want to trigger something on your server.
-    #  If sync, the assistant will wait for your server to respond. This is useful if
-    #  want assistant to respond with the result from your server.
-    #  Defaults to synchronous (`false`).
     # @param messages [Array<Vapi::CreateEndCallToolDtoMessagesItem>] These are the messages that will be spoken to the user as the tool is running.
     #  For some tools, this is auto-filled based on special fields like
     #  `tool.destinations`. For others like the function tool, these can be custom
@@ -64,21 +43,13 @@ module Vapi
     #  argument "reason". Then, in `messages` array, you can have many
     #  "request-complete" messages. One of these messages will be triggered if the
     #  `messages[].conditions` matches the "reason" argument.
-    # @param server [Vapi::Server] This is the server that will be hit when this tool is requested by the model.
-    #  All requests will be sent with the call object among other things. You can find
-    #  more details in the Server URL documentation.
-    #  This overrides the serverUrl set on the org and the phoneNumber. Order of
-    #  precedence: highest tool.server.url, then assistant.serverUrl, then
-    #  phoneNumber.serverUrl, then org.serverUrl.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vapi::CreateEndCallToolDto]
-    def initialize(async: OMIT, messages: OMIT, function: OMIT, server: OMIT, additional_properties: nil)
-      @async = async if async != OMIT
+    def initialize(messages: OMIT, function: OMIT, additional_properties: nil)
       @messages = messages if messages != OMIT
       @function = function if function != OMIT
-      @server = server if server != OMIT
       @additional_properties = additional_properties
-      @_field_set = { "async": async, "messages": messages, "function": function, "server": server }.reject do |_k, v|
+      @_field_set = { "messages": messages, "function": function }.reject do |_k, v|
         v == OMIT
       end
     end
@@ -90,7 +61,6 @@ module Vapi
     def self.from_json(json_object:)
       struct = JSON.parse(json_object, object_class: OpenStruct)
       parsed_json = JSON.parse(json_object)
-      async = parsed_json["async"]
       messages = parsed_json["messages"]&.map do |item|
         item = item.to_json
         Vapi::CreateEndCallToolDtoMessagesItem.from_json(json_object: item)
@@ -101,17 +71,9 @@ module Vapi
         function = parsed_json["function"].to_json
         function = Vapi::OpenAiFunction.from_json(json_object: function)
       end
-      if parsed_json["server"].nil?
-        server = nil
-      else
-        server = parsed_json["server"].to_json
-        server = Vapi::Server.from_json(json_object: server)
-      end
       new(
-        async: async,
         messages: messages,
         function: function,
-        server: server,
         additional_properties: struct
       )
     end
@@ -130,10 +92,8 @@ module Vapi
     # @param obj [Object]
     # @return [Void]
     def self.validate_raw(obj:)
-      obj.async&.is_a?(Boolean) != false || raise("Passed value for field obj.async is not the expected type, validation failed.")
       obj.messages&.is_a?(Array) != false || raise("Passed value for field obj.messages is not the expected type, validation failed.")
       obj.function.nil? || Vapi::OpenAiFunction.validate_raw(obj: obj.function)
-      obj.server.nil? || Vapi::Server.validate_raw(obj: obj.server)
     end
   end
 end

data/lib/vapi_server_sdk/types/create_function_tool_dto.rb

@@ -1,13 +1,18 @@
 # frozen_string_literal: true
 
 require_relative "create_function_tool_dto_messages_item"
-require_relative "open_ai_function"
 require_relative "server"
+require_relative "open_ai_function"
 require "ostruct"
 require "json"
 
 module Vapi
   class CreateFunctionToolDto
+    # @return [Array<Vapi::CreateFunctionToolDtoMessagesItem>] These are the messages that will be spoken to the user as the tool is running.
+    #  For some tools, this is auto-filled based on special fields like
+    #  `tool.destinations`. For others like the function tool, these can be custom
+    #  configured.
+    attr_reader :messages
     # @return [Boolean] This determines if the tool is async.
     #  If async, the assistant will move forward without waiting for your server to
     #  respond. This is useful if you just want to trigger something on your server.
@@ -15,11 +20,17 @@ module Vapi
     #  want assistant to respond with the result from your server.
     #  Defaults to synchronous (`false`).
     attr_reader :async
-    # @return [Array<Vapi::CreateFunctionToolDtoMessagesItem>] These are the messages that will be spoken to the user as the tool is running.
-    #  For some tools, this is auto-filled based on special fields like
-    #  `tool.destinations`. For others like the function tool, these can be custom
-    #  configured.
-    attr_reader :messages
+    # @return [Vapi::Server]
+    #  This is the server where a `tool-calls` webhook will be sent.
+    #  Notes:
+    #  - Webhook is sent to this server when a tool call is made.
+    #  - Webhook contains the call, assistant, and phone number objects.
+    #  - Webhook contains the variables set on the assistant.
+    #  - Webhook is sent to the first available URL in this order:
+    #  {{tool.server.url}}, {{assistant.server.url}}, {{phoneNumber.server.url}},
+    #  {{org.server.url}}.
+    #  - Webhook expects a response with tool call result.
+    attr_reader :server
     # @return [Vapi::OpenAiFunction] This is the function definition of the tool.
     #  For `endCall`, `transferCall`, and `dtmf` tools, this is auto-filled based on
     #  tool-specific fields like `tool.destinations`. But, even in those cases, you can
@@ -30,13 +41,6 @@ module Vapi
     #  "request-complete" messages. One of these messages will be triggered if the
     #  `messages[].conditions` matches the "reason" argument.
     attr_reader :function
-    # @return [Vapi::Server] This is the server that will be hit when this tool is requested by the model.
-    #  All requests will be sent with the call object among other things. You can find
-    #  more details in the Server URL documentation.
-    #  This overrides the serverUrl set on the org and the phoneNumber. Order of
-    #  precedence: highest tool.server.url, then assistant.serverUrl, then
-    #  phoneNumber.serverUrl, then org.serverUrl.
-    attr_reader :server
     # @return [OpenStruct] Additional properties unmapped to the current class definition
     attr_reader :additional_properties
     # @return [Object]
@@ -45,16 +49,26 @@ module Vapi
 
     OMIT = Object.new
 
+    # @param messages [Array<Vapi::CreateFunctionToolDtoMessagesItem>] These are the messages that will be spoken to the user as the tool is running.
+    #  For some tools, this is auto-filled based on special fields like
+    #  `tool.destinations`. For others like the function tool, these can be custom
+    #  configured.
     # @param async [Boolean] This determines if the tool is async.
     #  If async, the assistant will move forward without waiting for your server to
     #  respond. This is useful if you just want to trigger something on your server.
     #  If sync, the assistant will wait for your server to respond. This is useful if
     #  want assistant to respond with the result from your server.
     #  Defaults to synchronous (`false`).
-    # @param messages [Array<Vapi::CreateFunctionToolDtoMessagesItem>] These are the messages that will be spoken to the user as the tool is running.
-    #  For some tools, this is auto-filled based on special fields like
-    #  `tool.destinations`. For others like the function tool, these can be custom
-    #  configured.
+    # @param server [Vapi::Server]
+    #  This is the server where a `tool-calls` webhook will be sent.
+    #  Notes:
+    #  - Webhook is sent to this server when a tool call is made.
+    #  - Webhook contains the call, assistant, and phone number objects.
+    #  - Webhook contains the variables set on the assistant.
+    #  - Webhook is sent to the first available URL in this order:
+    #  {{tool.server.url}}, {{assistant.server.url}}, {{phoneNumber.server.url}},
+    #  {{org.server.url}}.
+    #  - Webhook expects a response with tool call result.
     # @param function [Vapi::OpenAiFunction] This is the function definition of the tool.
     #  For `endCall`, `transferCall`, and `dtmf` tools, this is auto-filled based on
     #  tool-specific fields like `tool.destinations`. But, even in those cases, you can
@@ -64,21 +78,15 @@ module Vapi
     #  argument "reason". Then, in `messages` array, you can have many
     #  "request-complete" messages. One of these messages will be triggered if the
     #  `messages[].conditions` matches the "reason" argument.
-    # @param server [Vapi::Server] This is the server that will be hit when this tool is requested by the model.
-    #  All requests will be sent with the call object among other things. You can find
-    #  more details in the Server URL documentation.
-    #  This overrides the serverUrl set on the org and the phoneNumber. Order of
-    #  precedence: highest tool.server.url, then assistant.serverUrl, then
-    #  phoneNumber.serverUrl, then org.serverUrl.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vapi::CreateFunctionToolDto]
-    def initialize(async: OMIT, messages: OMIT, function: OMIT, server: OMIT, additional_properties: nil)
-      @async = async if async != OMIT
+    def initialize(messages: OMIT, async: OMIT, server: OMIT, function: OMIT, additional_properties: nil)
       @messages = messages if messages != OMIT
-      @function = function if function != OMIT
+      @async = async if async != OMIT
       @server = server if server != OMIT
+      @function = function if function != OMIT
       @additional_properties = additional_properties
-      @_field_set = { "async": async, "messages": messages, "function": function, "server": server }.reject do |_k, v|
+      @_field_set = { "messages": messages, "async": async, "server": server, "function": function }.reject do |_k, v|
         v == OMIT
       end
     end
@@ -90,28 +98,28 @@ module Vapi
     def self.from_json(json_object:)
       struct = JSON.parse(json_object, object_class: OpenStruct)
       parsed_json = JSON.parse(json_object)
-      async = parsed_json["async"]
       messages = parsed_json["messages"]&.map do |item|
         item = item.to_json
         Vapi::CreateFunctionToolDtoMessagesItem.from_json(json_object: item)
       end
-      if parsed_json["function"].nil?
-        function = nil
-      else
-        function = parsed_json["function"].to_json
-        function = Vapi::OpenAiFunction.from_json(json_object: function)
-      end
+      async = parsed_json["async"]
       if parsed_json["server"].nil?
         server = nil
       else
         server = parsed_json["server"].to_json
         server = Vapi::Server.from_json(json_object: server)
       end
+      if parsed_json["function"].nil?
+        function = nil
+      else
+        function = parsed_json["function"].to_json
+        function = Vapi::OpenAiFunction.from_json(json_object: function)
+      end
       new(
-        async: async,
         messages: messages,
-        function: function,
+        async: async,
         server: server,
+        function: function,
         additional_properties: struct
       )
     end
@@ -130,10 +138,10 @@ module Vapi
     # @param obj [Object]
     # @return [Void]
     def self.validate_raw(obj:)
-      obj.async&.is_a?(Boolean) != false || raise("Passed value for field obj.async is not the expected type, validation failed.")
       obj.messages&.is_a?(Array) != false || raise("Passed value for field obj.messages is not the expected type, validation failed.")
-      obj.function.nil? || Vapi::OpenAiFunction.validate_raw(obj: obj.function)
+      obj.async&.is_a?(Boolean) != false || raise("Passed value for field obj.async is not the expected type, validation failed.")
       obj.server.nil? || Vapi::Server.validate_raw(obj: obj.server)
+      obj.function.nil? || Vapi::OpenAiFunction.validate_raw(obj: obj.function)
     end
   end
 end