---
title: Agents API
description: Create, inspect, update, activate, and delete voice agents.
---

import Endpoint from '../../../components/Endpoint.astro';

<Endpoint method="GET" path="/api/developer/v1/agents" title="List agents" />
<Endpoint method="POST" path="/api/developer/v1/agents" title="Create an agent" />
<Endpoint method="GET" path="/api/developer/v1/agents/{agent_id}" title="Get an agent" />
<Endpoint method="PUT" path="/api/developer/v1/agents/{agent_id}" title="Update an agent" />
<Endpoint method="DELETE" path="/api/developer/v1/agents/{agent_id}" title="Delete an agent" />
<Endpoint method="PATCH" path="/api/developer/v1/agents/{agent_id}/toggle" title="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.

```bash
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.