Retell AI
for LuumenAI
Read agent, call, and chat config in Retell AI, then change it with approval
Connect Retell AI and your team can ask about voice agents, chat agents, conversation flows, and knowledge bases without opening the dashboard. Look up an agent's current version, check concurrency against your limits, then make the change — add a knowledge base source, run a batch test, start an outbound call — as a previewed step you approve first. Luumen connects with an API key.
The Retell AI toolbox
67 tools: 28 read, 39 write. Reads answer instantly. Writes require approval by default. Everything is logged.
- ReadRetrieve details of a specific agentRetrieve details of a specific agent by its unique identifier.
- ReadGet agent versionsRetrieve all versions of a specific agent.
- ReadGet batch testRetrieve details and results of a specific batch test job.
- ReadGet chat detailsRetrieve details of a specific chat session by chat ID.
- ReadRetrieve details of a specific chat agentRetrieve details of a specific chat agent by its unique identifier.
- ReadGet all versions of a chat agentRetrieve all versions of a specific chat agent by its unique identifier.
- ReadGet concurrencyRetrieves the current concurrency and concurrency limits for the organization.
- ReadGet Conversation FlowRetrieve details of a specific Conversation Flow by its ID.
- ReadGet conversation flow componentRetrieves a shared conversation flow component by its unique identifier.
- ReadGet knowledge baseRetrieve details of a specific knowledge base by its unique identifier.
- ReadRetrieve details of a specific Retell LLMRetrieve details of a specific Retell LLM Response Engine by its unique identifier.
- ReadList agentsRetrieves a list of all agents associated with the account.
- ReadList all chatsRetrieve a list of all chats associated with the account.
- ReadList all phone numbersRetrieves a list of all phone numbers associated with the account.
- ReadList batch testsList batch test jobs for a response engine.
- ReadList chat agentsRetrieve a list of all chat agents associated with the account.
- ReadList conversation flow componentsRetrieves a list of all shared conversation flow components.
- ReadList conversation flowsList all conversation flows that can be attached to an agent.
- ReadList knowledge basesRetrieve all knowledge bases associated with the account.
- ReadList Retell LLMsList all Retell LLM Response Engines that can be attached to an agent.
- ReadList test case definitionsList test case definitions for a response engine (Retell LLM or Conversation Flow).
- ReadList test runsList all test case jobs (test runs) for a batch test job.
- ReadList voicesList all voices available to the user.
- ReadRetrieve call detailsRetrieve call details with filtering options.
- ReadRetrieve 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.
- ReadRetrieve phone number detailsRetrieve details of a specific phone number from Retell AI.
- ReadRetrieve details of a specific voiceRetrieve details of a specific voice by its voice_id.
- ReadSearch community voiceSearch for community voices from voice providers.
- WriteAdd community voiceAdd a community voice from ElevenLabs to your Retell voice library. Approval by default
- WriteAdd sources to knowledge baseAdd sources (documents, URLs, text) to an existing knowledge base in Retell AI. Approval by default
- WriteBuy 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. Approval by default
- WriteCreate Voice AI AgentCreate a new voice AI agent with specified configuration. Approval by default
- WriteCreate a new outbound phone callInitiate an outbound call by POST to '/v2/create-phone-call'. Approval by default
- WriteCreate 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. Approval by default
- WriteCreate Batch TestCreate a batch test job that runs multiple test cases against an agent. Approval by default
- WriteCreate a new chat sessionCreate a new chat session with a chat agent. Approval by default
- WriteCreate a new chat agentCreate a new chat agent with specified configuration. Approval by default
- WriteCreate chat completionCreate a chat completion for an existing chat session, generating the agent's response to a user message. Approval by default
- WriteCreate conversation flowCreate a new Conversation Flow that can be attached to an agent for response generation. Approval by default
- WriteCreate conversation flow componentCreates a new shared conversation flow component at POST '/create-conversation-flow-component'. Approval by default
- WriteCreate a new knowledge baseCreate a new knowledge base in Retell AI with texts, files, and URLs. Approval by default
- WriteCreate Retell LLM Response EngineCreate a new Retell LLM Response Engine that can be attached to an agent. Approval by default
- WriteCreate Test Case DefinitionCreate a test case definition for agent QA testing in Retell AI. Approval by default
- WriteDelete agentDeletes an existing agent by its unique identifier. Approval by default
- WriteDelete callDelete a specific call and its associated data by call ID. Approval by default
- WriteDelete chat agentDelete an existing chat agent by its unique identifier. Approval by default
- WriteDelete conversation flowDelete a conversation flow and all its versions. Approval by default
- WriteDelete conversation flow componentDelete a shared conversation flow component. Approval by default
- WriteDelete knowledge baseDelete an existing knowledge base by its unique identifier. Approval by default
- WriteDelete knowledge base sourceDelete an existing source from a knowledge base. Approval by default
- WriteDelete phone numberDelete an existing phone number from Retell AI. Approval by default
- WriteDelete Retell LLMDelete an existing Retell LLM Response Engine by its unique identifier. Approval by default
- WriteDelete test case definitionDelete a test case definition by its unique identifier. Approval by default
- WriteEnd chatEnd an active chat session. Approval by default
- WriteImport phone numberImport a phone number from custom telephony and bind agents to it. Approval by default
- WritePublish agentPublishes the latest version of the agent and creates a new draft agent with a newer version. Approval by default
- WritePublish chat agentPublishes the latest version of the chat agent and creates a new draft chat agent with a newer version. Approval by default
- WriteRegister phone callRegister a phone call for custom telephony integration with Retell AI. Approval by default
- WriteUpdate agentUpdate an existing agent's latest draft version. Approval by default
- WriteUpdate callUpdate an active call's parameters such as metadata, dynamic variables, or data storage settings. Approval by default
- WriteUpdate chat agentUpdate an existing chat agent configuration. Approval by default
- WriteUpdate chat metadataUpdate metadata and sensitive data storage settings for an existing chat. Approval by default
- WriteUpdate conversation flowUpdate an existing conversation flow configuration. Approval by default
- WriteUpdate conversation flow componentUpdate an existing shared conversation flow component by its ID. Approval by default
- WriteUpdate phone number configurationUpdate agent bound to a purchased phone number. Approval by default
- WriteUpdate Retell LLM Response EngineUpdate an existing Retell LLM Response Engine by its unique identifier. Approval by default
- WriteUpdate test case definitionUpdate a test case definition for agent testing. Approval by default
One prompt, start to finish
What a governed Retell AI run looks like inside Luumen.
Questions
How does LuumenAI connect to Retell AI?
Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
Can LuumenAI change things in Retell AI on its own?
Read actions answer immediately. Anything that writes — add community voice, add sources to knowledge base, buy a new phone number bind agents, create voice ai agent, and more — is shown as a plan and requires approval by default, including the 10 actions classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.
Who gets access to the integration?
You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.
Is there an audit trail?
Every call to Retell AI — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.
Often connected alongside
All integrations
Adobe Marketing Agent MCPAdobe Experience Platform context, sandbox switches, and async task status
AffindaRead parsed documents, collections, and annotations — change them with approval
Agent MailGive the agent its own mailbox for reading threads and sending updates
AI/ML APIInspect assistants, threads, and runs — and change them as approved stepsPut Retell AI to work with Luumen
Connect in minutes. Every action scoped, approved, and audited from day one.