revox 0.0.2 → 0.2.0

data/lib/revox/models/users/me_retrieve_response.rb

@@ -64,7 +64,17 @@ module Revox
           #   @return [Object]
           required :updated_at, Revox::Internal::Type::Unknown
 
-          # @!method initialize(id:, created_at:, email:, first_name:, has_completed_onboarding:, last_name:, organization_id:, updated_at:)
+          # @!attribute organization_country
+          #   ISO 3166-1 alpha-2 country code of the organization (e.g. FR). Used as the
+          #   default region when normalizing national-format phone numbers.
+          #
+          #   @return [String, nil]
+          optional :organization_country, String, nil?: true
+
+          # @!method initialize(id:, created_at:, email:, first_name:, has_completed_onboarding:, last_name:, organization_id:, updated_at:, organization_country: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Revox::Models::Users::MeRetrieveResponse::User} for more details.
+          #
           #   The current authenticated user.
           #
           #   @param id [String] The unique identifier of the user.
@@ -82,6 +92,8 @@ module Revox
           #   @param organization_id [String] The ID of the organization the user belongs to.
           #
           #   @param updated_at [Object] The time the user was last updated.
+          #
+          #   @param organization_country [String, nil] ISO 3166-1 alpha-2 country code of the organization (e.g. FR). Used as the defau
         end
       end
     end

data/lib/revox/models/users/me_update_response.rb

@@ -64,7 +64,17 @@ module Revox
           #   @return [Object]
           required :updated_at, Revox::Internal::Type::Unknown
 
-          # @!method initialize(id:, created_at:, email:, first_name:, has_completed_onboarding:, last_name:, organization_id:, updated_at:)
+          # @!attribute organization_country
+          #   ISO 3166-1 alpha-2 country code of the organization (e.g. FR). Used as the
+          #   default region when normalizing national-format phone numbers.
+          #
+          #   @return [String, nil]
+          optional :organization_country, String, nil?: true
+
+          # @!method initialize(id:, created_at:, email:, first_name:, has_completed_onboarding:, last_name:, organization_id:, updated_at:, organization_country: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Revox::Models::Users::MeUpdateResponse::User} for more details.
+          #
           #   The current authenticated user.
           #
           #   @param id [String] The unique identifier of the user.
@@ -82,6 +92,8 @@ module Revox
           #   @param organization_id [String] The ID of the organization the user belongs to.
           #
           #   @param updated_at [Object] The time the user was last updated.
+          #
+          #   @param organization_country [String, nil] ISO 3166-1 alpha-2 country code of the organization (e.g. FR). Used as the defau
         end
       end
     end

data/lib/revox/models/voice_list_response.rb

@@ -43,7 +43,38 @@ module Revox
         #   @return [Symbol, Revox::Models::VoiceListResponse::Voice::Provider]
         required :provider, enum: -> { Revox::Models::VoiceListResponse::Voice::Provider }
 
-        # @!method initialize(id:, description:, language:, name:, provider:)
+        # @!attribute accent
+        #   The accent/dialect of the voice (e.g. 'american', 'british', 'australian',
+        #   'quebec').
+        #
+        #   @return [String, nil]
+        optional :accent, String
+
+        # @!attribute gender
+        #   The gender of the voice (e.g. 'male', 'female', 'neutral').
+        #
+        #   @return [String, nil]
+        optional :gender, String
+
+        # @!attribute is_cloned
+        #   Whether this is a cloned voice.
+        #
+        #   @return [Boolean, nil]
+        optional :is_cloned, Revox::Internal::Type::Boolean, api_name: :isCloned
+
+        # @!attribute model_compat
+        #   Cartesia model compatibility. Used to filter the voice list by the selected
+        #   model. Absent/undefined is treated as 'universal'.
+        #
+        #   @return [Symbol, Revox::Models::VoiceListResponse::Voice::ModelCompat, nil]
+        optional :model_compat,
+                 enum: -> { Revox::Models::VoiceListResponse::Voice::ModelCompat },
+                 api_name: :modelCompat
+
+        # @!method initialize(id:, description:, language:, name:, provider:, accent: nil, gender: nil, is_cloned: nil, model_compat: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Revox::Models::VoiceListResponse::Voice} for more details.
+        #
         #   @param id [String] The ID of the voice.
         #
         #   @param description [String] The description of the voice.
@@ -53,6 +84,14 @@ module Revox
         #   @param name [String] The name of the voice.
         #
         #   @param provider [Symbol, Revox::Models::VoiceListResponse::Voice::Provider] The provider of the voice.
+        #
+        #   @param accent [String] The accent/dialect of the voice (e.g. 'american', 'british', 'australian', 'queb
+        #
+        #   @param gender [String] The gender of the voice (e.g. 'male', 'female', 'neutral').
+        #
+        #   @param is_cloned [Boolean] Whether this is a cloned voice.
+        #
+        #   @param model_compat [Symbol, Revox::Models::VoiceListResponse::Voice::ModelCompat] Cartesia model compatibility. Used to filter the voice list by the selected mode
 
         # The language of the voice.
         #
@@ -85,6 +124,21 @@ module Revox
           # @!method self.values
           #   @return [Array<Symbol>]
         end
+
+        # Cartesia model compatibility. Used to filter the voice list by the selected
+        # model. Absent/undefined is treated as 'universal'.
+        #
+        # @see Revox::Models::VoiceListResponse::Voice#model_compat
+        module ModelCompat
+          extend Revox::Internal::Type::Enum
+
+          UNIVERSAL = :universal
+          SONIC_3 = :"sonic-3"
+          SONIC_3_5 = :"sonic-3.5"
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
       end
     end
   end

data/lib/revox/models/voice_preview_params.rb

@@ -19,18 +19,46 @@ module Revox
       #   @return [String]
       required :voice_id, String, api_name: :voiceId
 
+      # @!attribute model
+      #   Cartesia model for the preview. Defaults to sonic-3. Ignored for other
+      #   providers.
+      #
+      #   @return [Symbol, Revox::Models::VoicePreviewParams::Model, nil]
+      optional :model, enum: -> { Revox::VoicePreviewParams::Model }
+
+      # @!attribute speed
+      #   Speed for preview. Cartesia 0.6–1.5, ElevenLabs 0.7–1.2. Default 1.0.
+      #
+      #   @return [Float, nil]
+      optional :speed, Float
+
       # @!attribute text
-      #   The text to generate a preview for.
+      #   Custom text for the preview. If omitted, a short default is used.
       #
       #   @return [String, nil]
       optional :text, String
 
-      # @!method initialize(provider:, voice_id:, text: nil, request_options: {})
+      # @!attribute volume
+      #   Volume for Cartesia preview (0.5–2.0). Ignored for other providers.
+      #
+      #   @return [Float, nil]
+      optional :volume, Float
+
+      # @!method initialize(provider:, voice_id:, model: nil, speed: nil, text: nil, volume: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Revox::Models::VoicePreviewParams} for more details.
+      #
       #   @param provider [Symbol, Revox::Models::VoicePreviewParams::Provider] The provider to use for the preview.
       #
       #   @param voice_id [String] The voice ID to generate a preview for.
       #
-      #   @param text [String] The text to generate a preview for.
+      #   @param model [Symbol, Revox::Models::VoicePreviewParams::Model] Cartesia model for the preview. Defaults to sonic-3. Ignored for other providers
+      #
+      #   @param speed [Float] Speed for preview. Cartesia 0.6–1.5, ElevenLabs 0.7–1.2. Default 1.0.
+      #
+      #   @param text [String] Custom text for the preview. If omitted, a short default is used.
+      #
+      #   @param volume [Float] Volume for Cartesia preview (0.5–2.0). Ignored for other providers.
       #
       #   @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}]
 
@@ -44,6 +72,18 @@ module Revox
         # @!method self.values
         #   @return [Array<Symbol>]
       end
+
+      # Cartesia model for the preview. Defaults to sonic-3. Ignored for other
+      # providers.
+      module Model
+        extend Revox::Internal::Type::Enum
+
+        SONIC_3 = :"sonic-3"
+        SONIC_3_5 = :"sonic-3.5"
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/revox/models/voice_retrieve_params.rb

@@ -7,12 +7,18 @@ module Revox
       extend Revox::Internal::Type::RequestParameters::Converter
       include Revox::Internal::Type::RequestParameters
 
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
       # @!attribute provider
       #
       #   @return [Symbol, Revox::Models::VoiceRetrieveParams::Provider]
       required :provider, enum: -> { Revox::VoiceRetrieveParams::Provider }
 
-      # @!method initialize(provider:, request_options: {})
+      # @!method initialize(id:, provider:, request_options: {})
+      #   @param id [String]
       #   @param provider [Symbol, Revox::Models::VoiceRetrieveParams::Provider]
       #   @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}]
 

data/lib/revox/models.rb

@@ -51,10 +51,22 @@ module Revox
 
   CallCreateParams = Revox::Models::CallCreateParams
 
-  CallListParams = Revox::Models::CallListParams
-
   CallRetrieveParams = Revox::Models::CallRetrieveParams
 
+  CampaignCancelParams = Revox::Models::CampaignCancelParams
+
+  CampaignCreateParams = Revox::Models::CampaignCreateParams
+
+  CampaignDeleteParams = Revox::Models::CampaignDeleteParams
+
+  CampaignExportRowsParams = Revox::Models::CampaignExportRowsParams
+
+  CampaignGetRowsParams = Revox::Models::CampaignGetRowsParams
+
+  CampaignListParams = Revox::Models::CampaignListParams
+
+  CampaignRetrieveParams = Revox::Models::CampaignRetrieveParams
+
   Users = Revox::Models::Users
 
   VoiceListParams = Revox::Models::VoiceListParams

data/lib/revox/resources/assistants.rb

@@ -6,18 +6,40 @@ module Revox
       # Some parameter documentations has been truncated, see
       # {Revox::Models::AssistantCreateParams} for more details.
       #
-      # @overload create(name:, prompt:, background_sound: nil, calendly: nil, call_retry_config: nil, end_of_call_sentence: nil, faq_items: nil, first_sentence: nil, first_sentence_delay_ms: nil, first_sentence_mode: nil, ivr_navigation_enabled: nil, llm_model: nil, max_call_duration_secs: nil, structured_output_config: nil, transfer_phone_number: nil, voice: nil, voicemail_message: nil, webhook_url: nil, request_options: {})
+      # Create a new AI assistant with a custom prompt, voice, and behavior
+      # configuration. Assistants define how the AI agent behaves during calls,
+      # including the system prompt given to the LLM, the first sentence spoken, the
+      # voice provider and voice ID (Cartesia or ElevenLabs), and end-of-call behavior.
+      # Once created, reference the assistant by its ID when placing calls.
+      #
+      # @overload create(name:, prompt:, after_call_sms_outcomes: nil, after_call_sms_prompt: nil, background_sound: nil, background_sound_volume: nil, calendly: nil, call_retry_config: nil, cartesia_dictionary_pronunciation_id: nil, custom_tools: nil, email_notification_address: nil, email_notification_language: nil, email_notification_outcomes: nil, end_of_call_sentence: nil, faq_items: nil, first_sentence: nil, first_sentence_delay_ms: nil, first_sentence_mode: nil, from_phone_number: nil, human_transfer_mode: nil, ivr_navigation_enabled: nil, llm_model: nil, logo_url: nil, max_call_duration_secs: nil, max_duration_end_message: nil, position: nil, prompt_flow: nil, slack: nil, sms_enabled: nil, sms_template: nil, structured_output_config: nil, structured_output_prompt: nil, stt_context: nil, stt_model: nil, thinking_sound: nil, thinking_sound_probability: nil, thinking_sound_volume: nil, transfer_phone_number: nil, type: nil, voice: nil, voicemail_message: nil, voicemail_sms_prompt: nil, warm_transfer_summary_instructions: nil, webhook_url: nil, zoho: nil, request_options: {})
       #
       # @param name [String]
       #
       # @param prompt [String] The prompt to use for the call. This will be given to the LLM (gpt-4.1)
       #
-      # @param background_sound [Symbol, Revox::Models::AssistantCreateParams::BackgroundSound, nil] The background sound to play during the call. Useful to give the impression that
+      # @param after_call_sms_outcomes [Array<Symbol, Revox::Models::AssistantCreateParams::AfterCallSMSOutcome>, nil] Which call outcomes trigger the after-call SMS. When empty or null, no after-cal
+      #
+      # @param after_call_sms_prompt [String, nil] Prompt / instructions for the after-call SMS. Supports {{variable}} placeholders
+      #
+      # @param background_sound [Symbol, Revox::Models::AssistantCreateParams::BackgroundSound, nil] Ambient background sound to play during the call. null/omitted disables it.
+      #
+      # @param background_sound_volume [Float] Volume of the ambient background sound (0 = silent, 1 = max).
       #
       # @param calendly [Revox::Models::AssistantCreateParams::Calendly, nil]
       #
       # @param call_retry_config [Revox::Models::AssistantCreateParams::CallRetryConfig] Configuration for call retry behavior including time windows, delays, and max it
       #
+      # @param cartesia_dictionary_pronunciation_id [String, nil] Optional Cartesia pronunciation dictionary ID to use for this assistant's calls.
+      #
+      # @param custom_tools [Array<Revox::Models::AssistantCreateParams::CustomTool>, nil] Custom API tools the assistant can call during conversations. Each tool defines
+      #
+      # @param email_notification_address [String, nil] Email address(es) to receive notifications when a call ends with a matching outc
+      #
+      # @param email_notification_language [Symbol, Revox::Models::AssistantCreateParams::EmailNotificationLanguage] The language used for the notification email content. One of "en" or "fr". Defau
+      #
+      # @param email_notification_outcomes [Array<Symbol, Revox::Models::AssistantCreateParams::EmailNotificationOutcome>, nil] Which call outcomes trigger an email notification. E.g. ["interested", "complete
+      #
       # @param end_of_call_sentence [String] Optional message to say when the agent decides to end the call.
       #
       # @param faq_items [Array<Revox::Models::AssistantCreateParams::FaqItem>] FAQ items to associate with this assistant. When provided, replaces all existing
@@ -28,22 +50,60 @@ module Revox
       #
       # @param first_sentence_mode [Symbol, Revox::Models::AssistantCreateParams::FirstSentenceMode] How the first sentence should be handled. "generated" means the LLM will generat
       #
+      # @param from_phone_number [String, nil] Override the default outbound phone number for calls placed with this assistant.
+      #
+      # @param human_transfer_mode [Symbol, Revox::Models::AssistantCreateParams::HumanTransferMode, nil] When transfer_phone_number is set: "warm" (AI bridges) or "cold" (SIP REFER; tru
+      #
       # @param ivr_navigation_enabled [Boolean] Enable IVR navigation tools. When enabled, the assistant can send DTMF tones and
       #
-      # @param llm_model [Revox::Models::AssistantCreateParams::LlmModel::UnionMember0, Revox::Models::AssistantCreateParams::LlmModel::UnionMember1]
+      # @param llm_model [Revox::Models::AssistantCreateParams::LlmModel::UnionMember0, Revox::Models::AssistantCreateParams::LlmModel::UnionMember1, Revox::Models::AssistantCreateParams::LlmModel::UnionMember2, Revox::Models::AssistantCreateParams::LlmModel::UnionMember3]
+      #
+      # @param logo_url [String, nil] Public URL of the brand logo shown on the assistant's demo page. Upload a new lo
       #
       # @param max_call_duration_secs [Float] The maximum duration of the call in seconds. This is the maximum time the call w
       #
+      # @param max_duration_end_message [String, nil] Optional message the agent will say, without being interruptible, when the call
+      #
+      # @param position [Revox::Models::AssistantCreateParams::Position, nil] Canvas position of this assistant's node in its multi-step flow editor.
+      #
+      # @param prompt_flow [Revox::Models::AssistantCreateParams::PromptFlow, nil] Visual prompt constructor data (nodes, edges, positions). Used by the UI to re-o
+      #
+      # @param slack [Revox::Models::AssistantCreateParams::Slack, nil] Slack notification config. When set, posts a message to the chosen channel after
+      #
+      # @param sms_enabled [Boolean] Enable SMS tool during calls. When enabled, the agent can send SMS messages to t
+      #
+      # @param sms_template [String, nil] Hardcoded SMS template to send during calls. When set, this exact text is sent i
+      #
       # @param structured_output_config [Array<Revox::Models::AssistantCreateParams::StructuredOutputConfig>] The structured output config to use for the call. This is used to extract the da
       #
+      # @param structured_output_prompt [String, nil] Custom prompt for structured data extraction. If not provided, a default prompt
+      #
+      # @param stt_context [Revox::Models::AssistantCreateParams::SttContext, nil] Assistant-level speech-to-text context: structured `general` key/value pairs plu
+      #
+      # @param stt_model [Symbol, Revox::Models::AssistantCreateParams::SttModel] Transcriber (speech-to-text) model. Defaults to the newest Soniox realtime model
+      #
+      # @param thinking_sound [Symbol, Revox::Models::AssistantCreateParams::ThinkingSound, nil] Audio clip to play while the agent is processing a response. One of the built-in
+      #
+      # @param thinking_sound_probability [Float] Probability [0..1] that the thinking sound plays on any given turn; otherwise th
+      #
+      # @param thinking_sound_volume [Float] Volume of the thinking sound (0 = silent, 1 = max).
+      #
       # @param transfer_phone_number [String, nil] Phone number to transfer calls to when users request to speak to a human agent i
       #
+      # @param type [Symbol, Revox::Models::AssistantCreateParams::Type] Assistant kind. 'standalone' (default) is a normal assistant, 'multi-step' orche
+      #
       # @param voice [Revox::Models::AssistantCreateParams::Voice] The voice to use for the call. You can get the list of voices using the /voices
       #
       # @param voicemail_message [String, nil] If set, when voicemail is detected the agent will speak this message then hang u
       #
+      # @param voicemail_sms_prompt [String, nil] SMS message to send when the call reaches voicemail. Supports {{variable}} place
+      #
+      # @param warm_transfer_summary_instructions [String, nil] When using warm transfer: extra instructions for the supervisor handoff summary.
+      #
       # @param webhook_url [String] The webhook URL to call when the call is completed.
       #
+      # @param zoho [Revox::Models::AssistantCreateParams::Zoho, nil] Zoho CRM integration config. When set, upserts the prospect (keyed on phone) int
+      #
       # @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Revox::Models::AssistantCreateResponse]
@@ -60,6 +120,11 @@ module Revox
         )
       end
 
+      # Retrieve a single assistant by its unique ID. Returns the full assistant
+      # configuration including prompt, voice settings, and first sentence mode. Useful
+      # for inspecting an assistant's current setup before updating it or placing a
+      # call.
+      #
       # @overload retrieve(id, request_options: {})
       #
       # @param id [String]
@@ -80,16 +145,37 @@ module Revox
       # Some parameter documentations has been truncated, see
       # {Revox::Models::AssistantUpdateParams} for more details.
       #
-      # @overload update(id, background_sound: nil, calendly: nil, call_retry_config: nil, end_of_call_sentence: nil, faq_items: nil, first_sentence: nil, first_sentence_delay_ms: nil, first_sentence_mode: nil, ivr_navigation_enabled: nil, llm_model: nil, max_call_duration_secs: nil, name: nil, prompt: nil, structured_output_config: nil, transfer_phone_number: nil, voice: nil, voicemail_message: nil, webhook_url: nil, request_options: {})
+      # Update one or more fields on an existing assistant. Supports partial updates —
+      # only the fields you include in the request body will be changed. You can update
+      # the prompt, voice, first sentence, name, or any other assistant property without
+      # affecting the rest of the configuration.
+      #
+      # @overload update(id, after_call_sms_outcomes: nil, after_call_sms_prompt: nil, background_sound: nil, background_sound_volume: nil, calendly: nil, call_retry_config: nil, cartesia_dictionary_pronunciation_id: nil, custom_tools: nil, email_notification_address: nil, email_notification_language: nil, email_notification_outcomes: nil, end_of_call_sentence: nil, faq_items: nil, first_sentence: nil, first_sentence_delay_ms: nil, first_sentence_mode: nil, from_phone_number: nil, human_transfer_mode: nil, ivr_navigation_enabled: nil, llm_model: nil, logo_url: nil, max_call_duration_secs: nil, max_duration_end_message: nil, name: nil, position: nil, prompt: nil, prompt_flow: nil, slack: nil, sms_enabled: nil, sms_template: nil, structured_output_config: nil, structured_output_prompt: nil, stt_context: nil, stt_model: nil, thinking_sound: nil, thinking_sound_probability: nil, thinking_sound_volume: nil, transfer_phone_number: nil, type: nil, voice: nil, voicemail_message: nil, voicemail_sms_prompt: nil, warm_transfer_summary_instructions: nil, webhook_url: nil, zoho: nil, request_options: {})
       #
       # @param id [String]
       #
-      # @param background_sound [Symbol, Revox::Models::AssistantUpdateParams::BackgroundSound, nil] The background sound to play during the call. Useful to give the impression that
+      # @param after_call_sms_outcomes [Array<Symbol, Revox::Models::AssistantUpdateParams::AfterCallSMSOutcome>, nil] Which call outcomes trigger the after-call SMS. When empty or null, no after-cal
+      #
+      # @param after_call_sms_prompt [String, nil] Prompt / instructions for the after-call SMS. Supports {{variable}} placeholders
+      #
+      # @param background_sound [Symbol, Revox::Models::AssistantUpdateParams::BackgroundSound, nil] Ambient background sound to play during the call. null/omitted disables it.
+      #
+      # @param background_sound_volume [Float] Volume of the ambient background sound (0 = silent, 1 = max).
       #
       # @param calendly [Revox::Models::AssistantUpdateParams::Calendly, nil]
       #
       # @param call_retry_config [Revox::Models::AssistantUpdateParams::CallRetryConfig] Configuration for call retry behavior including time windows, delays, and max it
       #
+      # @param cartesia_dictionary_pronunciation_id [String, nil] Optional Cartesia pronunciation dictionary ID to use for this assistant's calls.
+      #
+      # @param custom_tools [Array<Revox::Models::AssistantUpdateParams::CustomTool>, nil] Custom API tools the assistant can call during conversations. Each tool defines
+      #
+      # @param email_notification_address [String, nil] Email address(es) to receive notifications when a call ends with a matching outc
+      #
+      # @param email_notification_language [Symbol, Revox::Models::AssistantUpdateParams::EmailNotificationLanguage] The language used for the notification email content. One of "en" or "fr". Defau
+      #
+      # @param email_notification_outcomes [Array<Symbol, Revox::Models::AssistantUpdateParams::EmailNotificationOutcome>, nil] Which call outcomes trigger an email notification. E.g. ["interested", "complete
+      #
       # @param end_of_call_sentence [String] Optional message to say when the agent decides to end the call.
       #
       # @param faq_items [Array<Revox::Models::AssistantUpdateParams::FaqItem>] FAQ items to associate with this assistant. When provided, replaces all existing
@@ -100,26 +186,64 @@ module Revox
       #
       # @param first_sentence_mode [Symbol, Revox::Models::AssistantUpdateParams::FirstSentenceMode] How the first sentence should be handled. "generated" means the LLM will generat
       #
+      # @param from_phone_number [String, nil] Override the default outbound phone number for calls placed with this assistant.
+      #
+      # @param human_transfer_mode [Symbol, Revox::Models::AssistantUpdateParams::HumanTransferMode, nil] When transfer_phone_number is set: "warm" (AI bridges) or "cold" (SIP REFER; tru
+      #
       # @param ivr_navigation_enabled [Boolean] Enable IVR navigation tools. When enabled, the assistant can send DTMF tones and
       #
-      # @param llm_model [Revox::Models::AssistantUpdateParams::LlmModel::UnionMember0, Revox::Models::AssistantUpdateParams::LlmModel::UnionMember1]
+      # @param llm_model [Revox::Models::AssistantUpdateParams::LlmModel::UnionMember0, Revox::Models::AssistantUpdateParams::LlmModel::UnionMember1, Revox::Models::AssistantUpdateParams::LlmModel::UnionMember2, Revox::Models::AssistantUpdateParams::LlmModel::UnionMember3]
+      #
+      # @param logo_url [String, nil] Public URL of the brand logo shown on the assistant's demo page. Upload a new lo
       #
       # @param max_call_duration_secs [Float] The maximum duration of the call in seconds. This is the maximum time the call w
       #
+      # @param max_duration_end_message [String, nil] Optional message the agent will say, without being interruptible, when the call
+      #
       # @param name [String]
       #
+      # @param position [Revox::Models::AssistantUpdateParams::Position, nil] Canvas position of this assistant's node in its multi-step flow editor.
+      #
       # @param prompt [String] The prompt to use for the call. This will be given to the LLM (gpt-4.1)
       #
+      # @param prompt_flow [Revox::Models::AssistantUpdateParams::PromptFlow, nil] Visual prompt constructor data (nodes, edges, positions). Used by the UI to re-o
+      #
+      # @param slack [Revox::Models::AssistantUpdateParams::Slack, nil] Slack notification config. When set, posts a message to the chosen channel after
+      #
+      # @param sms_enabled [Boolean] Enable SMS tool during calls. When enabled, the agent can send SMS messages to t
+      #
+      # @param sms_template [String, nil] Hardcoded SMS template to send during calls. When set, this exact text is sent i
+      #
       # @param structured_output_config [Array<Revox::Models::AssistantUpdateParams::StructuredOutputConfig>] The structured output config to use for the call. This is used to extract the da
       #
+      # @param structured_output_prompt [String, nil] Custom prompt for structured data extraction. If not provided, a default prompt
+      #
+      # @param stt_context [Revox::Models::AssistantUpdateParams::SttContext, nil] Assistant-level speech-to-text context: structured `general` key/value pairs plu
+      #
+      # @param stt_model [Symbol, Revox::Models::AssistantUpdateParams::SttModel] Transcriber (speech-to-text) model. Defaults to the newest Soniox realtime model
+      #
+      # @param thinking_sound [Symbol, Revox::Models::AssistantUpdateParams::ThinkingSound, nil] Audio clip to play while the agent is processing a response. One of the built-in
+      #
+      # @param thinking_sound_probability [Float] Probability [0..1] that the thinking sound plays on any given turn; otherwise th
+      #
+      # @param thinking_sound_volume [Float] Volume of the thinking sound (0 = silent, 1 = max).
+      #
       # @param transfer_phone_number [String, nil] Phone number to transfer calls to when users request to speak to a human agent i
       #
+      # @param type [Symbol, Revox::Models::AssistantUpdateParams::Type] Assistant kind. 'standalone' (default) is a normal assistant, 'multi-step' orche
+      #
       # @param voice [Revox::Models::AssistantUpdateParams::Voice] The voice to use for the call. You can get the list of voices using the /voices
       #
       # @param voicemail_message [String, nil] If set, when voicemail is detected the agent will speak this message then hang u
       #
+      # @param voicemail_sms_prompt [String, nil] SMS message to send when the call reaches voicemail. Supports {{variable}} place
+      #
+      # @param warm_transfer_summary_instructions [String, nil] When using warm transfer: extra instructions for the supervisor handoff summary.
+      #
       # @param webhook_url [String] The webhook URL to call when the call is completed.
       #
+      # @param zoho [Revox::Models::AssistantUpdateParams::Zoho, nil] Zoho CRM integration config. When set, upserts the prospect (keyed on phone) int
+      #
       # @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Revox::Models::AssistantUpdateResponse]
@@ -136,6 +260,10 @@ module Revox
         )
       end
 
+      # Retrieve all assistants associated with your account. Each assistant in the
+      # response includes its full configuration: prompt, voice settings, and first
+      # sentence. Use this endpoint to list available assistants before placing calls.
+      #
       # @overload list(request_options: {})
       #
       # @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -152,6 +280,10 @@ module Revox
         )
       end
 
+      # Permanently delete an assistant by its ID. Any future calls referencing this
+      # assistant ID will fail. Existing call records that used this assistant are not
+      # affected.
+      #
       # @overload delete(id, request_options: {})
       #
       # @param id [String]

data/lib/revox/resources/call.rb

@@ -6,8 +6,12 @@ module Revox
       # Some parameter documentations has been truncated, see
       # {Revox::Models::CallCreateParams} for more details.
       #
-      # Place a new call order. A call order can be resolved over multiple call attempts
-      # spanning up to a few days.
+      # Place a new outbound call order. Provide either an existing assistant ID or a
+      # custom assistant configuration. The call can be scheduled for a specific time or
+      # started immediately. A single call order may be resolved over multiple call
+      # attempts spanning up to a few days, with automatic retries when voicemail is
+      # detected. You can also set concurrency limits and pass prompt variables for
+      # dynamic personalization.
       #
       # @overload create(phone_number:, assistant: nil, assistant_id: nil, concurrency: nil, force_now: nil, from_phone_number: nil, metadata: nil, prompt_variables: nil, scheduled_at: nil, request_options: {})
       #
@@ -45,7 +49,10 @@ module Revox
         )
       end
 
-      # Get a call order by ID.
+      # Retrieve the full details of a call order by its unique ID. The response
+      # includes the call status, call attempts, transcript, recording URL, timestamps,
+      # and metadata. Use this endpoint to poll for call completion or inspect results
+      # after a call has finished.
       #
       # @overload retrieve(id, request_options: {})
       #
@@ -65,30 +72,6 @@ module Revox
         )
       end
 
-      # Get the list of call orders.
-      #
-      # @overload list(page:, page_size:, request_options: {})
-      #
-      # @param page [Float] The page number you want to get. Starting at 0.
-      #
-      # @param page_size [Float]
-      #
-      # @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [Revox::Models::CallListResponse]
-      #
-      # @see Revox::Models::CallListParams
-      def list(params)
-        parsed, options = Revox::CallListParams.dump_request(params)
-        @client.request(
-          method: :get,
-          path: "call",
-          query: parsed,
-          model: Revox::Models::CallListResponse,
-          options: options
-        )
-      end
-
       # @api private
       #
       # @param client [Revox::Client]