https://retellai.com/?utm_source=discord&utm_medium=seo logo
i need apis to create transfer agent - cant find i...
# ❓・ai-evy-support
v
@AI Evy i need apis to create transfer agent - cant find it on APi refference page - i know how to create agents but there is only apis to create conversational agents - from dashboard i can create transfer agent but can we do it via APis?
a
Thanks for tagging me @Vako-SV. I'll look through relevant sources and get back to you shortly.
### Answer Based on the available sources, Agent Transfer (also called Agent Swap) is a feature within Conversation Flow that allows you to switch between Retell agents during a call [(1) ]() [(2) ]() . This is different from traditional phone-based call transfers. The Agent Transfer functionality is configured through the Conversation Flow API, not through a separate "transfer agent" API endpoint [(2) ]() . You would: 1. Create your individual agents using the standard agent creation API 2. Use the Conversation Flow API to set up the agent transfer logic between them The Conversation Flow API is available in the SDK and allows you to create and manage conversation flows programmatically, including Agent Transfer, along with MCP, Warm Transfer, and other features . For the specific API endpoint, you'll want to check the [Create Conversation Flow]() documentation referenced in the changelog . The key distinction is that Agent Transfer is a node within a Conversation Flow, not a separate type of agent. You configure which agent to transfer to by specifying the agent ID and version in the Agent Transfer Node settings [(1) ]() .
​ To learn more, see the sources I considered: [[1] Agent Transfer Node](https://docs.retellai.com/build/conversation-flow/transfer-agent-node) [[2] Agent transfer, MCP Client, Static IP and more](https://www.retellai.com/changelog/agent-transfer-mcp-client) ​
Feel free to tag @AI Evy with additional questions. I also appreciate feedback, it helps me improve.
v
@AI Evy i mean we can create from retell dashboard Transfer agents i need to know if we can create them using API
a
Thanks for the follow-up, @Vako-SV. I'll get back to you soon.
### Answer Based on the available sources, the Conversation Flow API enables you to create agent transfers programmatically [(1) ]() [(2) ]() . The API allows you to create conversation flows that include Agent Transfer nodes, along with MCP, Warm Transfer, and Agent Swap functionality [(1) ]() . To create an agent transfer via API, you would use the Create Conversation Flow endpoint [(2) ]() :
Copy code
javascript
import Retell from 'retell-sdk';
const client = new Retell({
 apiKey: process.env['RETELL_API_KEY'],
}) ;
const conversationFlowResponse = await client.conversationFlow.create({
 model_choice: { model: 'gpt-4.1', type: 'cascading' },
 nodes: [
 {
 id: 'start',
 instruction: { text: 'Greet the customer and ask how you can help them.', type: 'prompt' },
 type: 'conversation',
 },
 ],
 start_speaker: 'agent',
}) ;
The Agent Transfer functionality is configured as a node within the conversation flow structure, where you can specify the transfer agent's ID and version [(3) ]() [(4) ]() . The Conversation Flow API is available in the SDK and supports programmatic creation and management of these flows [(1) ]() .
​ To learn more, see the sources I considered: [[1] Agent transfer, MCP Client, Static IP and more](https://www.retellai.com/changelog/agent-transfer-mcp-client) [[2] Create Conversation Flow](https://docs.retellai.com/api-references/create-conversation-flow) [[3] Agent Transfer Node](https://docs.retellai.com/build/conversation-flow/transfer-agent-node) [[4] Agent Transfer](https://docs.retellai.com/build/single-multi-prompt/transfer-agent) ​
Feel free to tag @AI Evy with additional questions. I also appreciate feedback, it helps me improve.