Agents - Vistrow Voice

List agents

curl https://app.vistrowvoice.com/api/agents \
  -H "X-Api-Key: YOUR_API_KEY"

GET /agents — returns every agent on your account as a JSON array.

Create an agent

curl -X POST https://app.vistrowvoice.com/api/agents \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sales Agent",
    "description": "Qualifies inbound leads",
    "model": "gpt-4.1",
    "voice": "shubh",
    "language": "hi-IN",
    "systemPrompt": "You are a helpful sales assistant for Acme Corp."
  }'

POST /agents

Field	Type	Default	Notes
`name`	string	`"Unnamed agent"`
`description`	string	`""`
`model`	string	`"gpt-4.1"`
`voice`	string	`"shubh"`	Preview/next-generation voices are restricted to the platform’s own account.
`language`	string	`"hi-IN"`	Default reply language before any switching.
`systemPrompt`	string	`""`	Leave blank for the built-in generic assistant prompt.

Update an agent

curl -X PATCH https://app.vistrowvoice.com/api/agents/AGENT_ID \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Renamed Agent"}'

PATCH /agents/{agentId} — send only the fields you want to change. Returns 404 if the agent doesn’t exist on your account.

Delete an agent

curl -X DELETE https://app.vistrowvoice.com/api/agents/AGENT_ID \
  -H "X-Api-Key: YOUR_API_KEY"

DELETE /agents/{agentId}