Get assistant by ID
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.
Returns
Prompt / instructions for the after-call SMS. Supports {{variable}} placeholders. When null, no after-call SMS is sent.
Ambient background sound to play during the call. null disables it.
Volume of the ambient background sound (0 = silent, 1 = max).
Optional Cartesia pronunciation dictionary ID linked to this assistant.
Email address(es) to receive notifications when a call ends with a matching outcome. Accepts a single email or a comma-separated list (e.g. “alice@x.com, bob@y.com”).
Delay in milliseconds before speaking the first sentence. Default: 400.
Override the default outbound phone number for calls placed with this assistant. When null, the organization’s default phone number is used.
The maximum duration of the call in seconds. This is the maximum time the call will be allowed to run.
Optional message the agent will say, without being interruptible, when the call reaches its max duration. Kept short so it fits inside the farewell buffer. If null, the call ends silently.
URL fetched before an inbound call is answered to resolve the assistant’s prompt variables. Null when no lookup is configured.
Enable SMS tool during calls. When enabled, the agent can send SMS messages to the user on the call.
Hardcoded SMS template to send during calls. When set, this exact text is sent instead of letting the agent generate the message. Supports {{variable}} placeholders.
Custom prompt for structured data extraction. If not provided, a default prompt is used. Available variables: {{transcript}}, {{call_direction}}, {{user_phone_number}}, {{agent_phone_number}}.
Probability [0..1] that the thinking sound plays on any given turn; otherwise the agent is silent while thinking.
If set, when voicemail is detected the agent will speak this message then hang up; if null, hang up immediately.
Prompt / instructions for the voicemail SMS. Supports {{variable}} placeholders. When null, no SMS is sent on voicemail.
Get assistant by ID
curl https://www.getrevox.com/api/assistants/$ID \
-H "Authorization: Bearer $REVOX_API_KEY"{
"id": "id",
"after_call_sms_outcomes": [
"not_interested"
],
"after_call_sms_prompt": "after_call_sms_prompt",
"background_sound": "audio/office.ogg",
"background_sound_volume": 0,
"calendly": {
"connection_id": "connection_id",
"event_type_id": "event_type_id"
},
"call_retry_config": {
"allowed_days": [
"monday"
],
"call_twice_in_a_row": true,
"calling_windows": [
{
"calling_window_end_time": "calling_window_end_time",
"calling_window_start_time": "calling_window_start_time",
"retry_delay_seconds": 0
}
],
"max_retry_attempts": 1,
"timezone": "timezone"
},
"cartesia_dictionary_pronunciation_id": "cartesia_dictionary_pronunciation_id",
"created_at": {},
"custom_tools": [
{
"body_template": "body_template",
"description": "x",
"headers": [
{
"key": "x",
"value": "value"
}
],
"input_schema": [
{
"name": "x",
"required": true,
"type": "string",
"description": "description",
"enum_options": [
"string"
]
}
],
"method": "GET",
"name": "name",
"query_params": [
{
"key": "x",
"value": "value"
}
],
"url": "x"
}
],
"email_notification_address": "email_notification_address",
"email_notification_outcomes": [
"not_interested"
],
"end_of_call_sentence": "end_of_call_sentence",
"first_sentence": "first_sentence",
"first_sentence_delay_ms": -9007199254740991,
"first_sentence_mode": "generated",
"from_phone_number": "from_phone_number",
"hubspot": {
"connection_id": "connection_id",
"meeting_links": [
{
"booking_url": "booking_url",
"duration_ms": 1,
"is_fallback": true,
"label": "x",
"slug": "x"
}
],
"precall_lookup_enabled": true
},
"human_transfer_mode": "warm",
"ivr_navigation_enabled": true,
"llm_model": {
"name": "gpt-4.1",
"type": "dedicated-instance"
},
"logo_url": "logo_url",
"max_call_duration_secs": 0,
"max_duration_end_message": "max_duration_end_message",
"name": "name",
"organization_id": "organization_id",
"position": {
"x": 0,
"y": 0
},
"precall_lookup_url": "precall_lookup_url",
"prompt": "prompt",
"prompt_flow": {
"edges": [
{
"id": "id",
"source": "source",
"target": "target"
}
],
"nodes": [
{
"id": "id",
"data": {
"body": "body",
"title": "title"
},
"position": {
"x": 0,
"y": 0
},
"type": "promptBlock"
}
]
},
"slack": {
"channels": [
{
"id": "id",
"name": "name"
}
],
"connection_id": "connection_id",
"outcomes": [
"not_interested"
],
"template": "template"
},
"sms_enabled": true,
"sms_template": "sms_template",
"structured_output_config": [
{
"name": "x",
"required": true,
"type": "string",
"description": "description",
"enum_options": [
"string"
]
}
],
"structured_output_prompt": "structured_output_prompt",
"stt_context": {
"general": [
{
"key": "x",
"value": "x"
}
],
"terms": [
"x"
]
},
"stt_model": "stt-rt-v4",
"thinking_sound": "city-ambience.ogg",
"thinking_sound_probability": 0,
"thinking_sound_volume": 0,
"transfer_destinations": [
{
"label": "x",
"phone_number": "phone_number"
}
],
"type": "standalone",
"updated_at": {},
"voice": {
"id": "x",
"provider": "cartesia",
"model": "sonic-3",
"speed": 0.6,
"volume": 0.5
},
"voicemail_message": "voicemail_message",
"voicemail_sms_prompt": "voicemail_sms_prompt",
"warm_transfer_summary_instructions": "warm_transfer_summary_instructions",
"webhook_url": "webhook_url",
"zoho": {
"connection_id": "connection_id",
"field_mapping": [
{
"source": "x",
"zoho_field": "x"
}
],
"log_call_activity": true,
"module": "x",
"outcomes": [
"not_interested"
],
"template": "template"
},
"created_by": {
"id": "id",
"email": "email",
"first_name": "first_name",
"last_name": "last_name"
},
"faq_items": [
{
"answer": "answer",
"question": "question",
"id": "id",
"needs_human_answer": true,
"source": "human"
}
],
"is_inbound_receptionist": true,
"is_realestate_assistant": true,
"pending_faq_count": 0
}Returns Examples
{
"id": "id",
"after_call_sms_outcomes": [
"not_interested"
],
"after_call_sms_prompt": "after_call_sms_prompt",
"background_sound": "audio/office.ogg",
"background_sound_volume": 0,
"calendly": {
"connection_id": "connection_id",
"event_type_id": "event_type_id"
},
"call_retry_config": {
"allowed_days": [
"monday"
],
"call_twice_in_a_row": true,
"calling_windows": [
{
"calling_window_end_time": "calling_window_end_time",
"calling_window_start_time": "calling_window_start_time",
"retry_delay_seconds": 0
}
],
"max_retry_attempts": 1,
"timezone": "timezone"
},
"cartesia_dictionary_pronunciation_id": "cartesia_dictionary_pronunciation_id",
"created_at": {},
"custom_tools": [
{
"body_template": "body_template",
"description": "x",
"headers": [
{
"key": "x",
"value": "value"
}
],
"input_schema": [
{
"name": "x",
"required": true,
"type": "string",
"description": "description",
"enum_options": [
"string"
]
}
],
"method": "GET",
"name": "name",
"query_params": [
{
"key": "x",
"value": "value"
}
],
"url": "x"
}
],
"email_notification_address": "email_notification_address",
"email_notification_outcomes": [
"not_interested"
],
"end_of_call_sentence": "end_of_call_sentence",
"first_sentence": "first_sentence",
"first_sentence_delay_ms": -9007199254740991,
"first_sentence_mode": "generated",
"from_phone_number": "from_phone_number",
"hubspot": {
"connection_id": "connection_id",
"meeting_links": [
{
"booking_url": "booking_url",
"duration_ms": 1,
"is_fallback": true,
"label": "x",
"slug": "x"
}
],
"precall_lookup_enabled": true
},
"human_transfer_mode": "warm",
"ivr_navigation_enabled": true,
"llm_model": {
"name": "gpt-4.1",
"type": "dedicated-instance"
},
"logo_url": "logo_url",
"max_call_duration_secs": 0,
"max_duration_end_message": "max_duration_end_message",
"name": "name",
"organization_id": "organization_id",
"position": {
"x": 0,
"y": 0
},
"precall_lookup_url": "precall_lookup_url",
"prompt": "prompt",
"prompt_flow": {
"edges": [
{
"id": "id",
"source": "source",
"target": "target"
}
],
"nodes": [
{
"id": "id",
"data": {
"body": "body",
"title": "title"
},
"position": {
"x": 0,
"y": 0
},
"type": "promptBlock"
}
]
},
"slack": {
"channels": [
{
"id": "id",
"name": "name"
}
],
"connection_id": "connection_id",
"outcomes": [
"not_interested"
],
"template": "template"
},
"sms_enabled": true,
"sms_template": "sms_template",
"structured_output_config": [
{
"name": "x",
"required": true,
"type": "string",
"description": "description",
"enum_options": [
"string"
]
}
],
"structured_output_prompt": "structured_output_prompt",
"stt_context": {
"general": [
{
"key": "x",
"value": "x"
}
],
"terms": [
"x"
]
},
"stt_model": "stt-rt-v4",
"thinking_sound": "city-ambience.ogg",
"thinking_sound_probability": 0,
"thinking_sound_volume": 0,
"transfer_destinations": [
{
"label": "x",
"phone_number": "phone_number"
}
],
"type": "standalone",
"updated_at": {},
"voice": {
"id": "x",
"provider": "cartesia",
"model": "sonic-3",
"speed": 0.6,
"volume": 0.5
},
"voicemail_message": "voicemail_message",
"voicemail_sms_prompt": "voicemail_sms_prompt",
"warm_transfer_summary_instructions": "warm_transfer_summary_instructions",
"webhook_url": "webhook_url",
"zoho": {
"connection_id": "connection_id",
"field_mapping": [
{
"source": "x",
"zoho_field": "x"
}
],
"log_call_activity": true,
"module": "x",
"outcomes": [
"not_interested"
],
"template": "template"
},
"created_by": {
"id": "id",
"email": "email",
"first_name": "first_name",
"last_name": "last_name"
},
"faq_items": [
{
"answer": "answer",
"question": "question",
"id": "id",
"needs_human_answer": true,
"source": "human"
}
],
"is_inbound_receptionist": true,
"is_realestate_assistant": true,
"pending_faq_count": 0
}