revox 0.1.0 → 0.3.0

data/lib/revox/resources/assistants.rb

@@ -12,18 +12,34 @@ module Revox
       # 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:, 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: {})
+      # @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 calendly [Revox::Models::AssistantCreateParams::Calendly]
+      # @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
@@ -34,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]
@@ -96,16 +150,32 @@ module Revox
       # the prompt, voice, first sentence, name, or any other assistant property without
       # affecting the rest of the configuration.
       #
-      # @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: {})
+      # @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 calendly [Revox::Models::AssistantUpdateParams::Calendly]
+      # @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
@@ -116,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]
@@ -193,6 +301,27 @@ module Revox
         )
       end
 
+      # Create a full copy of an existing assistant, including every configuration field
+      # and FAQ items. The new assistant has the same configuration as the source, with
+      # the name suffixed by "(Copy)" and a freshly generated API key.
+      #
+      # @overload clone_(id, request_options: {})
+      #
+      # @param id [String]
+      # @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Revox::Models::AssistantCloneResponse]
+      #
+      # @see Revox::Models::AssistantCloneParams
+      def clone_(id, params = {})
+        @client.request(
+          method: :post,
+          path: ["assistants/%1$s/clone", id],
+          model: Revox::Models::AssistantCloneResponse,
+          options: params[:request_options]
+        )
+      end
+
       # @api private
       #
       # @param client [Revox::Client]

data/lib/revox/resources/auth_status.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Revox
+  module Resources
+    class AuthStatus
+      # Check if your API key is still valid.
+      #
+      # @overload retrieve(request_options: {})
+      #
+      # @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Revox::Models::AuthStatusRetrieveResponse]
+      #
+      # @see Revox::Models::AuthStatusRetrieveParams
+      def retrieve(params = {})
+        @client.request(
+          method: :get,
+          path: "auth-status",
+          model: Revox::Models::AuthStatusRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Revox::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/revox/resources/call.rb

@@ -72,31 +72,147 @@ module Revox
         )
       end
 
-      # Retrieve a paginated list of call attempts. Each entry includes the call status,
-      # phone number, assistant used, transcript, and timestamps. Use the page and
-      # page_size query parameters to navigate through results.
+      # Cancel a running or scheduled call.
       #
-      # @overload list(page:, page_size:, statuses: nil, request_options: {})
+      # @overload cancel(id, request_options: {})
       #
-      # @param page [Integer] The page number you want to get. Starting at 0.
+      # @param id [String]
+      # @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @param page_size [Integer] The number of calls to return per page.
+      # @return [Revox::Models::CallCancelResponse]
       #
-      # @param statuses [Array<Symbol, Revox::Models::CallListParams::Status>]
+      # @see Revox::Models::CallCancelParams
+      def cancel(id, params = {})
+        @client.request(
+          method: :post,
+          path: ["call/%1$s/cancel", id],
+          model: Revox::Models::CallCancelResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Revox::Models::CallExportParams} for more details.
+      #
+      # Export a list of call attempts as a CSV file.
+      #
+      # @overload export(filters:, include_metadata: nil, include_structured_output_fields: nil, request_options: {})
+      #
+      # @param filters [Revox::Models::CallExportParams::Filters]
+      #
+      # @param include_metadata [Boolean] Whether to include the metadata in the CSV file. These are the fields you (optio
+      #
+      # @param include_structured_output_fields [Boolean] Whether to include the structured output fields in the CSV file. These are gener
       #
       # @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Revox::Models::CallListResponse]
+      # @return [Revox::Models::CallExportResponse]
       #
-      # @see Revox::Models::CallListParams
-      def list(params)
-        parsed, options = Revox::CallListParams.dump_request(params)
-        query = Revox::Internal::Util.encode_query_params(parsed)
+      # @see Revox::Models::CallExportParams
+      def export(params)
+        parsed, options = Revox::CallExportParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "call/export",
+          body: parsed,
+          model: Revox::Models::CallExportResponse,
+          options: options
+        )
+      end
+
+      # Pause a call's retry loop. The current in-progress attempt (if any) will finish,
+      # but no new attempts will be started until the call is resumed.
+      #
+      # @overload pause(id, request_options: {})
+      #
+      # @param id [String]
+      # @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Revox::Models::CallPauseResponse]
+      #
+      # @see Revox::Models::CallPauseParams
+      def pause(id, params = {})
+        @client.request(
+          method: :post,
+          path: ["call/%1$s/pause", id],
+          model: Revox::Models::CallPauseResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Returns a map of phone numbers to the number of calls and associated campaigns
+      # across the entire organization. Useful for detecting contacts that have already
+      # been reached.
+      #
+      # @overload phone_history(request_options: {})
+      #
+      # @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Revox::Models::CallPhoneHistoryResponse]
+      #
+      # @see Revox::Models::CallPhoneHistoryParams
+      def phone_history(params = {})
         @client.request(
           method: :get,
-          path: "call",
-          query: query,
-          model: Revox::Models::CallListResponse,
+          path: "calls/phone-history",
+          model: Revox::Models::CallPhoneHistoryResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Resume a previously paused call. The retry loop will continue from where it left
+      # off.
+      #
+      # @overload resume(id, request_options: {})
+      #
+      # @param id [String]
+      # @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Revox::Models::CallResumeResponse]
+      #
+      # @see Revox::Models::CallResumeParams
+      def resume(id, params = {})
+        @client.request(
+          method: :post,
+          path: ["call/%1$s/resume", id],
+          model: Revox::Models::CallResumeResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Retrieve a paginated list of call attempts. Each entry includes the call status,
+      # phone number, assistant used, transcript, and timestamps. Use the page and
+      # page_size query parameters to navigate through results.
+      #
+      # @overload search(assignee_ids:, assistant_ids:, campaign_ids:, directions:, from_phone_numbers:, outcomes:, page:, page_size:, results:, statuses:, call_ids: nil, query: nil, sort_by: nil, sort_direction: nil, to_phone_number: nil, request_options: {})
+      #
+      # @param assignee_ids [Array<String>]
+      # @param assistant_ids [Array<String>]
+      # @param campaign_ids [Array<String>]
+      # @param directions [Array<Symbol, Revox::Models::CallSearchParams::Direction>]
+      # @param from_phone_numbers [Array<String>]
+      # @param outcomes [Array<Symbol, Revox::Models::CallSearchParams::Outcome>]
+      # @param page [Integer]
+      # @param page_size [Integer]
+      # @param results [Array<Symbol, Revox::Models::CallSearchParams::Result>]
+      # @param statuses [Array<Symbol, Revox::Models::CallSearchParams::Status>]
+      # @param call_ids [Array<String>]
+      # @param query [String]
+      # @param sort_by [String]
+      # @param sort_direction [Symbol, Revox::Models::CallSearchParams::SortDirection]
+      # @param to_phone_number [String]
+      # @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Revox::Models::CallSearchResponse]
+      #
+      # @see Revox::Models::CallSearchParams
+      def search(params)
+        parsed, options = Revox::CallSearchParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "call/search",
+          body: parsed,
+          model: Revox::Models::CallSearchResponse,
           options: options
         )
       end

data/lib/revox/resources/campaigns.rb

@@ -6,18 +6,21 @@ module Revox
       # Some parameter documentations has been truncated, see
       # {Revox::Models::CampaignCreateParams} for more details.
       #
-      # Create a new outbound calling campaign and launch it immediately. If
-      # scheduled_at is set, all calls will be queued until the specified time instead
-      # of starting right away.
+      # Create a new outbound calling campaign. By default the campaign launches
+      # immediately. Set launch to false to save as a draft for later review.
       #
-      # @overload create(assistant_id:, contacts:, name:, call_retry_config: nil, from_phone_number: nil, max_concurrent_calls: nil, scheduled_at: nil, request_options: {})
+      # @overload create(assistant_id:, contacts:, launch:, name:, type:, call_retry_config: nil, from_phone_number: nil, max_concurrent_calls: nil, scheduled_at: nil, request_options: {})
       #
       # @param assistant_id [String] The ID of the assistant to use
       #
       # @param contacts [Array<Revox::Models::CampaignCreateParams::Contact>] The list of contacts to call
       #
+      # @param launch [Boolean] Whether to launch the campaign immediately. Set to false to save as a draft.
+      #
       # @param name [String] The name of the campaign
       #
+      # @param type [Symbol, Revox::Models::CampaignCreateParams::Type] Campaign type. 'jump_in' campaigns only dial while someone is on the campaign pa
+      #
       # @param call_retry_config [Revox::Models::CampaignCreateParams::CallRetryConfig] Override retry configuration for calls in this campaign. If not provided, uses t
       #
       # @param from_phone_number [String] The phone number to use for outbound calls (E.164 format, e.g., +1234567890)
@@ -62,6 +65,49 @@ module Revox
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Revox::Models::CampaignUpdateParams} for more details.
+      #
+      # Update editable fields on a campaign. Draft campaigns support updating all
+      # fields including assistant, contacts, and settings. Non-draft campaigns only
+      # support renaming.
+      #
+      # @overload update(id, assistant_id: nil, call_retry_config: nil, contacts: nil, from_phone_number: nil, max_concurrent_calls: nil, name: nil, scheduled_at: nil, type: nil, request_options: {})
+      #
+      # @param id [String]
+      #
+      # @param assistant_id [String] The ID of the assistant to use (draft only)
+      #
+      # @param call_retry_config [Revox::Models::CampaignUpdateParams::CallRetryConfig, nil] Configuration for call retry behavior including time windows, delays, and max it
+      #
+      # @param contacts [Array<Revox::Models::CampaignUpdateParams::Contact>] Replace contact list (draft only)
+      #
+      # @param from_phone_number [String, nil] The phone number to use for outbound calls (draft only)
+      #
+      # @param max_concurrent_calls [Float, nil] Maximum concurrent calls (draft only)
+      #
+      # @param name [String] Campaign display name
+      #
+      # @param scheduled_at [Time, Object, nil] Scheduled start time (draft only)
+      #
+      # @param type [Symbol, Revox::Models::CampaignUpdateParams::Type] Campaign type (draft only)
+      #
+      # @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Revox::Models::CampaignUpdateResponse]
+      #
+      # @see Revox::Models::CampaignUpdateParams
+      def update(id, params = {})
+        parsed, options = Revox::CampaignUpdateParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["campaigns/%1$s", id],
+          body: parsed,
+          model: Revox::Models::CampaignUpdateResponse,
+          options: options
+        )
+      end
+
       # Retrieve all campaigns for your organization, including both active and
       # completed ones.
       #
@@ -142,31 +188,111 @@ module Revox
         )
       end
 
-      # Retrieve a paginated list of rows (contacts) for a given campaign. Supports
-      # filtering by text query, call statuses, and call result.
+      # Retrieve all contact rows for a campaign. Useful for loading draft campaign data
+      # for editing.
       #
-      # @overload get_rows(id, page:, page_size:, query: nil, result: nil, statuses: nil, request_options: {})
+      # @overload get_rows(id, request_options: {})
       #
       # @param id [String]
-      # @param page [Float]
-      # @param page_size [Float]
-      # @param query [String]
-      # @param result [Symbol, Revox::Models::CampaignGetRowsParams::Result]
-      # @param statuses [String]
       # @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Revox::Models::CampaignGetRowsResponse]
       #
       # @see Revox::Models::CampaignGetRowsParams
-      def get_rows(id, params)
-        parsed, options = Revox::CampaignGetRowsParams.dump_request(params)
-        query = Revox::Internal::Util.encode_query_params(parsed)
+      def get_rows(id, params = {})
         @client.request(
           method: :get,
           path: ["campaigns/%1$s/rows", id],
-          query: query,
           model: Revox::Models::CampaignGetRowsResponse,
-          options: options
+          options: params[:request_options]
+        )
+      end
+
+      # Launch a previously saved draft campaign. This starts all calls immediately (or
+      # queues them if scheduled_at is set). The campaign must be in draft status.
+      #
+      # @overload launch(id, request_options: {})
+      #
+      # @param id [String]
+      # @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Revox::Models::CampaignLaunchResponse]
+      #
+      # @see Revox::Models::CampaignLaunchParams
+      def launch(id, params = {})
+        @client.request(
+          method: :post,
+          path: ["campaigns/%1$s/launch", id],
+          model: Revox::Models::CampaignLaunchResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Pause a running campaign so no further calls are placed. In-progress calls are
+      # allowed to finish; pending and scheduled calls are held until the campaign is
+      # resumed. Scheduled retry timers keep counting down, so a call resumed before its
+      # time fires on schedule, while one resumed after its time fires at the next
+      # available calling window.
+      #
+      # @overload pause(id, request_options: {})
+      #
+      # @param id [String]
+      # @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Revox::Models::CampaignPauseResponse]
+      #
+      # @see Revox::Models::CampaignPauseParams
+      def pause(id, params = {})
+        @client.request(
+          method: :post,
+          path: ["campaigns/%1$s/pause", id],
+          model: Revox::Models::CampaignPauseResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Resume a paused campaign. Held calls continue from where they left off; calls
+      # whose scheduled time passed during the pause are placed at the next available
+      # calling window.
+      #
+      # @overload resume(id, request_options: {})
+      #
+      # @param id [String]
+      # @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Revox::Models::CampaignResumeResponse]
+      #
+      # @see Revox::Models::CampaignResumeParams
+      def resume(id, params = {})
+        @client.request(
+          method: :post,
+          path: ["campaigns/%1$s/resume", id],
+          model: Revox::Models::CampaignResumeResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Retrieve the "Statistiques" report for a campaign: the four-tile cascade funnel
+      # (appelés → eus en ligne → réels échanges → leads chauds), two secondary tiles,
+      # the distribution of exchanges by outcome, the list of hot leads, and
+      # data-extraction coverage. All counts are over distinct E.164-normalized phone
+      # numbers, and the outcome-based categories derive exclusively from calls.outcome.
+      # Cascade percentages are null when their denominator is zero.
+      #
+      # @overload statistics(id, request_options: {})
+      #
+      # @param id [String]
+      # @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Revox::Models::CampaignStatisticsResponse]
+      #
+      # @see Revox::Models::CampaignStatisticsParams
+      def statistics(id, params = {})
+        @client.request(
+          method: :get,
+          path: ["campaigns/%1$s/statistics", id],
+          model: Revox::Models::CampaignStatisticsResponse,
+          options: params[:request_options]
         )
       end