GET
/
get-agent-versions
/
{agent_id}
import Retell from 'retell-sdk';

const client = new Retell({
  apiKey: 'YOUR_RETELL_API_KEY',
});

async function main() {
  const agentResponses = await client.agent.getVersions('16b980523634a6dc504898cda492e939');

  console.log(agentResponses);
}

main();
[
  {
    "agent_id": "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
    "version": 0,
    "is_published": false,
    "response_engine": {
      "type": "retell-llm",
      "llm_id": "llm_234sdertfsdsfsdf",
      "version": 0
    },
    "agent_name": "Jarvis",
    "voice_id": "11labs-Adrian",
    "voice_model": "eleven_turbo_v2",
    "fallback_voice_ids": [
      "openai-Alloy",
      "deepgram-Angus"
    ],
    "voice_temperature": 1,
    "voice_speed": 1,
    "volume": 1,
    "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": "coffee-shop",
    "ambient_sound_volume": 1,
    "language": "en-US",
    "webhook_url": "https://webhook-url-here",
    "boosted_keywords": [
      "retell",
      "kroger"
    ],
    "enable_transcription_formatting": true,
    "opt_out_sensitive_data_storage": true,
    "opt_in_signed_url": true,
    "pronunciation_dictionary": [
      {
        "word": "actually",
        "alphabet": "ipa",
        "phoneme": "ˈæktʃuəli"
      }
    ],
    "normalize_for_speech": true,
    "end_call_after_silence_ms": 600000,
    "max_call_duration_ms": 3600000,
    "enable_voicemail_detection": true,
    "voicemail_message": "Hi, please give us a callback.",
    "voicemail_detection_timeout_ms": 30000,
    "post_call_analysis_data": [
      {
        "type": "string",
        "name": "customer_name",
        "description": "The name of the customer.",
        "examples": [
          "John Doe",
          "Jane Smith"
        ]
      }
    ],
    "post_call_analysis_model": "gpt-4o-mini",
    "begin_message_delay_ms": 1000,
    "ring_duration_ms": 30000,
    "stt_mode": "fast",
    "allow_user_dtmf": true,
    "user_dtmf_options": {
      "digit_limit": 25,
      "termination_key": "#",
      "timeout_ms": 8000
    },
    "last_modification_timestamp": 1703413636133
  }
]

Authorizations

​
Authorization
string
header
required

Authentication header containing API key (find it in dashboard). The format is "Bearer YOUR_API_KEY"

Path Parameters

​
agent_id
string
required

Unique id of the agent versions to be retrieved.

Example:

"16b980523634a6dc504898cda492e939"

Response

200
application/json
Successfully retrieved all versions of an agent.

The response is of type object[].