← Back to API Reference

Agents API

Create and configure AI agents with custom voices and personalities.

GET/agents

List All Agents

Retrieve a list of all AI agents in your organization.

javascript
const agents = await client.agents.list();
agents.forEach(agent => {
console.log(agent.name, agent.voice);
});
POST/agents

Create an Agent

Create a new AI agent with custom configuration.

Request

javascript
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

ParameterTypeDescription
namestringAgent display name
voicestringVoice ID (e.g., elevenlabs:rachel)
languagestringLanguage code (e.g., en-US, hi-IN)
greetingPromptstringFirst message from agent
systemPromptstringSystem instructions for AI behavior
PUT/agents/:id

Update an Agent

Update an existing agent's configuration.

javascript
await client.agents.update('agent-uuid', {
name: 'Updated Agent Name',
greetingPrompt: 'Hi there! What can I do for you?'
});
DELETE/agents/:id

Delete an Agent

Permanently delete an agent.