Retell AI

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.

Untrusted display-only summary

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.

Untrusted display-only summary

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…

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

Deletes an existing agent by its unique identifier. Returns 204 No Content on successful deletion.

Untrusted display-only summary

Delete a specific call and its associated data by call ID. Use when you need to permanently remove a call record from the system.

Untrusted display-only summary

Delete an existing chat agent by its unique identifier. Use when you need to permanently remove a chat agent from the system.

Untrusted display-only summary

Delete a conversation flow and all its versions. Use when you need to permanently remove a conversation flow from the system.

Untrusted display-only summary

Delete a shared conversation flow component. When deleting a shared component, creates local copies for all linked conversation flows.

Untrusted display-only summary

Delete an existing knowledge base by its unique identifier. Use when you need to permanently remove a knowledge base from the system.

Untrusted display-only summary

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.

Untrusted display-only summary

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).

Untrusted display-only summary

Delete an existing Retell LLM Response Engine by its unique identifier. Use when you need to permanently remove a Retell LLM from the system.

Untrusted display-only summary

Delete a test case definition by its unique identifier. Use when you need to permanently remove a test case definition from the system.

Untrusted display-only summary

Tool to end an active chat session. Use when you need to terminate an ongoing chat conversation.

Untrusted display-only summary

Retrieve details of a specific agent by its unique identifier. Use when you need to access agent configuration details.

Untrusted display-only summary

Tool to retrieve all versions of a specific agent. Use when you need to view version history or access previous configurations of an agent.

Untrusted display-only summary

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.

Untrusted display-only summary

Tool to retrieve details of a specific chat session by chat ID. Use when you need to access chat transcript, status, or analysis data.

Untrusted display-only summary