← Back to API Reference
Agents API
Create and configure AI agents with custom voices and personalities.
GET
/agentsList All Agents
Retrieve a list of all AI agents in your organization.
const agents = await client.agents.list();agents.forEach(agent => { console.log(agent.name, agent.voice);});POST
/agentsCreate an Agent
Create a new AI agent with custom configuration.
Request
const agent = await client.agents.create({ name: 'Customer Support Agent', voice: 'elevenlabs:rachel', language: 'en-US', greetingPrompt: 'Hello! How can I help you today?', systemPrompt: 'You are a helpful customer support agent.'});Parameters
| Parameter | Type | Description |
|---|---|---|
| name | string | Agent display name |
| voice | string | Voice ID (e.g., elevenlabs:rachel) |
| language | string | Language code (e.g., en-US, hi-IN) |
| greetingPrompt | string | First message from agent |
| systemPrompt | string | System instructions for AI behavior |
PUT
/agents/:idUpdate an Agent
Update an existing agent's configuration.
await client.agents.update('agent-uuid', { name: 'Updated Agent Name', greetingPrompt: 'Hi there! What can I do for you?'});DELETE
/agents/:idDelete an Agent
Permanently delete an agent.