latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-15394599.9 KB

58dc5cff0ca7

Agents

Create an agent

Creates a new voice AI agent.

Note: first_message and auto_first_message are mutually exclusive. Providing both returns a 400 error.

post/v2/agents

Request body

namestring required

promptstring required

first_messagestring

Cannot be combined with auto_first_message: true.

auto_first_messageboolean

Cannot be combined with first_message.

knowledge_base_idinteger

voice_provider'OpenAI' | 'ElevenLabs' | 'Deepgram' | 'Cartesia'

voicestring

voice_modelstring

voice_speednumber

llm_model_namestring

llm_model_temperaturenumber

llm_max_tokensinteger

stt_provider'Deepgram'

stt_modelstring

auto_end_callboolean

boosted_keywordsstring[]

selected_jargonsstring[]

Response

Agent created.

uidstring required

Unique agent identifier (slug/UUID).