67 available actions
What your AI agent can do in Retell AI
RetellAI captures calls and transcripts, enabling businesses to analyze conversations, extract insights, and enhance customer interactions in one centralized platform This page lists every available action. Your agent only receives the actions and permissions required for the role you approve.
Showing all 67 actions.
Common starting points
- Search community voiceSearch for community voices from voice providers.
- Retrieve details of a specific agentRetrieve details of a specific agent by its unique identifier.
- Add community voiceAdd a community voice from ElevenLabs to your Retell voice library.
- Create Voice AI AgentCreate a new voice AI agent with specified configuration.
- Update agentUpdate an existing agent's latest draft version.
- Update callUpdate an active call's parameters such as metadata, dynamic variables, or data storage settings.
Browse all 67 actions by capability
Open a capability to see every supported action and its description.
Find & reviewLook up and review existing recordsView 28 actions
- Retrieve details of a specific agentRetrieve details of a specific agent by its unique identifier.
- Get agent versionsTool to retrieve all versions of a specific agent.
- Get batch testRetrieve details and results of a specific batch test job.
- Get chat detailsTool to retrieve details of a specific chat session by chat ID.
- Retrieve details of a specific chat agentRetrieve details of a specific chat agent by its unique identifier.
- Get all versions of a chat agentRetrieve all versions of a specific chat agent by its unique identifier.
- Get concurrencyRetrieves the current concurrency and concurrency limits for the organization.
- Get Conversation FlowRetrieve details of a specific Conversation Flow by its ID.
- Get conversation flow componentRetrieves a shared conversation flow component by its unique identifier.
- Get knowledge baseRetrieve details of a specific knowledge base by its unique identifier.
- Retrieve details of a specific Retell LLMRetrieve details of a specific Retell LLM Response Engine by its unique identifier.
- List agentsRetrieves a list of all agents associated with the account.
- List all chatsTool to retrieve a list of all chats associated with the account.
- List all phone numbersRetrieves a list of all phone numbers associated with the account.
- List batch testsTool to list batch test jobs for a response engine.
- List chat agentsTool to retrieve a list of all chat agents associated with the account.
- List conversation flow componentsRetrieves a list of all shared conversation flow components.
- List conversation flowsTool to list all conversation flows that can be attached to an agent.
- List knowledge basesTool to retrieve all knowledge bases associated with the account.
- List Retell LLMsTool to list all Retell LLM Response Engines that can be attached to an agent.
- List test case definitionsTool to list test case definitions for a response engine (Retell LLM or Conversation Flow).
- List test runsTool to list all test case jobs (test runs) for a batch test job.
- List voicesList all voices available to the user.
- Retrieve call detailsTool to retrieve call details with filtering options.
- Retrieve call details by idRetrieve 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.
- Retrieve phone number detailsTool to retrieve details of a specific phone number from Retell AI.
- Retrieve details of a specific voiceTool to retrieve details of a specific voice by its voice_id.
- Search community voiceSearch for community voices from voice providers.
Create & communicateCreate records or send supported messagesView 17 actions
- Add community voiceAdd a community voice from ElevenLabs to your Retell voice library.
- Add sources to knowledge baseTool to add sources (documents, URLs, text) to an existing knowledge base in Retell AI.
- Create Voice AI AgentCreate a new voice AI agent with specified configuration.
- Create a new outbound phone callInitiate an outbound call by POST to '/v2/create-phone-call'.
- 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…
- Create Batch TestTool to create a batch test job that runs multiple test cases against an agent.
- Create a new chat sessionTool to create a new chat session with a chat agent.
- Create a new chat agentCreate a new chat agent with specified configuration.
- Create chat completionTool to create a chat completion for an existing chat session, generating the agent's response to a user message.
- Create conversation flowCreate a new Conversation Flow that can be attached to an agent for response generation.
- Create conversation flow componentCreates a new shared conversation flow component at POST '/create-conversation-flow-component'.
- Create a new knowledge baseTool to create a new knowledge base in Retell AI with texts, files, and URLs.
- Create Retell LLM Response EngineCreate a new Retell LLM Response Engine that can be attached to an agent.
- Create Test Case DefinitionTool to create a test case definition for agent QA testing in Retell AI.
- Import phone numberTool to import a phone number from custom telephony and bind agents to it.
- Publish agentPublishes the latest version of the agent and creates a new draft agent with a newer version.
- Publish chat agentPublishes the latest version of the chat agent and creates a new draft chat agent with a newer version.
Update & manageChange and manage existing recordsView 9 actions
- Update agentUpdate an existing agent's latest draft version.
- Update callUpdate an active call's parameters such as metadata, dynamic variables, or data storage settings.
- Update chat agentUpdate an existing chat agent configuration.
- Update chat metadataTool to update metadata and sensitive data storage settings for an existing chat.
- Update conversation flowUpdate an existing conversation flow configuration.
- Update conversation flow componentUpdate an existing shared conversation flow component by its ID.
- Update phone number configurationUpdate agent bound to a purchased phone number.
- Update Retell LLM Response EngineUpdate an existing Retell LLM Response Engine by its unique identifier.
- Update test case definitionUpdate a test case definition for agent testing.
Remove & cancelRemove records or cancel supported workView 10 actions
- Delete agentDeletes an existing agent by its unique identifier.
- Delete callDelete a specific call and its associated data by call ID.
- Delete chat agentDelete an existing chat agent by its unique identifier.
- Delete conversation flowDelete a conversation flow and all its versions.
- Delete conversation flow componentDelete a shared conversation flow component.
- Delete knowledge baseDelete an existing knowledge base by its unique identifier.
- Delete knowledge base sourceDelete an existing source from a knowledge base.
- Delete phone numberTool to delete an existing phone number from Retell AI.
- Delete Retell LLMDelete an existing Retell LLM Response Engine by its unique identifier.
- Delete test case definitionDelete a test case definition by its unique identifier.
Other actionsSpecialist and administrative actions.View 3 actions
- Buy a new phone number bind agentsThis endpoint allows purchasing a new phone number with a specified area code and binding it to designated agents for inbound and outbound calls.
- End chatTool to end an active chat session.
- Register phone callRegister a phone call for custom telephony integration with Retell AI.
Connection record
A connection you can control.
- Sign-in
- Customer-managed key
- Setup
- Use a key you create and control. It is stored securely and limited to the work agreed for the role.
- Boundaries
- Only the approved role and actions.
- Off switch
- Revoke the connection from your account.
FAQ
Before you connect Retell AI
How does the agent connect to Retell AI?
With a key you create and control. It is stored securely, permissions are limited to what the agent needs, and you can revoke it at any time.
What can the agent actually do in Retell AI?
The page above lists the 67 actions currently available through the Retell AI connection. The role determines which of those actions the agent may use, and write access is only enabled when the workflow needs it.
Is Retell AI included in my plan?
Connections are priced per tool on top of the base plan. Some are included and some are premium. See pricing for how connection charges work.
How long until Retell AI is ready?
Timing depends on the sign-in method, permissions and workflow being connected. We confirm the scope and setup plan before enabling the connection.
Bring the workflow together
Ready to put Retell AI to work?
Start with the responsibility you want off your plate. We’ll map the connection and the boundaries around it.