import Retell from 'retell-sdk';

const client = new Retell({
  apiKey: process.env['RETELL_API_KEY'], // This is the default and can be omitted
});

const agentResponse = await client.agent.create({
  response_engine: { llm_id: 'llm_234sdertfsdsfsdf', type: 'retell-llm' },
  voice_id: 'retell-Cimo',
});

console.log(agentResponse.agent_id);

import os
from retell import Retell

client = Retell(
    api_key=os.environ.get("RETELL_API_KEY"),  # This is the default and can be omitted
)
agent_response = client.agent.create(
    response_engine={
        "llm_id": "llm_234sdertfsdsfsdf",
        "type": "retell-llm",
    },
    voice_id="retell-Cimo",
)
print(agent_response.agent_id)

curl --request POST \
  --url https://api.retellai.com/create-agent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "response_engine": {
    "type": "retell-llm",
    "llm_id": "llm_234sdertfsdsfsdf",
    "version": 0
  },
  "voice_id": "retell-Cimo",
  "agent_name": "Jarvis",
  "version_description": "Customer support agent for handling product inquiries",
  "version_title": "Production hotfix",
  "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_events": [],
  "webhook_timeout_ms": 10000,
  "boosted_keywords": [
    "retell",
    "kroger"
  ],
  "contact_memory_config": {
    "enable_update": true,
    "enable_read": true
  },
  "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"
    }
  ],
  "enable_dnc_detection": false,
  "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"
      ],
      "required": true,
      "conditional_prompt": "<string>"
    }
  ],
  "post_call_analysis_model": "gpt-4.1-mini",
  "begin_message_delay_ms": 1000,
  "ring_duration_ms": 30000,
  "stt_mode": "fast",
  "custom_stt_config": {
    "endpointing_ms": 123
  },
  "vocab_specialization": "general",
  "allow_user_dtmf": true,
  "allow_dtmf_interruption": false,
  "user_dtmf_options": {
    "digit_limit": 25.5,
    "termination_key": "#",
    "timeout_ms": 8000
  },
  "denoising_mode": "noise-cancellation",
  "guardrail_config": {
    "output_topics": [],
    "input_topics": [
      "platform_integrity_jailbreaking"
    ]
  },
  "handbook_config": {
    "default_personality": true,
    "conversational_personality": true,
    "natural_filler_words": true,
    "high_empathy": true,
    "echo_verification": true,
    "nato_phonetic_alphabet": true,
    "speech_normalization": true,
    "smart_matching": true,
    "ai_disclosure": true,
    "scope_boundaries": true
  },
  "timezone": "America/New_York",
  "pre_session_tools": [
    {
      "type": "integration_app",
      "name": "<string>",
      "app_id": "<string>",
      "provider": "<string>",
      "app_tool_template_name": "<string>",
      "parameters": [
        {
          "type": "object",
          "properties": {},
          "required": [
            "<string>"
          ]
        }
      ],
      "response_variables": {
        "contact_first_name": "data.first_name"
      },
      "output_selection": {
        "mode": "all",
        "fields": [
          "<string>"
        ]
      },
      "description": "<string>",
      "speak_during_execution": true,
      "speak_after_execution": true,
      "execution_message_description": "<string>",
      "enable_typing_sound": true,
      "depends_on": [
        "<string>"
      ]
    }
  ],
  "post_session_tools": [
    {
      "type": "integration_app",
      "name": "<string>",
      "app_id": "<string>",
      "provider": "<string>",
      "app_tool_template_name": "<string>",
      "parameters": [
        {
          "type": "object",
          "properties": {},
          "required": [
            "<string>"
          ]
        }
      ],
      "response_variables": {
        "contact_first_name": "data.first_name"
      },
      "output_selection": {
        "mode": "all",
        "fields": [
          "<string>"
        ]
      },
      "description": "<string>",
      "speak_during_execution": true,
      "speak_after_execution": true,
      "execution_message_description": "<string>",
      "enable_typing_sound": true,
      "depends_on": [
        "<string>"
      ]
    }
  ]
}
'

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.retellai.com/create-agent",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'response_engine' => [
        'type' => 'retell-llm',
        'llm_id' => 'llm_234sdertfsdsfsdf',
        'version' => 0
    ],
    'voice_id' => 'retell-Cimo',
    'agent_name' => 'Jarvis',
    'version_description' => 'Customer support agent for handling product inquiries',
    'version_title' => 'Production hotfix',
    '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_events' => [
        
    ],
    'webhook_timeout_ms' => 10000,
    'boosted_keywords' => [
        'retell',
        'kroger'
    ],
    'contact_memory_config' => [
        'enable_update' => true,
        'enable_read' => true
    ],
    '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'
        ]
    ],
    'enable_dnc_detection' => false,
    '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'
                ],
                'required' => true,
                'conditional_prompt' => '<string>'
        ]
    ],
    'post_call_analysis_model' => 'gpt-4.1-mini',
    'begin_message_delay_ms' => 1000,
    'ring_duration_ms' => 30000,
    'stt_mode' => 'fast',
    'custom_stt_config' => [
        'endpointing_ms' => 123
    ],
    'vocab_specialization' => 'general',
    'allow_user_dtmf' => true,
    'allow_dtmf_interruption' => false,
    'user_dtmf_options' => [
        'digit_limit' => 25.5,
        'termination_key' => '#',
        'timeout_ms' => 8000
    ],
    'denoising_mode' => 'noise-cancellation',
    'guardrail_config' => [
        'output_topics' => [
                
        ],
        'input_topics' => [
                'platform_integrity_jailbreaking'
        ]
    ],
    'handbook_config' => [
        'default_personality' => true,
        'conversational_personality' => true,
        'natural_filler_words' => true,
        'high_empathy' => true,
        'echo_verification' => true,
        'nato_phonetic_alphabet' => true,
        'speech_normalization' => true,
        'smart_matching' => true,
        'ai_disclosure' => true,
        'scope_boundaries' => true
    ],
    'timezone' => 'America/New_York',
    'pre_session_tools' => [
        [
                'type' => 'integration_app',
                'name' => '<string>',
                'app_id' => '<string>',
                'provider' => '<string>',
                'app_tool_template_name' => '<string>',
                'parameters' => [
                                [
                                                                'type' => 'object',
                                                                'properties' => [
                                                                                                                                
                                                                ],
                                                                'required' => [
                                                                                                                                '<string>'
                                                                ]
                                ]
                ],
                'response_variables' => [
                                'contact_first_name' => 'data.first_name'
                ],
                'output_selection' => [
                                'mode' => 'all',
                                'fields' => [
                                                                '<string>'
                                ]
                ],
                'description' => '<string>',
                'speak_during_execution' => true,
                'speak_after_execution' => true,
                'execution_message_description' => '<string>',
                'enable_typing_sound' => true,
                'depends_on' => [
                                '<string>'
                ]
        ]
    ],
    'post_session_tools' => [
        [
                'type' => 'integration_app',
                'name' => '<string>',
                'app_id' => '<string>',
                'provider' => '<string>',
                'app_tool_template_name' => '<string>',
                'parameters' => [
                                [
                                                                'type' => 'object',
                                                                'properties' => [
                                                                                                                                
                                                                ],
                                                                'required' => [
                                                                                                                                '<string>'
                                                                ]
                                ]
                ],
                'response_variables' => [
                                'contact_first_name' => 'data.first_name'
                ],
                'output_selection' => [
                                'mode' => 'all',
                                'fields' => [
                                                                '<string>'
                                ]
                ],
                'description' => '<string>',
                'speak_during_execution' => true,
                'speak_after_execution' => true,
                'execution_message_description' => '<string>',
                'enable_typing_sound' => true,
                'depends_on' => [
                                '<string>'
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.retellai.com/create-agent"

	payload := strings.NewReader("{\n  \"response_engine\": {\n    \"type\": \"retell-llm\",\n    \"llm_id\": \"llm_234sdertfsdsfsdf\",\n    \"version\": 0\n  },\n  \"voice_id\": \"retell-Cimo\",\n  \"agent_name\": \"Jarvis\",\n  \"version_description\": \"Customer support agent for handling product inquiries\",\n  \"version_title\": \"Production hotfix\",\n  \"fallback_voice_ids\": [\n    \"cartesia-Cimo\",\n    \"minimax-Cimo\"\n  ],\n  \"voice_temperature\": 1,\n  \"voice_speed\": 1,\n  \"enable_dynamic_voice_speed\": true,\n  \"enable_dynamic_responsiveness\": true,\n  \"volume\": 1,\n  \"enable_expressive_mode\": true,\n  \"expressive_emotion_tags\": [\n    \"empathetic\",\n    \"excited\",\n    \"sigh\",\n    \"clear throat\",\n    \"emphasis\"\n  ],\n  \"expressive_mode_prompt\": \"Use [sigh] for thoughtful pauses and [excited] for good news.\",\n  \"responsiveness\": 1,\n  \"interruption_sensitivity\": 1,\n  \"enable_backchannel\": true,\n  \"backchannel_frequency\": 0.9,\n  \"backchannel_words\": [\n    \"yeah\",\n    \"uh-huh\"\n  ],\n  \"reminder_trigger_ms\": 10000,\n  \"reminder_max_count\": 2,\n  \"ambient_sound_volume\": 1,\n  \"language\": \"en-US\",\n  \"webhook_url\": \"https://webhook-url-here\",\n  \"webhook_events\": [],\n  \"webhook_timeout_ms\": 10000,\n  \"boosted_keywords\": [\n    \"retell\",\n    \"kroger\"\n  ],\n  \"contact_memory_config\": {\n    \"enable_update\": true,\n    \"enable_read\": true\n  },\n  \"data_storage_setting\": \"everything\",\n  \"data_storage_retention_days\": 30,\n  \"opt_in_signed_url\": true,\n  \"signed_url_expiration_ms\": 86400000,\n  \"pronunciation_dictionary\": [\n    {\n      \"word\": \"actually\",\n      \"alphabet\": \"ipa\",\n      \"phoneme\": \"ˈæktʃuəli\"\n    }\n  ],\n  \"enable_dnc_detection\": false,\n  \"end_call_after_silence_ms\": 600000,\n  \"max_call_duration_ms\": 3600000,\n  \"voicemail_option\": {\n    \"action\": {\n      \"type\": \"static_text\",\n      \"text\": \"Please give us a callback tomorrow at 10am.\"\n    }\n  },\n  \"ivr_option\": {\n    \"action\": {\n      \"type\": \"hangup\"\n    }\n  },\n  \"call_screening_option\": {\n    \"agent_identity\": \"Acme Health scheduling team\",\n    \"call_purpose\": \"confirming your appointment for tomorrow\"\n  },\n  \"post_call_analysis_data\": [\n    {\n      \"type\": \"string\",\n      \"name\": \"customer_name\",\n      \"description\": \"The name of the customer.\",\n      \"examples\": [\n        \"John Doe\",\n        \"Jane Smith\"\n      ],\n      \"required\": true,\n      \"conditional_prompt\": \"<string>\"\n    }\n  ],\n  \"post_call_analysis_model\": \"gpt-4.1-mini\",\n  \"begin_message_delay_ms\": 1000,\n  \"ring_duration_ms\": 30000,\n  \"stt_mode\": \"fast\",\n  \"custom_stt_config\": {\n    \"endpointing_ms\": 123\n  },\n  \"vocab_specialization\": \"general\",\n  \"allow_user_dtmf\": true,\n  \"allow_dtmf_interruption\": false,\n  \"user_dtmf_options\": {\n    \"digit_limit\": 25.5,\n    \"termination_key\": \"#\",\n    \"timeout_ms\": 8000\n  },\n  \"denoising_mode\": \"noise-cancellation\",\n  \"guardrail_config\": {\n    \"output_topics\": [],\n    \"input_topics\": [\n      \"platform_integrity_jailbreaking\"\n    ]\n  },\n  \"handbook_config\": {\n    \"default_personality\": true,\n    \"conversational_personality\": true,\n    \"natural_filler_words\": true,\n    \"high_empathy\": true,\n    \"echo_verification\": true,\n    \"nato_phonetic_alphabet\": true,\n    \"speech_normalization\": true,\n    \"smart_matching\": true,\n    \"ai_disclosure\": true,\n    \"scope_boundaries\": true\n  },\n  \"timezone\": \"America/New_York\",\n  \"pre_session_tools\": [\n    {\n      \"type\": \"integration_app\",\n      \"name\": \"<string>\",\n      \"app_id\": \"<string>\",\n      \"provider\": \"<string>\",\n      \"app_tool_template_name\": \"<string>\",\n      \"parameters\": [\n        {\n          \"type\": \"object\",\n          \"properties\": {},\n          \"required\": [\n            \"<string>\"\n          ]\n        }\n      ],\n      \"response_variables\": {\n        \"contact_first_name\": \"data.first_name\"\n      },\n      \"output_selection\": {\n        \"mode\": \"all\",\n        \"fields\": [\n          \"<string>\"\n        ]\n      },\n      \"description\": \"<string>\",\n      \"speak_during_execution\": true,\n      \"speak_after_execution\": true,\n      \"execution_message_description\": \"<string>\",\n      \"enable_typing_sound\": true,\n      \"depends_on\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"post_session_tools\": [\n    {\n      \"type\": \"integration_app\",\n      \"name\": \"<string>\",\n      \"app_id\": \"<string>\",\n      \"provider\": \"<string>\",\n      \"app_tool_template_name\": \"<string>\",\n      \"parameters\": [\n        {\n          \"type\": \"object\",\n          \"properties\": {},\n          \"required\": [\n            \"<string>\"\n          ]\n        }\n      ],\n      \"response_variables\": {\n        \"contact_first_name\": \"data.first_name\"\n      },\n      \"output_selection\": {\n        \"mode\": \"all\",\n        \"fields\": [\n          \"<string>\"\n        ]\n      },\n      \"description\": \"<string>\",\n      \"speak_during_execution\": true,\n      \"speak_after_execution\": true,\n      \"execution_message_description\": \"<string>\",\n      \"enable_typing_sound\": true,\n      \"depends_on\": [\n        \"<string>\"\n      ]\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.retellai.com/create-agent")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"response_engine\": {\n    \"type\": \"retell-llm\",\n    \"llm_id\": \"llm_234sdertfsdsfsdf\",\n    \"version\": 0\n  },\n  \"voice_id\": \"retell-Cimo\",\n  \"agent_name\": \"Jarvis\",\n  \"version_description\": \"Customer support agent for handling product inquiries\",\n  \"version_title\": \"Production hotfix\",\n  \"fallback_voice_ids\": [\n    \"cartesia-Cimo\",\n    \"minimax-Cimo\"\n  ],\n  \"voice_temperature\": 1,\n  \"voice_speed\": 1,\n  \"enable_dynamic_voice_speed\": true,\n  \"enable_dynamic_responsiveness\": true,\n  \"volume\": 1,\n  \"enable_expressive_mode\": true,\n  \"expressive_emotion_tags\": [\n    \"empathetic\",\n    \"excited\",\n    \"sigh\",\n    \"clear throat\",\n    \"emphasis\"\n  ],\n  \"expressive_mode_prompt\": \"Use [sigh] for thoughtful pauses and [excited] for good news.\",\n  \"responsiveness\": 1,\n  \"interruption_sensitivity\": 1,\n  \"enable_backchannel\": true,\n  \"backchannel_frequency\": 0.9,\n  \"backchannel_words\": [\n    \"yeah\",\n    \"uh-huh\"\n  ],\n  \"reminder_trigger_ms\": 10000,\n  \"reminder_max_count\": 2,\n  \"ambient_sound_volume\": 1,\n  \"language\": \"en-US\",\n  \"webhook_url\": \"https://webhook-url-here\",\n  \"webhook_events\": [],\n  \"webhook_timeout_ms\": 10000,\n  \"boosted_keywords\": [\n    \"retell\",\n    \"kroger\"\n  ],\n  \"contact_memory_config\": {\n    \"enable_update\": true,\n    \"enable_read\": true\n  },\n  \"data_storage_setting\": \"everything\",\n  \"data_storage_retention_days\": 30,\n  \"opt_in_signed_url\": true,\n  \"signed_url_expiration_ms\": 86400000,\n  \"pronunciation_dictionary\": [\n    {\n      \"word\": \"actually\",\n      \"alphabet\": \"ipa\",\n      \"phoneme\": \"ˈæktʃuəli\"\n    }\n  ],\n  \"enable_dnc_detection\": false,\n  \"end_call_after_silence_ms\": 600000,\n  \"max_call_duration_ms\": 3600000,\n  \"voicemail_option\": {\n    \"action\": {\n      \"type\": \"static_text\",\n      \"text\": \"Please give us a callback tomorrow at 10am.\"\n    }\n  },\n  \"ivr_option\": {\n    \"action\": {\n      \"type\": \"hangup\"\n    }\n  },\n  \"call_screening_option\": {\n    \"agent_identity\": \"Acme Health scheduling team\",\n    \"call_purpose\": \"confirming your appointment for tomorrow\"\n  },\n  \"post_call_analysis_data\": [\n    {\n      \"type\": \"string\",\n      \"name\": \"customer_name\",\n      \"description\": \"The name of the customer.\",\n      \"examples\": [\n        \"John Doe\",\n        \"Jane Smith\"\n      ],\n      \"required\": true,\n      \"conditional_prompt\": \"<string>\"\n    }\n  ],\n  \"post_call_analysis_model\": \"gpt-4.1-mini\",\n  \"begin_message_delay_ms\": 1000,\n  \"ring_duration_ms\": 30000,\n  \"stt_mode\": \"fast\",\n  \"custom_stt_config\": {\n    \"endpointing_ms\": 123\n  },\n  \"vocab_specialization\": \"general\",\n  \"allow_user_dtmf\": true,\n  \"allow_dtmf_interruption\": false,\n  \"user_dtmf_options\": {\n    \"digit_limit\": 25.5,\n    \"termination_key\": \"#\",\n    \"timeout_ms\": 8000\n  },\n  \"denoising_mode\": \"noise-cancellation\",\n  \"guardrail_config\": {\n    \"output_topics\": [],\n    \"input_topics\": [\n      \"platform_integrity_jailbreaking\"\n    ]\n  },\n  \"handbook_config\": {\n    \"default_personality\": true,\n    \"conversational_personality\": true,\n    \"natural_filler_words\": true,\n    \"high_empathy\": true,\n    \"echo_verification\": true,\n    \"nato_phonetic_alphabet\": true,\n    \"speech_normalization\": true,\n    \"smart_matching\": true,\n    \"ai_disclosure\": true,\n    \"scope_boundaries\": true\n  },\n  \"timezone\": \"America/New_York\",\n  \"pre_session_tools\": [\n    {\n      \"type\": \"integration_app\",\n      \"name\": \"<string>\",\n      \"app_id\": \"<string>\",\n      \"provider\": \"<string>\",\n      \"app_tool_template_name\": \"<string>\",\n      \"parameters\": [\n        {\n          \"type\": \"object\",\n          \"properties\": {},\n          \"required\": [\n            \"<string>\"\n          ]\n        }\n      ],\n      \"response_variables\": {\n        \"contact_first_name\": \"data.first_name\"\n      },\n      \"output_selection\": {\n        \"mode\": \"all\",\n        \"fields\": [\n          \"<string>\"\n        ]\n      },\n      \"description\": \"<string>\",\n      \"speak_during_execution\": true,\n      \"speak_after_execution\": true,\n      \"execution_message_description\": \"<string>\",\n      \"enable_typing_sound\": true,\n      \"depends_on\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"post_session_tools\": [\n    {\n      \"type\": \"integration_app\",\n      \"name\": \"<string>\",\n      \"app_id\": \"<string>\",\n      \"provider\": \"<string>\",\n      \"app_tool_template_name\": \"<string>\",\n      \"parameters\": [\n        {\n          \"type\": \"object\",\n          \"properties\": {},\n          \"required\": [\n            \"<string>\"\n          ]\n        }\n      ],\n      \"response_variables\": {\n        \"contact_first_name\": \"data.first_name\"\n      },\n      \"output_selection\": {\n        \"mode\": \"all\",\n        \"fields\": [\n          \"<string>\"\n        ]\n      },\n      \"description\": \"<string>\",\n      \"speak_during_execution\": true,\n      \"speak_after_execution\": true,\n      \"execution_message_description\": \"<string>\",\n      \"enable_typing_sound\": true,\n      \"depends_on\": [\n        \"<string>\"\n      ]\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.retellai.com/create-agent")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"response_engine\": {\n    \"type\": \"retell-llm\",\n    \"llm_id\": \"llm_234sdertfsdsfsdf\",\n    \"version\": 0\n  },\n  \"voice_id\": \"retell-Cimo\",\n  \"agent_name\": \"Jarvis\",\n  \"version_description\": \"Customer support agent for handling product inquiries\",\n  \"version_title\": \"Production hotfix\",\n  \"fallback_voice_ids\": [\n    \"cartesia-Cimo\",\n    \"minimax-Cimo\"\n  ],\n  \"voice_temperature\": 1,\n  \"voice_speed\": 1,\n  \"enable_dynamic_voice_speed\": true,\n  \"enable_dynamic_responsiveness\": true,\n  \"volume\": 1,\n  \"enable_expressive_mode\": true,\n  \"expressive_emotion_tags\": [\n    \"empathetic\",\n    \"excited\",\n    \"sigh\",\n    \"clear throat\",\n    \"emphasis\"\n  ],\n  \"expressive_mode_prompt\": \"Use [sigh] for thoughtful pauses and [excited] for good news.\",\n  \"responsiveness\": 1,\n  \"interruption_sensitivity\": 1,\n  \"enable_backchannel\": true,\n  \"backchannel_frequency\": 0.9,\n  \"backchannel_words\": [\n    \"yeah\",\n    \"uh-huh\"\n  ],\n  \"reminder_trigger_ms\": 10000,\n  \"reminder_max_count\": 2,\n  \"ambient_sound_volume\": 1,\n  \"language\": \"en-US\",\n  \"webhook_url\": \"https://webhook-url-here\",\n  \"webhook_events\": [],\n  \"webhook_timeout_ms\": 10000,\n  \"boosted_keywords\": [\n    \"retell\",\n    \"kroger\"\n  ],\n  \"contact_memory_config\": {\n    \"enable_update\": true,\n    \"enable_read\": true\n  },\n  \"data_storage_setting\": \"everything\",\n  \"data_storage_retention_days\": 30,\n  \"opt_in_signed_url\": true,\n  \"signed_url_expiration_ms\": 86400000,\n  \"pronunciation_dictionary\": [\n    {\n      \"word\": \"actually\",\n      \"alphabet\": \"ipa\",\n      \"phoneme\": \"ˈæktʃuəli\"\n    }\n  ],\n  \"enable_dnc_detection\": false,\n  \"end_call_after_silence_ms\": 600000,\n  \"max_call_duration_ms\": 3600000,\n  \"voicemail_option\": {\n    \"action\": {\n      \"type\": \"static_text\",\n      \"text\": \"Please give us a callback tomorrow at 10am.\"\n    }\n  },\n  \"ivr_option\": {\n    \"action\": {\n      \"type\": \"hangup\"\n    }\n  },\n  \"call_screening_option\": {\n    \"agent_identity\": \"Acme Health scheduling team\",\n    \"call_purpose\": \"confirming your appointment for tomorrow\"\n  },\n  \"post_call_analysis_data\": [\n    {\n      \"type\": \"string\",\n      \"name\": \"customer_name\",\n      \"description\": \"The name of the customer.\",\n      \"examples\": [\n        \"John Doe\",\n        \"Jane Smith\"\n      ],\n      \"required\": true,\n      \"conditional_prompt\": \"<string>\"\n    }\n  ],\n  \"post_call_analysis_model\": \"gpt-4.1-mini\",\n  \"begin_message_delay_ms\": 1000,\n  \"ring_duration_ms\": 30000,\n  \"stt_mode\": \"fast\",\n  \"custom_stt_config\": {\n    \"endpointing_ms\": 123\n  },\n  \"vocab_specialization\": \"general\",\n  \"allow_user_dtmf\": true,\n  \"allow_dtmf_interruption\": false,\n  \"user_dtmf_options\": {\n    \"digit_limit\": 25.5,\n    \"termination_key\": \"#\",\n    \"timeout_ms\": 8000\n  },\n  \"denoising_mode\": \"noise-cancellation\",\n  \"guardrail_config\": {\n    \"output_topics\": [],\n    \"input_topics\": [\n      \"platform_integrity_jailbreaking\"\n    ]\n  },\n  \"handbook_config\": {\n    \"default_personality\": true,\n    \"conversational_personality\": true,\n    \"natural_filler_words\": true,\n    \"high_empathy\": true,\n    \"echo_verification\": true,\n    \"nato_phonetic_alphabet\": true,\n    \"speech_normalization\": true,\n    \"smart_matching\": true,\n    \"ai_disclosure\": true,\n    \"scope_boundaries\": true\n  },\n  \"timezone\": \"America/New_York\",\n  \"pre_session_tools\": [\n    {\n      \"type\": \"integration_app\",\n      \"name\": \"<string>\",\n      \"app_id\": \"<string>\",\n      \"provider\": \"<string>\",\n      \"app_tool_template_name\": \"<string>\",\n      \"parameters\": [\n        {\n          \"type\": \"object\",\n          \"properties\": {},\n          \"required\": [\n            \"<string>\"\n          ]\n        }\n      ],\n      \"response_variables\": {\n        \"contact_first_name\": \"data.first_name\"\n      },\n      \"output_selection\": {\n        \"mode\": \"all\",\n        \"fields\": [\n          \"<string>\"\n        ]\n      },\n      \"description\": \"<string>\",\n      \"speak_during_execution\": true,\n      \"speak_after_execution\": true,\n      \"execution_message_description\": \"<string>\",\n      \"enable_typing_sound\": true,\n      \"depends_on\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"post_session_tools\": [\n    {\n      \"type\": \"integration_app\",\n      \"name\": \"<string>\",\n      \"app_id\": \"<string>\",\n      \"provider\": \"<string>\",\n      \"app_tool_template_name\": \"<string>\",\n      \"parameters\": [\n        {\n          \"type\": \"object\",\n          \"properties\": {},\n          \"required\": [\n            \"<string>\"\n          ]\n        }\n      ],\n      \"response_variables\": {\n        \"contact_first_name\": \"data.first_name\"\n      },\n      \"output_selection\": {\n        \"mode\": \"all\",\n        \"fields\": [\n          \"<string>\"\n        ]\n      },\n      \"description\": \"<string>\",\n      \"speak_during_execution\": true,\n      \"speak_after_execution\": true,\n      \"execution_message_description\": \"<string>\",\n      \"enable_typing_sound\": true,\n      \"depends_on\": [\n        \"<string>\"\n      ]\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "agent_id": "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
  "version": 0,
  "response_engine": {
    "type": "retell-llm",
    "llm_id": "llm_234sdertfsdsfsdf",
    "version": 0
  },
  "voice_id": "retell-Cimo",
  "last_modification_timestamp": 1703413636133,
  "base_version": 12,
  "assigned_tags": [
    "<string>"
  ],
  "is_published": false,
  "agent_name": "Jarvis",
  "version_description": "Customer support agent for handling product inquiries",
  "version_title": "Production hotfix",
  "voice_model": "eleven_flash_v2",
  "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": "coffee-shop",
  "ambient_sound_volume": 1,
  "language": "en-US",
  "webhook_url": "https://webhook-url-here",
  "webhook_events": [
    "call_started"
  ],
  "webhook_timeout_ms": 10000,
  "boosted_keywords": [
    "retell",
    "kroger"
  ],
  "contact_memory_config": {
    "enable_update": true,
    "enable_read": true
  },
  "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"
    }
  ],
  "enable_dnc_detection": false,
  "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"
      ],
      "required": true,
      "conditional_prompt": "<string>"
    }
  ],
  "post_call_analysis_model": "gpt-4.1-mini",
  "begin_message_delay_ms": 1000,
  "ring_duration_ms": 30000,
  "stt_mode": "fast",
  "custom_stt_config": {
    "provider": "azure",
    "endpointing_ms": 123
  },
  "vocab_specialization": "general",
  "allow_user_dtmf": true,
  "allow_dtmf_interruption": false,
  "user_dtmf_options": {
    "digit_limit": 25.5,
    "termination_key": "#",
    "timeout_ms": 8000
  },
  "denoising_mode": "noise-cancellation",
  "pii_config": {
    "mode": "post_call",
    "categories": []
  },
  "guardrail_config": {
    "output_topics": [
      "harassment"
    ],
    "input_topics": [
      "platform_integrity_jailbreaking"
    ]
  },
  "handbook_config": {
    "default_personality": true,
    "conversational_personality": true,
    "natural_filler_words": true,
    "high_empathy": true,
    "echo_verification": true,
    "nato_phonetic_alphabet": true,
    "speech_normalization": true,
    "smart_matching": true,
    "ai_disclosure": true,
    "scope_boundaries": true
  },
  "timezone": "America/New_York",
  "pre_session_tools": [
    {
      "type": "integration_app",
      "name": "<string>",
      "app_id": "<string>",
      "provider": "<string>",
      "app_tool_template_name": "<string>",
      "parameters": [
        {
          "type": "object",
          "properties": {},
          "required": [
            "<string>"
          ]
        }
      ],
      "response_variables": {
        "contact_first_name": "data.first_name"
      },
      "output_selection": {
        "mode": "all",
        "fields": [
          "<string>"
        ]
      },
      "description": "<string>",
      "speak_during_execution": true,
      "speak_after_execution": true,
      "execution_message_description": "<string>",
      "execution_message_type": "prompt",
      "enable_typing_sound": true,
      "depends_on": [
        "<string>"
      ]
    }
  ],
  "post_session_tools": [
    {
      "type": "integration_app",
      "name": "<string>",
      "app_id": "<string>",
      "provider": "<string>",
      "app_tool_template_name": "<string>",
      "parameters": [
        {
          "type": "object",
          "properties": {},
          "required": [
            "<string>"
          ]
        }
      ],
      "response_variables": {
        "contact_first_name": "data.first_name"
      },
      "output_selection": {
        "mode": "all",
        "fields": [
          "<string>"
        ]
      },
      "description": "<string>",
      "speak_during_execution": true,
      "speak_after_execution": true,
      "execution_message_description": "<string>",
      "execution_message_type": "prompt",
      "enable_typing_sound": true,
      "depends_on": [
        "<string>"
      ],
      "condition": {
        "type": "equation",
        "equations": [
          {
            "left": "<string>",
            "operator": "==",
            "right": "<string>"
          }
        ],
        "operator": "||"
      }
    }
  ]
}

{
  "status": "error",
  "message": "Invalid request format, please check API reference."
}

{
  "status": "error",
  "message": "API key is missing or invalid."
}

{
  "status": "error",
  "message": "Cannot find requested asset under given api key."
}

{
  "status": "error",
  "message": "An unexpected server error occurred."
}