## List

`assistants.list() -> AssistantListResponse`

**get** `/assistants`

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.

### Returns

- `class AssistantListResponse`

  - `assistants: Array[{ id, background_sound, calendly, 20 more}]`

    - `id: String`

    - `background_sound: :"audio/office.ogg"`

      The background sound to play during the call. Useful to give the impression that your AI agent is in an office.

      - `:"audio/office.ogg"`

    - `calendly: { connection_id, event_type_id}`

      - `connection_id: String`

        The connection ID representing the link between your Calendly account and Revox.

      - `event_type_id: String`

        The event type ID representing the event type to schedule. (eg: https://api.calendly.com/event_types/b2330295-2a91-4a1d-bb73-99e7707663d5)

    - `call_retry_config: { calling_windows, max_retry_attempts, timezone}`

      Configuration for call retry behavior including time windows, delays, and max iterations. If not provided, defaults will be used.

      - `calling_windows: Array[{ calling_window_end_time, calling_window_start_time, retry_delay_seconds}]`

        - `calling_window_end_time: String`

          End time for the calling window in the recipient's timezone (or timezone_override if provided). Format: 'HH:mm' (24-hour) or 'H:mma' (12-hour). Examples: '17:00', '6pm'. Default: '18:00'.

        - `calling_window_start_time: String`

          Start time for the calling window in the recipient's timezone (or timezone_override if provided). Format: 'HH:mm' (24-hour) or 'H:mma' (12-hour). Examples: '09:00', '10am'. Default: '10:00'.

        - `retry_delay_seconds: Integer`

          Delay between retry attempts in seconds. Default: 7200 (2 hours).

      - `max_retry_attempts: Integer`

        Maximum number of call retry attempts. Default: 3.

      - `timezone: String`

        Optional IANA timezone identifier to override the automatic timezone detection from phone number. If not provided, timezone is determined from the recipient's phone number country code. Examples: 'America/New_York', 'Europe/Paris'.

    - `created_at: untyped`

    - `end_of_call_sentence: String`

    - `first_sentence: String`

    - `first_sentence_delay_ms: Integer`

      Delay in milliseconds before speaking the first sentence. Default: 400.

    - `first_sentence_mode: :generated | :static | :none`

      - `:generated`

      - `:static`

      - `:none`

    - `ivr_navigation_enabled: bool`

      Enable IVR navigation tools. When enabled, the assistant can send DTMF tones and skip turns to navigate phone menus.

    - `llm_model: { name, type} | { openrouter_model_id, openrouter_provider, type}`

      - `class UnionMember0`

        - `name: :"gpt-4.1" | :"ministral-3-8b-instruct"`

          - `:"gpt-4.1"`

          - `:"ministral-3-8b-instruct"`

        - `type: :"dedicated-instance"`

          - `:"dedicated-instance"`

      - `class UnionMember1`

        - `openrouter_model_id: String`

          The model ID to use from OpenRouter. eg: openai/gpt-4.1

        - `openrouter_provider: String`

          The provider to use from OpenRouter. eg: nebius, openai, azure, etc.

        - `type: :openrouter`

          Use a model from OpenRouter.

          - `:openrouter`

    - `max_call_duration_secs: Float`

      The maximum duration of the call in seconds. This is the maximum time the call will be allowed to run.

    - `name: String`

    - `organization_id: String`

    - `prompt: String`

    - `structured_output_config: Array[{ name, required, type, 2 more}]`

      The structured output config to use for the call. This is used to extract the data from the call (like email, name, company name, etc.).

      - `name: String`

      - `required: bool`

      - `type: :string | :number | :boolean | 3 more`

        - `:string`

        - `:number`

        - `:boolean`

        - `:enum`

        - `:date`

        - `:datetime`

      - `description: String`

      - `enum_options: Array[String]`

    - `transfer_phone_number: String`

      Phone number to transfer calls to when users request to speak to a human agent.

    - `updated_at: untyped`

    - `voice: { id, provider, speed}`

      - `id: String`

        The ID of the voice.

      - `provider: :cartesia | :elevenlabs`

        The provider of the voice.

        - `:cartesia`

        - `:elevenlabs`

      - `speed: Float`

        The speed of the voice. Range depends on provider: Cartesia 0.6–1.5, ElevenLabs 0.7–1.2. Default is 1.0.

    - `voicemail_message: String`

      If set, when voicemail is detected the agent will speak this message then hang up; if null, hang up immediately.

    - `webhook_url: String`

      The webhook URL to call when the call is completed.

    - `faq_items: Array[{ answer, question, id, 2 more}]`

      - `answer: String`

      - `question: String`

      - `id: String`

      - `needs_human_answer: bool`

      - `source: :human | :ai`

        - `:human`

        - `:ai`

    - `pending_faq_count: Float`

### Example

```ruby
require "revox"

revox = Revox::Client.new(api_key: "My API Key")

assistants = revox.assistants.list

puts(assistants)
```