POST /repair-agent/{agent_id}
Changed onRemove references to resources that no longer exist in your workspace from an agent draft version and its response engine — tools whose app connection has been deleted, unknown knowledge bases, and deleted shared components — and remap voices that are no longer accessible to a default voice. If the agent's response engine version has been published, the engine is left untouched and only agent-level references are repaired. Repairing an agent with nothing to fix is a no-op.
Request
- Base URLhttps://api.retellai.com
- AuthHTTP bearer
Path parameters
Unique id of the agent to be repaired.
Query parameters
Optional version of the agent to repair. Default to latest version. Published versions are immutable and cannot be repaired.
Response
Successfully repaired the agent.
Example response
{
"agent_id": "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
"base_version": 12,
"agent_name": "Jarvis",
"version_description": "Customer support agent for handling product inquiries",
"version_title": "Production hotfix",
"voice_id": "retell-Cimo",
"fallback_voice_ids": [
"cartesia-Cimo",
"minimax-Cimo"
],
"voice_temperature": 1,
"voice_speed": 1,
"enable_dynamic_voice_speed": true,
"enable_dynamic_responsiveness": true,
"volume": 1,
"enable_expressive_mode": true,
"expressive_emotion_tags": [
"empathetic",
"excited",
"sigh",
"clear throat",
"emphasis"
],
"expressive_mode_prompt": "Use [sigh] for thoughtful pauses and [excited] for good news.",
"responsiveness": 1,
"interruption_sensitivity": 1,
"enable_backchannel": true,
"backchannel_frequency": 0.9,
"backchannel_words": [
"yeah",
"uh-huh"
],
"reminder_trigger_ms": 10000,
"reminder_max_count": 2,
"ambient_sound_volume": 1,
"language": "en-US",
"webhook_url": "https://webhook-url-here",
"webhook_timeout_ms": 10000,
"boosted_keywords": [
"retell",
"kroger"
],
"data_storage_setting": "everything",
"data_storage_retention_days": 30,
"opt_in_signed_url": true,
"signed_url_expiration_ms": 86400000,
"pronunciation_dictionary": [
{
"word": "actually",
"alphabet": "ipa",
"phoneme": "ˈæktʃuəli"
}
],
"end_call_after_silence_ms": 600000,
"max_call_duration_ms": 3600000,
"voicemail_option": {
"action": {
"type": "static_text",
"text": "Please give us a callback tomorrow at 10am."
}
},
"ivr_option": {
"action": {
"type": "hangup"
}
},
"call_screening_option": {
"agent_identity": "Acme Health scheduling team",
"call_purpose": "confirming your appointment for tomorrow"
},
"post_call_analysis_data": [
{
"type": "string",
"name": "customer_name",
"description": "The name of the customer.",
"examples": [
"John Doe",
"Jane Smith"
]
}
],
"begin_message_delay_ms": 1000,
"ring_duration_ms": 30000,
"stt_mode": "fast",
"vocab_specialization": "general",
"allow_user_dtmf": true,
"user_dtmf_options": {
"termination_key": "#"
},
"denoising_mode": "noise-cancellation",
"denoising_enhancement_level": 0.8,
"timezone": "America/New_York",
"pre_session_tools": [
{
"response_variables": {
"contact_first_name": "data.first_name"
},
"output_selection": {
"fields": [
"id",
"properties.email"
]
}
}
],
"post_session_tools": [
{
"response_variables": {
"contact_first_name": "data.first_name"
},
"output_selection": {
"fields": [
"id",
"properties.email"
]
}
}
],
"last_modification_timestamp": 1703413636133
}Changes
- warning
added the new
drama-3enum value to the////////response property for the response status
- warning
- warning
added the new
gpt-6.1-terraenum value to the////////response property for the response status - warning
added the new
gpt-6.1-terraenum value to the////////response property for the response status
- warning