# PUT /api/v1/voice_agents/:id    Update an existing AI Agent by its unique ID.

## Params

| Param name               | Description<br> <br>**Validations**                                                                                                                                             |
|--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **name**<br>OptionalBlank Value Allowed          | Name – Internal name for the AI Agent. Used for identification within the platform.<br>**Validations:**<br>- Must be a String             |
| **description**<br>OptionalBlank Value Allowed   | Description – Short summary describing the purpose and behavior of the AI Agent.<br>**Validations:**<br>- Must be a String           |
| **system_prompt**<br>OptionalBlank Value Allowed | System Prompt – Global instruction set applied to all flows in this AI Agent. Defines tone, rules, and constraints.<br>**Validations:**<br>- Must be a String |
| **conversation_timeout**<br>OptionalBlank Value Allowed   | Conversation Timeout Default – Default per-prompt timeout (in seconds) before the conversation ends if no response is received. Resets after each prompt unless overridden by a flow.<br>**Validations:**<br>- Must be a decimal number. |