Get all versions of an agent
Path parameters
Unique id of the agent versions to be retrieved.
Response
Successfully retrieved all versions of an agent.
Example response
[
{
"agent_id": "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
"base_version": 12,
"agent_name": "Jarvis",
"version_description": "Customer support agent for handling product inquiries",
"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,
"voice_emotion": "calm",
"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_message": "Hi, please give us a callback.",
"voicemail_detection_timeout_ms": 30000,
"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"
]
}
],
"analysis_successful_prompt": "The agent finished the task and the call was complete without being cutoff.",
"analysis_summary_prompt": "Summarize the outcome of the conversation in two sentences.",
"analysis_user_sentiment_prompt": "Evaluate the user's sentiment based on their tone and satisfaction level.",
"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",
"timezone": "America/New_York",
"last_modification_timestamp": 1703413636133
}
]Changes
Changed in 18 of the 28 revisions of this API.62993
- ●
removed the optional property
items/allOf[AgentRequest]/is_publicfrom the response with the200statusresponse-optional-property-removed
- ●
- ●
added the new
s2.1-proenum value to theitems/allOf[AgentRequest]/voice_modelresponse property for the response status200response-property-enum-value-added
- ●
added the new
sonic-3.5enum value to theitems/allOf[AgentRequest]/voice_modelresponse property for the response status200response-property-enum-value-added
- ●
- ●
deleted the
queryrequest parameterinclude_response_enginerequest-parameter-removed
- ●
removed the optional property
items/allOf[subschema #3]/response_engine_datafrom the response with the200statusresponse-optional-property-removed
- ●
- ○
added the new optional
queryrequest parameterinclude_response_enginenew-optional-request-parameter
- ○
added the optional property
items/allOf[AgentRequest]/allow_dtmf_interruptionto the response with the200statusresponse-optional-property-added
- ○
added the optional property
items/allOf[AgentRequest]/call_screening_optionto the response with the200statusresponse-optional-property-added
- ○
added the optional property
items/allOf[AgentRequest]/ivr_option/detection_promptto the response with the200statusresponse-optional-property-added
- ○
added the optional property
items/allOf[AgentRequest]/voicemail_option/detection_promptto the response with the200statusresponse-optional-property-added
- ○
added
subschema #1subschema #3to theitems/response propertyallOflist for the response status200response-property-all-of-added
- ○
removed
subschema #1subschema #3from theitems/response propertyallOflist for the response status200response-property-all-of-removed
- ○
removed the
gemini-2.5-flashenum value from theitems/allOf[AgentRequest]/post_call_analysis_modelresponse property for the response status200response-property-enum-value-removed
- ○
- ▲
the
items/allOf[AgentRequest]/custom_stt_config/providerresponse's property type/format changed fromstring/to/for status200response-property-type-changed
- ●
added the new
gpt-5.5enum value to theitems/allOf[AgentRequest]/post_call_analysis_modelresponse property for the response status200response-property-enum-value-added
- ○
added
AsrProviderto theitems/allOf[AgentRequest]/custom_stt_config/providerresponse propertyallOflist for the response status200response-property-all-of-added
- ○
removed the
azureenum value from theitems/allOf[AgentRequest]/custom_stt_config/providerresponse property for the response status200response-property-enum-value-removed
- ○
removed the
deepgramenum value from theitems/allOf[AgentRequest]/custom_stt_config/providerresponse property for the response status200response-property-enum-value-removed
- ○
removed the
sonioxenum value from theitems/allOf[AgentRequest]/custom_stt_config/providerresponse property for the response status200response-property-enum-value-removed
- ▲
- ▲
added
LanguageLegacysubschema #2to theitems/allOf[AgentRequest]/languageresponse propertyoneOflist for the response status200response-property-one-of-added
- ▲
the
items/allOf[AgentRequest]/languageresponse's property type/format changed fromstring/to/for status200response-property-type-changed
- ○
removed the
af-ZAenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
ar-SAenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
az-AZenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
bg-BGenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
bs-BAenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
ca-ESenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
cs-CZenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
cy-GBenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
da-DKenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
de-DEenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
el-GRenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
en-AUenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
en-GBenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
en-INenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
en-NZenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
en-USenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
es-419enum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
es-ESenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
fa-IRenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
fi-FIenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
fil-PHenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
fr-CAenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
fr-FRenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
gl-ESenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
he-ILenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
hi-INenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
hr-HRenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
hu-HUenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
hy-AMenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
id-IDenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
is-ISenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
it-ITenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
ja-JPenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
kk-KZenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
kn-INenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
ko-KRenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
lt-LTenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
lv-LVenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
mk-MKenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
mr-INenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
ms-MYenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
multienum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
ne-NPenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
nl-BEenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
nl-NLenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
no-NOenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
pl-PLenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
pt-BRenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
pt-PTenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
ro-ROenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
ru-RUenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
sk-SKenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
sl-SIenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
sr-RSenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
sv-SEenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
sw-KEenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
ta-INenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
th-THenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
tr-TRenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
uk-UAenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
ur-INenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
vi-VNenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
yue-CNenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ○
removed the
zh-CNenum value from theitems/allOf[AgentRequest]/languageresponse property for the response status200response-property-enum-value-removed
- ▲
- ●
removed the optional property
items/allOf[AgentRequest]/normalize_for_speechfrom the response with the200statusresponse-optional-property-removed
- ●
added the new
gemini-3.1-flash-liteenum value to theitems/allOf[AgentRequest]/post_call_analysis_modelresponse property for the response status200response-property-enum-value-added
- ●
added the new
s2-proenum value to theitems/allOf[AgentRequest]/voice_modelresponse property for the response status200response-property-enum-value-added
- ●
added the new
sonioxenum value to theitems/allOf[AgentRequest]/custom_stt_config/providerresponse property for the response status200response-property-enum-value-added
- ●
- ▲
added
AnalysisDataCallPresetAnalysisDatato theitems/allOf[AgentRequest]/post_call_analysis_data/items/response propertyoneOflist for the response status200response-property-one-of-added
- ○
added the optional property
items/allOf[AgentRequest]/handbook_configto the response with the200statusresponse-optional-property-added
- ○
added the optional property
items/allOf[AgentRequest]/timezoneto the response with the200statusresponse-optional-property-added
- ○
removed
StringAnalysisDataEnumAnalysisDataBooleanAnalysisDataNumberAnalysisDatafrom theitems/allOf[AgentRequest]/post_call_analysis_data/items/response propertyoneOflist for the response status200response-property-one-of-removed
- ▲
- ●
added the new
gpt-5.4-minienum value to theitems/allOf[AgentRequest]/post_call_analysis_modelresponse property for the response status200response-property-enum-value-added
- ●
added the new
gpt-5.4-nanoenum value to theitems/allOf[AgentRequest]/post_call_analysis_modelresponse property for the response status200response-property-enum-value-added
- ○
removed the
sonic-2enum value from theitems/allOf[AgentRequest]/voice_modelresponse property for the response status200response-property-enum-value-removed
- ○
removed the
sonic-turboenum value from theitems/allOf[AgentRequest]/voice_modelresponse property for the response status200response-property-enum-value-removed
- ●
- ●
removed the optional property
items/allOf[AgentRequest]/enable_voicemail_detectionfrom the response with the200statusresponse-optional-property-removed
- ●
added the new
gpt-5.4enum value to theitems/allOf[AgentRequest]/post_call_analysis_modelresponse property for the response status200response-property-enum-value-added
- ●