Agents API

GET /api/developer/v1/agents X-API-Key

List agents

POST /api/developer/v1/agents X-API-Key

Create an agent

GET /api/developer/v1/agents/{agent_id} X-API-Key

Get an agent

PUT /api/developer/v1/agents/{agent_id} X-API-Key

Update an agent

DELETE /api/developer/v1/agents/{agent_id} X-API-Key

Delete an agent

PATCH /api/developer/v1/agents/{agent_id}/toggle X-API-Key

Activate or deactivate an agent

Create fields

Only name is required. Common optional fields are phone_number_id, tts_provider, voice, tts_language, greeting_line, agent_prompt, analysis_prompt, transcription_languages, knowledge_base_ids, interruptions_enabled, background_music_enabled, and the hard call-duration limit.

curl -X POST https://api.vaniagent.com/api/developer/v1/agents \
  -H "X-API-Key: $VANIAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Demo qualification agent",
    "greeting_line": "Hello, I am calling from Acme about your enquiry.",
    "tts_language": "en",
    "agent_prompt": "Qualify the lead and offer a callback. Never invent pricing.",
    "interruptions_enabled": true
  }'

Provider and voice availability are account-dependent. Use the dashboard to discover and audition valid combinations before automating creation.