- Category: artificial intelligence
- Auth: API_KEY
- Composio-managed OAuth available? N/A
- Tools: 70
- Triggers: 0
- Slug:
RETELLAI - Version: 20261101_00
Tools
Add community voice
Add community voice
RETELLAI_ADD_COMMUNITY_VOICEAdd a community voice from ElevenLabs to your Retell voice library. Use when you need to import a shared community voice for use in your agents.Input Parameters
Output
Add sources to knowledge base
Add sources to knowledge base
RETELLAI_ADD_KNOWLEDGE_BASE_SOURCESTool to add sources (documents, URLs, text) to an existing knowledge base in Retell AI. Use when you need to add additional content to a knowledge base. At least one of knowledge_base_texts, knowledge_base_files, or knowledge_base_urls should be provided.Input Parameters
Output
Buy a new phone number bind agents
Buy a new phone number bind agents
RETELLAI_BUY_A_NEW_PHONE_NUMBER_BIND_AGENTSPurchase a new phone number, optionally specifying a US area code and binding inbound and outbound agents. A nickname can also be supplied.Input Parameters
Output
Create Voice AI Agent
Create Voice AI Agent
RETELLAI_CREATE_AGENTCreate a new voice AI agent with specified configuration. Use when you need to set up a voice-based AI agent with custom response engine, voice settings, and behavior configuration.Input Parameters
Output
Create Agent Version
Create Agent Version
Create a new outbound phone call
Create a new outbound phone call
RETELLAI_CREATE_A_NEW_OUTBOUND_PHONE_CALLInitiate an outbound call by POST to ‘/v2/create-phone-call’. Requires ‘from_number’ and ‘to_number’ in E.164 format. Optional overrides and metadata supported. On success, returns call details including type, status, and IDs.Input Parameters
Output
Create a new web call
Create a new web call
RETELLAI_CREATE_A_NEW_WEB_CALLThe /v2/create-web-call endpoint creates a web call with a unique agent ID, returning call details like type, token, call ID, and status in JSON format, with a 201 response. Optional metadata and variables can be included.Input Parameters
Output
Create Batch Test
Create Batch Test
RETELLAI_CREATE_BATCH_TESTCreate a batch test job to run test cases against a Retell LLM or conversation flow response engine.Input Parameters
Output
Create a new chat session
Create a new chat session
RETELLAI_CREATE_CHATTool to create a new chat session with a chat agent. Use when you need to initiate a new chat conversation with a RetellAI chat agent.Input Parameters
Output
Create a new chat agent
Create a new chat agent
RETELLAI_CREATE_CHAT_AGENTCreate a new chat agent with specified configuration. Use when you need to set up a chat-based AI agent with custom response engine and behavior settings.Input Parameters
Output
Create chat completion
Create chat completion
Create conversation flow
Create conversation flow
RETELLAI_CREATE_CONVERSATION_FLOWCreate a new Conversation Flow that can be attached to an agent for response generation. Requires start_speaker, model_choice, and nodes. Returns conversation_flow_id and full configuration.Input Parameters
Output
Create conversation flow component
Create conversation flow component
RETELLAI_CREATE_CONVERSATION_FLOW_COMPONENTCreates a new shared conversation flow component at POST ‘/create-conversation-flow-component’. Requires ‘name’ and ‘nodes’ array. Optional: tools, mcps, start_node_id, begin_tag_display_position. Returns component ID, timestamp, and the full component definition.Input Parameters
Output
Create a new knowledge base
Create a new knowledge base
RETELLAI_CREATE_KNOWLEDGE_BASETool to create a new knowledge base in Retell AI with texts, files, and URLs. Use when you need to create a knowledge base for an AI agent. At least one of knowledge_base_texts, knowledge_base_files, or knowledge_base_urls should be provided.Input Parameters
Output
Create Retell LLM Response Engine
Create Retell LLM Response Engine
RETELLAI_CREATE_RETELL_LLMCreate a new Retell LLM Response Engine that can be attached to an agent. Use when you need to configure a new LLM-powered response system with custom prompts, tools, and conversation flows.Input Parameters
Output
Create Test Case Definition
Create Test Case Definition
RETELLAI_CREATE_TEST_CASE_DEFINITIONTool to create a test case definition for agent QA testing in Retell AI. Use when you need to define test scenarios for evaluating agent performance with specific user personas, goals, and success metrics.Input Parameters
Output
Delete agent
Delete agent
Delete call
Delete call
Delete chat agent
Delete chat agent
Delete conversation flow
Delete conversation flow
Delete conversation flow component
Delete conversation flow component
Delete knowledge base
Delete knowledge base
Delete knowledge base source
Delete knowledge base source
Delete phone number
Delete phone number
Delete Retell LLM
Delete Retell LLM
Delete test case definition
Delete test case definition
End chat
End chat
Retrieve details of a specific agent
Retrieve details of a specific agent
Get agent versions
Get agent versions
Get batch test
Get batch test
Get chat details
Get chat details
Retrieve details of a specific chat agent
Retrieve details of a specific chat agent
Get all versions of a chat agent
Get all versions of a chat agent
Get concurrency
Get concurrency
Get Conversation Flow
Get Conversation Flow
Get conversation flow component
Get conversation flow component
Get knowledge base
Get knowledge base
Retrieve details of a specific Retell LLM
Retrieve details of a specific Retell LLM
RETELLAI_GET_RETELL_LLMRetrieve details of a specific Retell LLM Response Engine by its unique identifier. Use when you need to access LLM configuration including model settings, prompts, tools, states, and knowledge base configurations.Input Parameters
Output
Import phone number
Import phone number
RETELLAI_IMPORT_PHONE_NUMBERTool to import a phone number from custom telephony and bind agents to it. Use when you need to integrate an existing phone number with Retell AI’s system for handling inbound and outbound calls.Input Parameters
Output
List agents
List agents
List agent versions
List agent versions
List all chats
List all chats
RETELLAI_LIST_ALL_CHATSRetrieve a page of chats associated with the account for viewing chat history or analyzing conversations. Supports sorting, a result limit, and a pagination key for subsequent pages.Input Parameters
Output
List all phone numbers
List all phone numbers
List batch tests
List batch tests
List chat agents
List chat agents
RETELLAI_LIST_CHAT_AGENTSList chat agents associated with the account, with pagination and an optional page limit. Use it to view available chat agents or find agent configurations.Input Parameters
Output
List conversation flow components
List conversation flow components
List conversation flows
List conversation flows
RETELLAI_LIST_CONVERSATION_FLOWSList conversation flows available for agent configuration. Results are paginated; use the pagination key and its version to retrieve subsequent pages.Input Parameters
Output
List knowledge bases
List knowledge bases
List Retell LLMs
List Retell LLMs
RETELLAI_LIST_RETELL_LLMSList a page of Retell LLM Response Engines that can be attached to an agent, including available IDs, models, prompts, tools, and other settings. Use pagination to retrieve additional pages.Input Parameters
Output
List test case definitions
List test case definitions
RETELLAI_LIST_TEST_CASE_DEFINITIONSTool to list test case definitions for a response engine (Retell LLM or Conversation Flow). Use when you need to retrieve all test cases configured for a specific response engine and optionally a specific version.Input Parameters
Output
List test runs
List test runs
List voices
List voices
Publish agent
Publish agent
Publish Agent Version
Publish Agent Version
Publish chat agent
Publish chat agent
Register phone call
Register phone call
RETELLAI_REGISTER_PHONE_CALLRegister a phone call for custom telephony integration with Retell AI. Use when you need to register a call before connecting it to Retell’s audio websocket for custom telephony providers.Input Parameters
Output
Retrieve call details
Retrieve call details
RETELLAI_RETRIEVE_CALL_DETAILSTool to retrieve call details with filtering options. Use when you need to fetch call records, analyze call history, or monitor call performance.Input Parameters
Output
Retrieve call details by id
Retrieve call details by id
Retrieve phone number details
Retrieve phone number details
RETELLAI_RETRIEVE_DETAILS_OF_A_SPECIFIC_PHONE_NUMBERTool to retrieve details of a specific phone number from Retell AI. Use when you need to get information about a phone number including its type, timestamps, SIP configuration, and SMS settings. The phone number should be provided in E.164 format.Input Parameters
Output
Retrieve details of a specific voice
Retrieve details of a specific voice
RETELLAI_RETRIEVE_DETAILS_OF_A_SPECIFIC_VOICETool to retrieve details of a specific voice by its voice_id. Use when you need information about a specific voice including its name, provider, accent, gender, age, and preview audio URL.Input Parameters
Output
Search community voice
Search community voice
Update agent
Update agent
Update call
Update call
RETELLAI_UPDATE_CALLUpdate an active call’s parameters such as metadata, dynamic variables, or data storage settings. Use when you need to modify call attributes during an ongoing call or update storage settings.Input Parameters
Output
Update chat agent
Update chat agent
Update chat metadata
Update chat metadata
RETELLAI_UPDATE_CHAT_METADATATool to update metadata and sensitive data storage settings for an existing chat. Use when you need to modify chat metadata, custom attributes, or override dynamic variables.Input Parameters
Output
Update conversation flow
Update conversation flow
Update conversation flow component
Update conversation flow component
RETELLAI_UPDATE_CONVERSATION_FLOW_COMPONENTUpdate an existing shared conversation flow component by its ID. Use when you need to modify component properties like name, nodes, tools, or MCP configurations.Input Parameters
Output
Update phone number configuration
Update phone number configuration
Update Retell LLM Response Engine
Update Retell LLM Response Engine
RETELLAI_UPDATE_RETELL_LLMUpdate an existing Retell LLM Response Engine by its unique identifier. Use when you need to modify LLM configuration, prompts, tools, conversation flows, or model settings for an existing response engine.Input Parameters
Output
Update test case definition
Update test case definition
RETELLAI_UPDATE_TEST_CASE_DEFINITIONUpdate a test case definition for agent testing. Use when modifying test scenarios, metrics, or mock configurations for Retell AI agent validation.