Actions26
- Agent Actions
- Conversation Actions
- Knowledge Base Actions
- Phone Actions
- Voice Actions
Agent → List
AI-generatedOverview
The node interacts with the ElevenLabs Conversational AI API, specifically allowing management and retrieval of "agents" among other resources. For the Agent - List operation, it fetches a list of conversational agents from the ElevenLabs platform. This is useful for workflows that need to display, filter, or process multiple agents programmatically.
Common scenarios include:
- Retrieving all available agents to display in a dashboard.
- Filtering agents by name to find specific ones.
- Limiting the number of agents returned for pagination or performance reasons.
Example: A user wants to get up to 50 agents whose names contain "support" to analyze their configurations or statuses.
Properties
| Name | Meaning |
|---|---|
| Return All | Boolean flag to return all matching agents or limit the results to a specified maximum. |
| Limit | Maximum number of agents to return if "Return All" is false. Range: 1 to 100. |
| Filters | Collection of filters to narrow down the agent list. Currently supports: |
| - Search: Text string to search agents by their name. |
Output
The output is an array of JSON objects representing agents retrieved from the ElevenLabs API. Each object contains details about an individual agent such as its ID, name, language, configuration, and other metadata as provided by the API.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to the ElevenLabs Conversational AI API.
- Needs an API key credential configured in n8n for authentication.
- The node depends on internal service modules for agent operations (
AgentService).
Troubleshooting
- Empty results: If no agents are returned, verify the search filter text or try disabling filters.
- Limit ignored: Ensure "Return All" is set to false to enforce the limit.
- API errors: Common errors may relate to invalid API keys or network issues. Check credentials and connectivity.
- Exceeded rate limits: The ElevenLabs API may throttle requests; consider adding delays or reducing request frequency.
Links and References
- ElevenLabs Conversational AI Documentation
- ElevenLabs Dashboard (for managing agents and voices)