Add community voice
Add 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.
ActionTry it
Integrate Retell AI
with your AI workspace
RetellAI captures calls and transcripts, enabling businesses to analyze conversations, extract insights, and enhance customer interactions in one centralized platform
Explore Triggers and Actions
Add sources to knowledge base
Tool 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.
ActionTry it
Buy a new phone number bind agents
This endpoint allows purchasing a new phone number with a specified area code and binding it to designated agents for inbound and outbound calls. It requires JSON with agent IDs and area code. Responses indicate the creation status or errors. A purchased phone number is a prerequisite for initiating outbound calls; an empty phone number inventory will prevent outbound calls from being made.
ActionTry it
Create a new chat agent
Create 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.
ActionTry it
Create a new chat session
Tool 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.
ActionTry it
Create a new knowledge base
Tool 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.
ActionTry it
Create a new outbound phone call
Initiate 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.
ActionTry it
Create a new web call
The /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.
ActionTry it
Create Batch Test
Tool to create a batch test job that runs multiple test cases against an agent. Use when you need to evaluate agent performance across multiple test scenarios simultaneously.
ActionTry it
Create chat completion
Tool to create a chat completion for an existing chat session, generating the agent's response to a user message. Use when you need the agent to respond to user input in an ongoing chat conversation.
ActionTry it
Create conversation flow
Create 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.
ActionTry it
Create conversation flow component
Creates 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.
ActionTry it
Create Retell LLM Response Engine
Create 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.
ActionTry it
Create Test Case Definition
Tool 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.
ActionTry it
Create Voice AI Agent
Create 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.
ActionTry it
Delete agent
Deletes an existing agent by its unique identifier. Returns 204 No Content on successful deletion.
ActionTry it
Delete call
Delete a specific call and its associated data by call ID. Use when you need to permanently remove a call record from the system.
ActionTry it
Delete chat agent
Delete an existing chat agent by its unique identifier. Use when you need to permanently remove a chat agent from the system.
ActionTry it
Delete conversation flow
Delete a conversation flow and all its versions. Use when you need to permanently remove a conversation flow from the system.
ActionTry it
Delete conversation flow component
Delete a shared conversation flow component. When deleting a shared component, creates local copies for all linked conversation flows.
ActionTry it
Delete knowledge base
Delete an existing knowledge base by its unique identifier. Use when you need to permanently remove a knowledge base from the system.
ActionTry it
Delete knowledge base source
Delete an existing source from a knowledge base. Use when you need to remove a specific document, text, or URL source from a knowledge base.
ActionTry it
Delete phone number
Tool to delete an existing phone number from Retell AI. Use when you need to remove a phone number that is no longer needed. The phone number must be in E.164 format (e.g., +14159998888).
ActionTry it
Delete Retell LLM
Delete an existing Retell LLM Response Engine by its unique identifier. Use when you need to permanently remove a Retell LLM from the system.
ActionTry it
Delete test case definition
Delete a test case definition by its unique identifier. Use when you need to permanently remove a test case definition from the system.
ActionTry it
End chat
Tool to end an active chat session. Use when you need to terminate an ongoing chat conversation.
ActionTry it
Get agent versions
Tool to retrieve all versions of a specific agent. Use when you need to view version history or access previous configurations of an agent.
ActionTry it
Get all versions of a chat agent
Retrieve all versions of a specific chat agent by its unique identifier. Use when you need to access version history of a chat agent.
ActionTry it
Get batch test
Retrieve details and results of a specific batch test job. Use when you need to check the status and results of a batch test execution.
ActionTry it
Get chat details
Tool to retrieve details of a specific chat session by chat ID. Use when you need to access chat transcript, status, or analysis data.
ActionTry it
Get concurrency
Retrieves the current concurrency and concurrency limits for the organization. Use when you need to check concurrent call capacity and availability.
ActionTry it
Get Conversation Flow
Retrieve details of a specific Conversation Flow by its ID. Use when you need to fetch conversation flow configuration including nodes, version, and settings.
ActionTry it
Get conversation flow component
Retrieves a shared conversation flow component by its unique identifier. Use when you need to fetch details of a specific conversation flow component.
ActionTry it
Get knowledge base
Retrieve details of a specific knowledge base by its unique identifier. Use when you need to access knowledge base configuration including name, status, sources, and refresh settings.
ActionTry it
Import phone number
Tool 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.
ActionTry it
List agents
Retrieves a list of all agents associated with the account.
ActionTry it
List all chats
Tool to retrieve a list of all chats associated with the account. Use when you need to view chat history or analyze past conversations.
ActionTry it
List all phone numbers
Retrieves a list of all phone numbers associated with the account. An empty result means no phone numbers exist; RETELLAI_BUY_A_NEW_PHONE_NUMBER_BIND_AGENTS must be called before outbound calls can be made.
ActionTry it
List batch tests
Tool to list batch test jobs for a response engine. Use when you need to retrieve batch testing results for a Retell LLM or conversation flow.
ActionTry it
List chat agents
Tool to retrieve a list of all chat agents associated with the account. Use when you need to view available chat agents or find specific chat agent configurations.
ActionTry it
List conversation flow components
Retrieves a list of all shared conversation flow components. Use when you need to access reusable conversation flow building blocks that can be referenced across multiple conversation flows.
ActionTry it
List conversation flows
Tool to list all conversation flows that can be attached to an agent. Use when you need to retrieve available conversation flows for agent configuration.
ActionTry it
List knowledge bases
Tool to retrieve all knowledge bases associated with the account. Use when you need to list or view all available knowledge bases with their details including IDs, names, statuses, sources, and refresh settings.
ActionTry it
List Retell LLMs
Tool to list all Retell LLM Response Engines that can be attached to an agent. Use when you need to retrieve available LLM configurations including their IDs, models, prompts, tools, and other settings.
ActionTry it
List test case definitions
Tool 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.
ActionTry it
List test runs
Tool to list all test case jobs (test runs) for a batch test job. Use when you need to retrieve execution results and details for all tests in a batch.
ActionTry it
List voices
List all voices available to the user. Returns voice details including voice_id, name, provider, accent, gender, age, and preview audio URL.
ActionTry it
Publish agent
Publishes the latest version of the agent and creates a new draft agent with a newer version. Use when you need to deploy an agent to production.
ActionTry it
Publish chat agent
Publishes the latest version of the chat agent and creates a new draft chat agent with a newer version. Use when you need to deploy a chat agent to production.
ActionTry it
Register phone call
Register 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.
ActionTry it
Retrieve call details
Tool to retrieve call details with filtering options. Use when you need to fetch call records, analyze call history, or monitor call performance.
ActionTry it
Retrieve call details by id
Retrieve call details by ID for web/phone calls, including type, agent ID, status, timestamps, and web access token; covering responses from success to server errors.
ActionTry it
Retrieve details of a specific agent
Retrieve details of a specific agent by its unique identifier. Use when you need to access agent configuration details.
ActionTry it
Retrieve details of a specific chat agent
Retrieve details of a specific chat agent by its unique identifier. Use when you need to access chat agent configuration details.
ActionTry it
Retrieve details of a specific Retell LLM
Retrieve 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.
ActionTry it
Retrieve details of a specific voice
Tool 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.
ActionTry it
Retrieve phone number details
Tool 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.
ActionTry it
Search community voice
Search for community voices from voice providers. Use when you need to find voices by name, description, or ID, optionally filtering by provider.
ActionTry it
Update agent
Update an existing agent's latest draft version. Use when modifying agent configuration, voice settings, or behavior parameters for a Retell AI agent.
ActionTry it
Update call
Update 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.
ActionTry it
Update chat agent
Update an existing chat agent configuration. Use when modifying chat agent settings, response engine, or behavior parameters.
ActionTry it
Update chat metadata
Tool 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.
ActionTry it
Update conversation flow
Update an existing conversation flow configuration. Use when modifying conversation flow settings such as model parameters, nodes, tools, or prompt templates.
ActionTry it
Update conversation flow component
Update an existing shared conversation flow component by its ID. Use when you need to modify component properties like name, nodes, tools, or MCP configurations.
ActionTry it
Update phone number configuration
Update agent bound to a purchased phone number. Use when you need to change the agent configuration, nickname, webhook URLs, or SIP settings for an existing phone number.
ActionTry it
Update Retell LLM Response Engine
Update 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.
ActionTry it
Update test case definition
Update a test case definition for agent testing. Use when modifying test scenarios, metrics, or mock configurations for Retell AI agent validation.
ActionTry it