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"
}