update_agent_config
Modify an agent's configuration fields (name, language, voice, model, variables, etc.) with partial updates. For versioned agents, changes are saved as a draft.
Instructions
Update an agent's configuration (name, language, first message, voice settings, model, variables, etc.). Only provided fields are updated. To update the agent's prompt/instructions, use update_agent_prompt instead. For versioned agents, changes are saved as a draft — use publish_draft to make them live, or test the draft first via make_call with the draft's version_id.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | New agent name | |
| agent_id | Yes | The agent ID to update | |
| language | No | Language configuration | |
| slm_model | No | Inference LLM model for the agent | |
| description | No | Agent description | |
| synthesizer | No | Voice synthesizer configuration | |
| first_message | No | First message when call starts (max 500 chars) | |
| global_prompt | No | Global system prompt for the agent (max 4000 chars). This is separate from the workflow prompt updated via update_agent_prompt. | |
| background_sound | No | Background sound option | |
| denoising_config | No | Audio denoising configuration | |
| redaction_config | No | Redaction configuration | |
| transcriber_type | No | Speech-to-text (STT) transcriber. 'pulse' is the current default and recommended option (widest language support). 'pulse-legacy' is the older model, deprecated and only available to allowlisted organizations — prefer 'pulse'. Note: 'gpt-realtime'/'gpt-realtime-mini' transcribers are set automatically when using a speech-to-speech LLM model and should not be set here. | |
| default_variables | No | Default variables for the agent prompt. Example: { prospect_name: 'Default', company: 'Acme' } | |
| knowledge_base_id | No | Knowledge base ID to attach to the agent | |
| smart_turn_config | No | Smart turn detection configuration | |
| speech_formatting | No | Enable speech formatting | |
| allow_inbound_call | No | Whether to allow inbound calls | |
| enable_style_guide | No | Enable conversational style guide | |
| allow_interruptions | No | Whether to allow user interruptions | |
| pronunciation_dicts | No | Custom pronunciation dictionary | |
| voicemail_detection | No | Voicemail detection configuration | |
| telephony_product_ids | No | Telephony product IDs (see get_phone_numbers) to assign to this agent. Takes effect IMMEDIATELY — number assignment is agent metadata, not versioned config, so no draft/publish is involved. Replaces the agent's current numbers; assigning a number already attached to another agent moves it. Pass [] to unassign all. | |
| session_timeout_config | No | Session timeout configuration | |
| voice_detection_config | No | Voice activity detection configuration | |
| call_disposition_config | No | Call disposition configuration prompt | |
| llm_idle_timeout_config | No | LLM idle timeout configuration per call type | |
| interruption_backoff_timer | No | Delay in seconds before agent resumes after interruption (0-10) | |
| wait_for_user_to_speak_first | No | Wait for user to speak before agent starts | |
| mute_user_until_first_bot_response | No | Mute user audio until the bot sends its first response |