inactive status and is ready to configure and activate.
Endpoint
POST /user/assistant
Engine modes
The assistant supports three engine modes, each with different requirements:Request
Core required fields
Voice ID to use. Use the Get Voices endpoint with the
mode parameter to retrieve voices compatible with your engine mode.Mode-specific fields
LLM model ID. Required for
pipeline mode. Use the Get Models endpoint to retrieve available models.Multimodal model ID. Required for
multimodal and dualplex modes. Use the Get Models endpoint to retrieve available multimodal models.Secondary languages
Additional language IDs the assistant can speak. The assistant auto-detects and switches languages during the call.
Knowledge base
How the assistant uses the knowledge base:
function_call— AI calls a function to search. Required formultimodalanddualplexmodes.prompt— Knowledge is injected into the system prompt. Pipeline mode only.
Phone number
Custom mid-call tools
Built-in tools
Built-in tools to enable on the assistant. Each tool object has a
type and type-specific fields.Voice and TTS settings
Call behavior
Timing
Re-engagement
Voicemail
Endpoint detection
Ambient sound
Webhook configuration
Post-call evaluation
Variables
Conversation ended settings
Minutes of chat inactivity before the conversation is considered ended. Range: 1–1440.
Response
Example
201 Success
422 Validation error
New assistants are created with
inactive status. Activate them through the DialogBot portal or by attaching a phone number and enabling them.