Actions25
Agent → Update
AI-generatedSummary
Updates a RetellAI agent by sending a PATCH request to /update-agent/{agentId}. Set the required agent ID and voice ID; optionally provide a name or additional configuration fields to include in the update.
Inputs
- Agent ID (required) — ID of the agent to update.
- Voice ID (required) — Voice ID for the agent, selected from the available voices.
- Agent Name — When nonempty, sets the agent name.
- Additional Configuration — JSON object of extra agent fields. Parsed and merged into the request body; use snake_case keys as indicated by the field description. Invalid JSON stops the operation with an error.
Output shape
A single response record from the RetellAI update-agent endpoint for each input item.
The node returns the API response as JSON. The request body includes voice_id only when nonempty, agent_name only when nonempty, and any parsed additional configuration fields. Despite Voice ID being marked required in the UI, the implementation omits it from the request when empty.
Examples
Example 1: Rename an agent and change its voice
Provide the agent ID, select a voice ID, and enter the new agent name.