Get assistants

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.

Request

curl -X GET "https://www.getrevox.com/api/assistants" \
  -H "Authorization: Bearer $REVOX_API_KEY"

const res = await fetch("https://www.getrevox.com/api/assistants", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.REVOX_API_KEY}`,
  },
});
const data = await res.json();
console.log(data);

import os

import requests

response = requests.get(
    "https://www.getrevox.com/api/assistants",
    headers={"Authorization": f"Bearer {os.environ['REVOX_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
print(response.json())

Try itSend this request live

Response

Success

{
  "assistants": [
    {
      "id": "3f6c2a1e-8b4d-4c7a-9e2f-5d1b7a9c0e34",
      "prompt": "You are Julie from Acme. You call {{first_name}} to confirm tomorrow's appointment.",
      "post_call_prompt": "Send the appointment address by SMS if asked.",
      "first_sentence": "Hello {{first_name}}, this is Julie from Acme.",
      "first_sentence_mode": "generated",
      "end_of_call_sentence": "Thank you, have a good day.",
      "voice": {
        "provider": "cartesia",
        "id": "4325f426-c4e0-418e-a0e5-97fcdfcdf8e6",
        "speed": 1,
        "volume": 1,
        "model": "sonic-3"
      },
      "voice_languages": [
        {
          "language": "en",
          "voice": {
            "provider": "cartesia",
            "id": "4325f426-c4e0-418e-a0e5-97fcdfcdf8e6",
            "speed": 1,
            "volume": 1,
            "model": "sonic-3"
          }
        }
      ],
      "cartesia_dictionary_pronunciation_id": "6f9a3c1e-2b7d-4e58-9a10-3d2c4b5e6f70",
      "llm_model": { "type": "recommended" },
      "webhook_url": "https://example.com/revox-webhook",
      "max_call_duration_secs": 600,
      "max_duration_end_message": "Thank you, have a good day.",
      "structured_output_config": [
        {
          "name": "budget",
          "type": "string",
          "description": "Books a slot in the agenda.",
          "required": false,
          "enum_options": ["enum option"]
        }
      ],
      "structured_output_prompt": "Send the appointment address by SMS if asked.",
      "call_retry_config": {
        "calling_windows": [
          {
            "calling_window_start_time": "09:00",
            "calling_window_end_time": "18:00",
            "retry_delay_seconds": 7200
          }
        ],
        "max_retry_attempts": 1,
        "allowed_days": [
          "monday",
          "tuesday",
          "wednesday",
          "thursday",
          "friday"
        ],
        "excluded_dates": ["2026-11-05"],
        "call_twice_in_a_row": false
      },
      "timezone": "Europe/Paris",
      "background_sound": "audio/office.ogg",
      "background_sound_volume": 1,
      "thinking_sound": "city-ambience.ogg",
      "thinking_sound_volume": 1,
      "thinking_sound_probability": 0,
      "transfer_destinations": [
        { "label": "Main line", "phone_number": "+33612345678" }
      ],
      "human_transfer_mode": "warm",
      "warm_transfer_summary_instructions": "Send the appointment address by SMS if asked.",
      "warm_transfer_voice_speed": 1,
      "ivr_navigation_enabled": true,
      "voicemail_message": "Thank you, have a good day.",
      "stt_context": {
        "general": [{ "key": "crm_id", "value": "lead_8812" }],
        "terms": ["term"]
      },
      "stt_model": "stt-rt-v4",
      "first_sentence_delay_ms": 400,
      "calendars": [
        {
          "id": "b2d4f6a8-1c3e-4a5b-8d7f-9e0a1b2c3d4e",
          "assistant_id": "3f6c2a1e-8b4d-4c7a-9e2f-5d1b7a9c0e34",
          "handle": "google_calendar_jane_at_example.com",
          "provider": "google-calendar",
          "status": "ready",
          "connection": {
            "provider": "google-calendar",
            "connection_id": "9b8a7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d",
            "settings": {
              "calendar_id": "primary",
              "time_zone": "Europe/Paris",
              "duration_minutes": 30,
              "days": [1, 2, 3, 4, 5],
              "start_time": "09:00",
              "end_time": "18:00",
              "google_meet": false,
              "location": "{{site_address}}"
            }
          },
          "account_label": "Main line",
          "connected_via_invite": false,
          "invite": {
            "url": "https://example.com",
            "status": "completed",
            "created_at": "2026-11-05T09:00:00Z",
            "expires_at": "2026-11-05T09:00:00Z"
          },
          "created_at": "2026-11-05T09:00:00Z"
        }
      ],
      "calendly": null,
      "cal": null,
      "google_calendar": null,
      "hubspot": {
        "connection_id": "9b8a7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d",
        "precall_lookup_enabled": true,
        "meeting_links": [
          {
            "slug": "jane-martin",
            "label": "Main line",
            "duration_ms": 1800000,
            "is_fallback": false,
            "booking_url": "https://example.com"
          }
        ],
        "post_call_sync": {
          "enabled": true,
          "field_mapping": [
            { "source": "email", "hubspot_property": "email" }
          ]
        }
      },
      "slack": {
        "connection_id": "9b8a7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d",
        "channels": [
          {
            "id": "b2d4f6a8-1c3e-4a5b-8d7f-9e0a1b2c3d4e",
            "name": "Appointment reminder"
          }
        ]
      },
      "teams": {
        "connection_id": "9b8a7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d",
        "channels": [
          {
            "id": "b2d4f6a8-1c3e-4a5b-8d7f-9e0a1b2c3d4e",
            "name": "Appointment reminder",
            "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "team_name": "Sales"
          }
        ]
      },
      "zoho": {
        "connection_id": "9b8a7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d",
        "module": "Leads",
        "log_call_activity": false,
        "field_mapping": [
          { "source": "email", "zoho_field": "Email" }
        ],
        "template": "{{outcome}}: {{summary}}\n{{call_url}}"
      },
      "custom_tools": [
        {
          "name": "appointment_reminder",
          "description": "Books a slot in the agenda.",
          "method": "GET",
          "url": "https://example.com",
          "headers": [{ "key": "crm_id", "value": "lead_8812" }],
          "query_params": [
            { "key": "crm_id", "value": "lead_8812" }
          ],
          "body_template": "{\"email\": \"{{email}}\", \"name\": \"{{first_name}}\"}",
          "input_schema": [
            {
              "name": "budget",
              "type": "string",
              "description": "Books a slot in the agenda.",
              "required": false,
              "enum_options": ["enum option"]
            }
          ]
        }
      ],
      "from_phone_number": "+33187654321",
      "demo_page_url": "https://example.com",
      "precall_lookup_url": "https://example.com",
      "precall_lookup_headers": [
        { "key": "crm_id", "value": "lead_8812" }
      ],
      "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "Appointment reminders",
      "is_inbound_receptionist": false,
      "created_by": {
        "id": "5a7c9e1b-3d5f-4a2c-8e6b-0f1a2b3c4d5e",
        "email": "jane@example.com",
        "first_name": "Marie",
        "last_name": "Martin"
      },
      "created_at": "2026-11-05T09:00:00Z",
      "updated_at": "2026-11-05T09:02:41Z"
    }
  ]
}

Request body

No body: send the request without one.

Response

200

assistantsarray of Assistant
The organization's assistants. Steps of multi-step flows (type 'sub-assistant') are not listed.