Overview
The Agents API allows you to create, manage, and configure voice agents. Agents are the core entities that handle voice conversations and can be customized with various settings, tools, and integrations.Key Features
- Create and manage voice agents
- Configure conversation settings and platform preferences
- Manage agent tools (client tools, webhooks, integrations)
- Publish and version agents
- Associate phone numbers with agents
Common Use Cases
Create an Agent
Use the
POST /agents endpoint to create a new voice agent with custom configuration.List Agents
Use the
GET /agents endpoint to retrieve all your agents with optional search and pagination.Update Agent
Use the
PUT /agents/{id} endpoint to update agent settings and configuration.Delete Agent
Use the
DELETE /agents/{id} endpoint to remove an agent.Agent Properties
Agents include the following key properties:- id: Unique identifier (can be numeric or ElevenLabs agent ID)
- name: Agent display name
- tags: Array of tags for organization
- conversation_config: Configuration for agent conversations
- platform_settings: Platform-specific settings
- widget_config: Widget configuration for web integration
- published: Whether the agent is published
- published_at: Timestamp when agent was published
- elevenlabs_agent_id: Associated ElevenLabs agent ID
- version: Agent version number
- phone_numbers: Associated phone numbers
- client_tools: Client-side tools configuration
- webhook_tools: Webhook tools configuration
- integration_tools: Integration tools configuration