retell_update_conversation_flow

Modify conversation flows by updating nodes and edges to adjust AI agent behavior and call handling logic.

Instructions

Update a conversation flow.

Input Schema

TableJSON Schema

Name	Required	Description
`conversation_flow_id`	Yes	The conversation flow ID to update
`name`	No	New name
`nodes`	No	Updated nodes
`edges`	No	Updated edges

Implementation Reference

src/index.ts:1221-1224 (handler)
The execution handler for the retell_update_conversation_flow tool. It extracts the conversation_flow_id from input arguments and forwards the remaining data as a PATCH request to the Retell API endpoint `/update-conversation-flow/{conversation_flow_id}` using the shared retellRequest utility.
```
case "retell_update_conversation_flow": {
  const { conversation_flow_id, ...flowUpdateData } = args;
  return retellRequest(`/update-conversation-flow/${conversation_flow_id}`, "PATCH", flowUpdateData as Record<string, unknown>);
}
```

src/index.ts:848-873 (schema)

The tool schema registration, defining the name, description, and input schema (including required conversation_flow_id and optional name, nodes, edges) used for validation and tool listing.

{
  name: "retell_update_conversation_flow",
  description: "Update a conversation flow.",
  inputSchema: {
    type: "object",
    properties: {
      conversation_flow_id: {
        type: "string",
        description: "The conversation flow ID to update"
      },
      name: {
        type: "string",
        description: "New name"
      },
      nodes: {
        type: "array",
        description: "Updated nodes"
      },
      edges: {
        type: "array",
        description: "Updated edges"
      }
    },
    required: ["conversation_flow_id"]
  }
},

src/index.ts:1283-1285 (registration)
The general tool registration handler that returns the full tools array (including this tool's schema) in response to ListTools requests.
```
server.setRequestHandler(ListToolsRequestSchema, async () => {
  return { tools };
});
```

src/index.ts:1287-1293 (registration)

The tool execution request handler registration, which dispatches to executeTool based on tool name, handling the call for retell_update_conversation_flow via the switch case.

// Register tool execution handler
server.setRequestHandler(CallToolRequestSchema, async (request) => {
  const { name, arguments: args } = request.params;

  try {
    const result = await executeTool(name, args as Record<string, unknown>);
    return {

Retell AI MCP Server