Skip to main content
GET
/
v1
/
assistants
/
{id}
curl https://api.vozagent.ai/v1/assistants/a1b2c3d4... \
  -H "Authorization: Bearer <token>"

{
  "id": "a1b2c3d4-e5f6-a7b8-c9d0-e1f2a3b4c5d6",
  "name": "Inbound Receptionist",
  "role": "receptionist",
  "assistant_type": "inbound",
  "is_active": true,
  "voice_id": "sarah",
  "first_message": "Hello! Thanks for calling Acme Outdoor Living. How can I help you today?",
  "first_message_mode": "assistant-speaks-first",
  "personality": "friendly, professional",
  "phone_number_id": "pn-a1b2c3d4",
  "vapi_assistant_id": "vapi-xyz123",
  "system_prompt": "You are a helpful receptionist...",
  "template_id": "tpl-inbound-001",
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z"
}
Retrieve your API Key from your VozAgent Dashboard.

​
Path parameters

​
id
string
required
The unique identifier of the assistant to retrieve.

​
Response

Returns the full assistant object with all configuration details including system prompt and voice settings. 
curl https://api.vozagent.ai/v1/assistants/a1b2c3d4... \
  -H "Authorization: Bearer <token>"

{
  "id": "a1b2c3d4-e5f6-a7b8-c9d0-e1f2a3b4c5d6",
  "name": "Inbound Receptionist",
  "role": "receptionist",
  "assistant_type": "inbound",
  "is_active": true,
  "voice_id": "sarah",
  "first_message": "Hello! Thanks for calling Acme Outdoor Living. How can I help you today?",
  "first_message_mode": "assistant-speaks-first",
  "personality": "friendly, professional",
  "phone_number_id": "pn-a1b2c3d4",
  "vapi_assistant_id": "vapi-xyz123",
  "system_prompt": "You are a helpful receptionist...",
  "template_id": "tpl-inbound-001",
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z"
}