curl --request PUT \
--url https://api.trugen.ai/v1/ext/agent/{id} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"id": "b63c2a53-266b-4b43-a71b-7ea8b5e2e916",
"agent_name": "Customer Support Agent",
"agent_system_prompt": "You are a helpful AI assistant that handles customer service inquiries.",
"avatars": [
{
"avatar_key_id": "1e4ea106",
"persona_name": "Sofia - Friendly Support",
"persona_prompt": "Speak in a warm, engaging tone and provide clear answers.",
"config": {
"llm": {
"model": "meta-llama/llama-4-maverick-17b-128e-instruct",
"provider": "groq"
},
"stt": {
"model": "flux-general-en",
"provider": "deepgram",
"min_endpointing_delay": 0.3,
"max_endpointing_delay": 0.4
},
"tts": {
"model_id": "eleven_turbo_v2_5",
"provider": "elevenlabs",
"voice_id": "ZUrEGyu8GFMwnHbvLhv2"
}
}
}
],
"callback_events": [
"participant_left",
"agent.started_speaking",
"agent.stopped_speaking",
"agent.interrupted",
"user.started_speaking",
"user.stopped_speaking",
"utterance_committed",
"max_call_duration_timeout"
],
"callback_url": "",
"config": {
"maxCallDuration": 1800,
"conversationalContext": "customer-support",
"memory": {
"isEnabled": false,
"instruction": "sample memory instruction for the agent"
}
},
"knowledge_base": [
{
"id": "ac79226e-73e1-41fe-8cde-469ae4e244fa",
"name": "Product Support Articles",
"description": "Contains FAQs and troubleshooting guides for product lines."
}
],
"record": true,
"is_active": true,
"created_at": "2025-12-01T10:20:30.000Z",
"updated_at": "2025-12-03T14:50:00.000Z"
}
'import requests
url = "https://api.trugen.ai/v1/ext/agent/{id}"
payload = {
"id": "b63c2a53-266b-4b43-a71b-7ea8b5e2e916",
"agent_name": "Customer Support Agent",
"agent_system_prompt": "You are a helpful AI assistant that handles customer service inquiries.",
"avatars": [
{
"avatar_key_id": "1e4ea106",
"persona_name": "Sofia - Friendly Support",
"persona_prompt": "Speak in a warm, engaging tone and provide clear answers.",
"config": {
"llm": {
"model": "meta-llama/llama-4-maverick-17b-128e-instruct",
"provider": "groq"
},
"stt": {
"model": "flux-general-en",
"provider": "deepgram",
"min_endpointing_delay": 0.3,
"max_endpointing_delay": 0.4
},
"tts": {
"model_id": "eleven_turbo_v2_5",
"provider": "elevenlabs",
"voice_id": "ZUrEGyu8GFMwnHbvLhv2"
}
}
}
],
"callback_events": ["participant_left", "agent.started_speaking", "agent.stopped_speaking", "agent.interrupted", "user.started_speaking", "user.stopped_speaking", "utterance_committed", "max_call_duration_timeout"],
"callback_url": "",
"config": {
"maxCallDuration": 1800,
"conversationalContext": "customer-support",
"memory": {
"isEnabled": False,
"instruction": "sample memory instruction for the agent"
}
},
"knowledge_base": [
{
"id": "ac79226e-73e1-41fe-8cde-469ae4e244fa",
"name": "Product Support Articles",
"description": "Contains FAQs and troubleshooting guides for product lines."
}
],
"record": True,
"is_active": True,
"created_at": "2025-12-01T10:20:30.000Z",
"updated_at": "2025-12-03T14:50:00.000Z"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
id: 'b63c2a53-266b-4b43-a71b-7ea8b5e2e916',
agent_name: 'Customer Support Agent',
agent_system_prompt: 'You are a helpful AI assistant that handles customer service inquiries.',
avatars: [
{
avatar_key_id: '1e4ea106',
persona_name: 'Sofia - Friendly Support',
persona_prompt: 'Speak in a warm, engaging tone and provide clear answers.',
config: {
llm: {model: 'meta-llama/llama-4-maverick-17b-128e-instruct', provider: 'groq'},
stt: {
model: 'flux-general-en',
provider: 'deepgram',
min_endpointing_delay: 0.3,
max_endpointing_delay: 0.4
},
tts: {
model_id: 'eleven_turbo_v2_5',
provider: 'elevenlabs',
voice_id: 'ZUrEGyu8GFMwnHbvLhv2'
}
}
}
],
callback_events: [
'participant_left',
'agent.started_speaking',
'agent.stopped_speaking',
'agent.interrupted',
'user.started_speaking',
'user.stopped_speaking',
'utterance_committed',
'max_call_duration_timeout'
],
callback_url: '',
config: {
maxCallDuration: 1800,
conversationalContext: 'customer-support',
memory: {isEnabled: false, instruction: 'sample memory instruction for the agent'}
},
knowledge_base: [
{
id: 'ac79226e-73e1-41fe-8cde-469ae4e244fa',
name: 'Product Support Articles',
description: 'Contains FAQs and troubleshooting guides for product lines.'
}
],
record: true,
is_active: true,
created_at: '2025-12-01T10:20:30.000Z',
updated_at: '2025-12-03T14:50:00.000Z'
})
};
fetch('https://api.trugen.ai/v1/ext/agent/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.trugen.ai/v1/ext/agent/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'id' => 'b63c2a53-266b-4b43-a71b-7ea8b5e2e916',
'agent_name' => 'Customer Support Agent',
'agent_system_prompt' => 'You are a helpful AI assistant that handles customer service inquiries.',
'avatars' => [
[
'avatar_key_id' => '1e4ea106',
'persona_name' => 'Sofia - Friendly Support',
'persona_prompt' => 'Speak in a warm, engaging tone and provide clear answers.',
'config' => [
'llm' => [
'model' => 'meta-llama/llama-4-maverick-17b-128e-instruct',
'provider' => 'groq'
],
'stt' => [
'model' => 'flux-general-en',
'provider' => 'deepgram',
'min_endpointing_delay' => 0.3,
'max_endpointing_delay' => 0.4
],
'tts' => [
'model_id' => 'eleven_turbo_v2_5',
'provider' => 'elevenlabs',
'voice_id' => 'ZUrEGyu8GFMwnHbvLhv2'
]
]
]
],
'callback_events' => [
'participant_left',
'agent.started_speaking',
'agent.stopped_speaking',
'agent.interrupted',
'user.started_speaking',
'user.stopped_speaking',
'utterance_committed',
'max_call_duration_timeout'
],
'callback_url' => '',
'config' => [
'maxCallDuration' => 1800,
'conversationalContext' => 'customer-support',
'memory' => [
'isEnabled' => false,
'instruction' => 'sample memory instruction for the agent'
]
],
'knowledge_base' => [
[
'id' => 'ac79226e-73e1-41fe-8cde-469ae4e244fa',
'name' => 'Product Support Articles',
'description' => 'Contains FAQs and troubleshooting guides for product lines.'
]
],
'record' => true,
'is_active' => true,
'created_at' => '2025-12-01T10:20:30.000Z',
'updated_at' => '2025-12-03T14:50:00.000Z'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$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.trugen.ai/v1/ext/agent/{id}"
payload := strings.NewReader("{\n \"id\": \"b63c2a53-266b-4b43-a71b-7ea8b5e2e916\",\n \"agent_name\": \"Customer Support Agent\",\n \"agent_system_prompt\": \"You are a helpful AI assistant that handles customer service inquiries.\",\n \"avatars\": [\n {\n \"avatar_key_id\": \"1e4ea106\",\n \"persona_name\": \"Sofia - Friendly Support\",\n \"persona_prompt\": \"Speak in a warm, engaging tone and provide clear answers.\",\n \"config\": {\n \"llm\": {\n \"model\": \"meta-llama/llama-4-maverick-17b-128e-instruct\",\n \"provider\": \"groq\"\n },\n \"stt\": {\n \"model\": \"flux-general-en\",\n \"provider\": \"deepgram\",\n \"min_endpointing_delay\": 0.3,\n \"max_endpointing_delay\": 0.4\n },\n \"tts\": {\n \"model_id\": \"eleven_turbo_v2_5\",\n \"provider\": \"elevenlabs\",\n \"voice_id\": \"ZUrEGyu8GFMwnHbvLhv2\"\n }\n }\n }\n ],\n \"callback_events\": [\n \"participant_left\",\n \"agent.started_speaking\",\n \"agent.stopped_speaking\",\n \"agent.interrupted\",\n \"user.started_speaking\",\n \"user.stopped_speaking\",\n \"utterance_committed\",\n \"max_call_duration_timeout\"\n ],\n \"callback_url\": \"\",\n \"config\": {\n \"maxCallDuration\": 1800,\n \"conversationalContext\": \"customer-support\",\n \"memory\": {\n \"isEnabled\": false,\n \"instruction\": \"sample memory instruction for the agent\"\n }\n },\n \"knowledge_base\": [\n {\n \"id\": \"ac79226e-73e1-41fe-8cde-469ae4e244fa\",\n \"name\": \"Product Support Articles\",\n \"description\": \"Contains FAQs and troubleshooting guides for product lines.\"\n }\n ],\n \"record\": true,\n \"is_active\": true,\n \"created_at\": \"2025-12-01T10:20:30.000Z\",\n \"updated_at\": \"2025-12-03T14:50:00.000Z\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("x-api-key", "<api-key>")
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.put("https://api.trugen.ai/v1/ext/agent/{id}")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"id\": \"b63c2a53-266b-4b43-a71b-7ea8b5e2e916\",\n \"agent_name\": \"Customer Support Agent\",\n \"agent_system_prompt\": \"You are a helpful AI assistant that handles customer service inquiries.\",\n \"avatars\": [\n {\n \"avatar_key_id\": \"1e4ea106\",\n \"persona_name\": \"Sofia - Friendly Support\",\n \"persona_prompt\": \"Speak in a warm, engaging tone and provide clear answers.\",\n \"config\": {\n \"llm\": {\n \"model\": \"meta-llama/llama-4-maverick-17b-128e-instruct\",\n \"provider\": \"groq\"\n },\n \"stt\": {\n \"model\": \"flux-general-en\",\n \"provider\": \"deepgram\",\n \"min_endpointing_delay\": 0.3,\n \"max_endpointing_delay\": 0.4\n },\n \"tts\": {\n \"model_id\": \"eleven_turbo_v2_5\",\n \"provider\": \"elevenlabs\",\n \"voice_id\": \"ZUrEGyu8GFMwnHbvLhv2\"\n }\n }\n }\n ],\n \"callback_events\": [\n \"participant_left\",\n \"agent.started_speaking\",\n \"agent.stopped_speaking\",\n \"agent.interrupted\",\n \"user.started_speaking\",\n \"user.stopped_speaking\",\n \"utterance_committed\",\n \"max_call_duration_timeout\"\n ],\n \"callback_url\": \"\",\n \"config\": {\n \"maxCallDuration\": 1800,\n \"conversationalContext\": \"customer-support\",\n \"memory\": {\n \"isEnabled\": false,\n \"instruction\": \"sample memory instruction for the agent\"\n }\n },\n \"knowledge_base\": [\n {\n \"id\": \"ac79226e-73e1-41fe-8cde-469ae4e244fa\",\n \"name\": \"Product Support Articles\",\n \"description\": \"Contains FAQs and troubleshooting guides for product lines.\"\n }\n ],\n \"record\": true,\n \"is_active\": true,\n \"created_at\": \"2025-12-01T10:20:30.000Z\",\n \"updated_at\": \"2025-12-03T14:50:00.000Z\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.trugen.ai/v1/ext/agent/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": \"b63c2a53-266b-4b43-a71b-7ea8b5e2e916\",\n \"agent_name\": \"Customer Support Agent\",\n \"agent_system_prompt\": \"You are a helpful AI assistant that handles customer service inquiries.\",\n \"avatars\": [\n {\n \"avatar_key_id\": \"1e4ea106\",\n \"persona_name\": \"Sofia - Friendly Support\",\n \"persona_prompt\": \"Speak in a warm, engaging tone and provide clear answers.\",\n \"config\": {\n \"llm\": {\n \"model\": \"meta-llama/llama-4-maverick-17b-128e-instruct\",\n \"provider\": \"groq\"\n },\n \"stt\": {\n \"model\": \"flux-general-en\",\n \"provider\": \"deepgram\",\n \"min_endpointing_delay\": 0.3,\n \"max_endpointing_delay\": 0.4\n },\n \"tts\": {\n \"model_id\": \"eleven_turbo_v2_5\",\n \"provider\": \"elevenlabs\",\n \"voice_id\": \"ZUrEGyu8GFMwnHbvLhv2\"\n }\n }\n }\n ],\n \"callback_events\": [\n \"participant_left\",\n \"agent.started_speaking\",\n \"agent.stopped_speaking\",\n \"agent.interrupted\",\n \"user.started_speaking\",\n \"user.stopped_speaking\",\n \"utterance_committed\",\n \"max_call_duration_timeout\"\n ],\n \"callback_url\": \"\",\n \"config\": {\n \"maxCallDuration\": 1800,\n \"conversationalContext\": \"customer-support\",\n \"memory\": {\n \"isEnabled\": false,\n \"instruction\": \"sample memory instruction for the agent\"\n }\n },\n \"knowledge_base\": [\n {\n \"id\": \"ac79226e-73e1-41fe-8cde-469ae4e244fa\",\n \"name\": \"Product Support Articles\",\n \"description\": \"Contains FAQs and troubleshooting guides for product lines.\"\n }\n ],\n \"record\": true,\n \"is_active\": true,\n \"created_at\": \"2025-12-01T10:20:30.000Z\",\n \"updated_at\": \"2025-12-03T14:50:00.000Z\"\n}"
response = http.request(request)
puts response.read_body{
"id": "098f083e-64c3-4c84-b3af-1b3e0b2538b3",
"message": "Agent updated successfully"
}{
"error": "Invalid request body"
}{
"error": "Unauthorized: not a valid authorization api key"
}{
"message": "Agent details not found"
}{
"error": "Failed to update agent"
}Update Agent
Updates an Agent with new avatar, knowledge base, or system settings.
curl --request PUT \
--url https://api.trugen.ai/v1/ext/agent/{id} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"id": "b63c2a53-266b-4b43-a71b-7ea8b5e2e916",
"agent_name": "Customer Support Agent",
"agent_system_prompt": "You are a helpful AI assistant that handles customer service inquiries.",
"avatars": [
{
"avatar_key_id": "1e4ea106",
"persona_name": "Sofia - Friendly Support",
"persona_prompt": "Speak in a warm, engaging tone and provide clear answers.",
"config": {
"llm": {
"model": "meta-llama/llama-4-maverick-17b-128e-instruct",
"provider": "groq"
},
"stt": {
"model": "flux-general-en",
"provider": "deepgram",
"min_endpointing_delay": 0.3,
"max_endpointing_delay": 0.4
},
"tts": {
"model_id": "eleven_turbo_v2_5",
"provider": "elevenlabs",
"voice_id": "ZUrEGyu8GFMwnHbvLhv2"
}
}
}
],
"callback_events": [
"participant_left",
"agent.started_speaking",
"agent.stopped_speaking",
"agent.interrupted",
"user.started_speaking",
"user.stopped_speaking",
"utterance_committed",
"max_call_duration_timeout"
],
"callback_url": "",
"config": {
"maxCallDuration": 1800,
"conversationalContext": "customer-support",
"memory": {
"isEnabled": false,
"instruction": "sample memory instruction for the agent"
}
},
"knowledge_base": [
{
"id": "ac79226e-73e1-41fe-8cde-469ae4e244fa",
"name": "Product Support Articles",
"description": "Contains FAQs and troubleshooting guides for product lines."
}
],
"record": true,
"is_active": true,
"created_at": "2025-12-01T10:20:30.000Z",
"updated_at": "2025-12-03T14:50:00.000Z"
}
'import requests
url = "https://api.trugen.ai/v1/ext/agent/{id}"
payload = {
"id": "b63c2a53-266b-4b43-a71b-7ea8b5e2e916",
"agent_name": "Customer Support Agent",
"agent_system_prompt": "You are a helpful AI assistant that handles customer service inquiries.",
"avatars": [
{
"avatar_key_id": "1e4ea106",
"persona_name": "Sofia - Friendly Support",
"persona_prompt": "Speak in a warm, engaging tone and provide clear answers.",
"config": {
"llm": {
"model": "meta-llama/llama-4-maverick-17b-128e-instruct",
"provider": "groq"
},
"stt": {
"model": "flux-general-en",
"provider": "deepgram",
"min_endpointing_delay": 0.3,
"max_endpointing_delay": 0.4
},
"tts": {
"model_id": "eleven_turbo_v2_5",
"provider": "elevenlabs",
"voice_id": "ZUrEGyu8GFMwnHbvLhv2"
}
}
}
],
"callback_events": ["participant_left", "agent.started_speaking", "agent.stopped_speaking", "agent.interrupted", "user.started_speaking", "user.stopped_speaking", "utterance_committed", "max_call_duration_timeout"],
"callback_url": "",
"config": {
"maxCallDuration": 1800,
"conversationalContext": "customer-support",
"memory": {
"isEnabled": False,
"instruction": "sample memory instruction for the agent"
}
},
"knowledge_base": [
{
"id": "ac79226e-73e1-41fe-8cde-469ae4e244fa",
"name": "Product Support Articles",
"description": "Contains FAQs and troubleshooting guides for product lines."
}
],
"record": True,
"is_active": True,
"created_at": "2025-12-01T10:20:30.000Z",
"updated_at": "2025-12-03T14:50:00.000Z"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
id: 'b63c2a53-266b-4b43-a71b-7ea8b5e2e916',
agent_name: 'Customer Support Agent',
agent_system_prompt: 'You are a helpful AI assistant that handles customer service inquiries.',
avatars: [
{
avatar_key_id: '1e4ea106',
persona_name: 'Sofia - Friendly Support',
persona_prompt: 'Speak in a warm, engaging tone and provide clear answers.',
config: {
llm: {model: 'meta-llama/llama-4-maverick-17b-128e-instruct', provider: 'groq'},
stt: {
model: 'flux-general-en',
provider: 'deepgram',
min_endpointing_delay: 0.3,
max_endpointing_delay: 0.4
},
tts: {
model_id: 'eleven_turbo_v2_5',
provider: 'elevenlabs',
voice_id: 'ZUrEGyu8GFMwnHbvLhv2'
}
}
}
],
callback_events: [
'participant_left',
'agent.started_speaking',
'agent.stopped_speaking',
'agent.interrupted',
'user.started_speaking',
'user.stopped_speaking',
'utterance_committed',
'max_call_duration_timeout'
],
callback_url: '',
config: {
maxCallDuration: 1800,
conversationalContext: 'customer-support',
memory: {isEnabled: false, instruction: 'sample memory instruction for the agent'}
},
knowledge_base: [
{
id: 'ac79226e-73e1-41fe-8cde-469ae4e244fa',
name: 'Product Support Articles',
description: 'Contains FAQs and troubleshooting guides for product lines.'
}
],
record: true,
is_active: true,
created_at: '2025-12-01T10:20:30.000Z',
updated_at: '2025-12-03T14:50:00.000Z'
})
};
fetch('https://api.trugen.ai/v1/ext/agent/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.trugen.ai/v1/ext/agent/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'id' => 'b63c2a53-266b-4b43-a71b-7ea8b5e2e916',
'agent_name' => 'Customer Support Agent',
'agent_system_prompt' => 'You are a helpful AI assistant that handles customer service inquiries.',
'avatars' => [
[
'avatar_key_id' => '1e4ea106',
'persona_name' => 'Sofia - Friendly Support',
'persona_prompt' => 'Speak in a warm, engaging tone and provide clear answers.',
'config' => [
'llm' => [
'model' => 'meta-llama/llama-4-maverick-17b-128e-instruct',
'provider' => 'groq'
],
'stt' => [
'model' => 'flux-general-en',
'provider' => 'deepgram',
'min_endpointing_delay' => 0.3,
'max_endpointing_delay' => 0.4
],
'tts' => [
'model_id' => 'eleven_turbo_v2_5',
'provider' => 'elevenlabs',
'voice_id' => 'ZUrEGyu8GFMwnHbvLhv2'
]
]
]
],
'callback_events' => [
'participant_left',
'agent.started_speaking',
'agent.stopped_speaking',
'agent.interrupted',
'user.started_speaking',
'user.stopped_speaking',
'utterance_committed',
'max_call_duration_timeout'
],
'callback_url' => '',
'config' => [
'maxCallDuration' => 1800,
'conversationalContext' => 'customer-support',
'memory' => [
'isEnabled' => false,
'instruction' => 'sample memory instruction for the agent'
]
],
'knowledge_base' => [
[
'id' => 'ac79226e-73e1-41fe-8cde-469ae4e244fa',
'name' => 'Product Support Articles',
'description' => 'Contains FAQs and troubleshooting guides for product lines.'
]
],
'record' => true,
'is_active' => true,
'created_at' => '2025-12-01T10:20:30.000Z',
'updated_at' => '2025-12-03T14:50:00.000Z'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$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.trugen.ai/v1/ext/agent/{id}"
payload := strings.NewReader("{\n \"id\": \"b63c2a53-266b-4b43-a71b-7ea8b5e2e916\",\n \"agent_name\": \"Customer Support Agent\",\n \"agent_system_prompt\": \"You are a helpful AI assistant that handles customer service inquiries.\",\n \"avatars\": [\n {\n \"avatar_key_id\": \"1e4ea106\",\n \"persona_name\": \"Sofia - Friendly Support\",\n \"persona_prompt\": \"Speak in a warm, engaging tone and provide clear answers.\",\n \"config\": {\n \"llm\": {\n \"model\": \"meta-llama/llama-4-maverick-17b-128e-instruct\",\n \"provider\": \"groq\"\n },\n \"stt\": {\n \"model\": \"flux-general-en\",\n \"provider\": \"deepgram\",\n \"min_endpointing_delay\": 0.3,\n \"max_endpointing_delay\": 0.4\n },\n \"tts\": {\n \"model_id\": \"eleven_turbo_v2_5\",\n \"provider\": \"elevenlabs\",\n \"voice_id\": \"ZUrEGyu8GFMwnHbvLhv2\"\n }\n }\n }\n ],\n \"callback_events\": [\n \"participant_left\",\n \"agent.started_speaking\",\n \"agent.stopped_speaking\",\n \"agent.interrupted\",\n \"user.started_speaking\",\n \"user.stopped_speaking\",\n \"utterance_committed\",\n \"max_call_duration_timeout\"\n ],\n \"callback_url\": \"\",\n \"config\": {\n \"maxCallDuration\": 1800,\n \"conversationalContext\": \"customer-support\",\n \"memory\": {\n \"isEnabled\": false,\n \"instruction\": \"sample memory instruction for the agent\"\n }\n },\n \"knowledge_base\": [\n {\n \"id\": \"ac79226e-73e1-41fe-8cde-469ae4e244fa\",\n \"name\": \"Product Support Articles\",\n \"description\": \"Contains FAQs and troubleshooting guides for product lines.\"\n }\n ],\n \"record\": true,\n \"is_active\": true,\n \"created_at\": \"2025-12-01T10:20:30.000Z\",\n \"updated_at\": \"2025-12-03T14:50:00.000Z\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("x-api-key", "<api-key>")
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.put("https://api.trugen.ai/v1/ext/agent/{id}")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"id\": \"b63c2a53-266b-4b43-a71b-7ea8b5e2e916\",\n \"agent_name\": \"Customer Support Agent\",\n \"agent_system_prompt\": \"You are a helpful AI assistant that handles customer service inquiries.\",\n \"avatars\": [\n {\n \"avatar_key_id\": \"1e4ea106\",\n \"persona_name\": \"Sofia - Friendly Support\",\n \"persona_prompt\": \"Speak in a warm, engaging tone and provide clear answers.\",\n \"config\": {\n \"llm\": {\n \"model\": \"meta-llama/llama-4-maverick-17b-128e-instruct\",\n \"provider\": \"groq\"\n },\n \"stt\": {\n \"model\": \"flux-general-en\",\n \"provider\": \"deepgram\",\n \"min_endpointing_delay\": 0.3,\n \"max_endpointing_delay\": 0.4\n },\n \"tts\": {\n \"model_id\": \"eleven_turbo_v2_5\",\n \"provider\": \"elevenlabs\",\n \"voice_id\": \"ZUrEGyu8GFMwnHbvLhv2\"\n }\n }\n }\n ],\n \"callback_events\": [\n \"participant_left\",\n \"agent.started_speaking\",\n \"agent.stopped_speaking\",\n \"agent.interrupted\",\n \"user.started_speaking\",\n \"user.stopped_speaking\",\n \"utterance_committed\",\n \"max_call_duration_timeout\"\n ],\n \"callback_url\": \"\",\n \"config\": {\n \"maxCallDuration\": 1800,\n \"conversationalContext\": \"customer-support\",\n \"memory\": {\n \"isEnabled\": false,\n \"instruction\": \"sample memory instruction for the agent\"\n }\n },\n \"knowledge_base\": [\n {\n \"id\": \"ac79226e-73e1-41fe-8cde-469ae4e244fa\",\n \"name\": \"Product Support Articles\",\n \"description\": \"Contains FAQs and troubleshooting guides for product lines.\"\n }\n ],\n \"record\": true,\n \"is_active\": true,\n \"created_at\": \"2025-12-01T10:20:30.000Z\",\n \"updated_at\": \"2025-12-03T14:50:00.000Z\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.trugen.ai/v1/ext/agent/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": \"b63c2a53-266b-4b43-a71b-7ea8b5e2e916\",\n \"agent_name\": \"Customer Support Agent\",\n \"agent_system_prompt\": \"You are a helpful AI assistant that handles customer service inquiries.\",\n \"avatars\": [\n {\n \"avatar_key_id\": \"1e4ea106\",\n \"persona_name\": \"Sofia - Friendly Support\",\n \"persona_prompt\": \"Speak in a warm, engaging tone and provide clear answers.\",\n \"config\": {\n \"llm\": {\n \"model\": \"meta-llama/llama-4-maverick-17b-128e-instruct\",\n \"provider\": \"groq\"\n },\n \"stt\": {\n \"model\": \"flux-general-en\",\n \"provider\": \"deepgram\",\n \"min_endpointing_delay\": 0.3,\n \"max_endpointing_delay\": 0.4\n },\n \"tts\": {\n \"model_id\": \"eleven_turbo_v2_5\",\n \"provider\": \"elevenlabs\",\n \"voice_id\": \"ZUrEGyu8GFMwnHbvLhv2\"\n }\n }\n }\n ],\n \"callback_events\": [\n \"participant_left\",\n \"agent.started_speaking\",\n \"agent.stopped_speaking\",\n \"agent.interrupted\",\n \"user.started_speaking\",\n \"user.stopped_speaking\",\n \"utterance_committed\",\n \"max_call_duration_timeout\"\n ],\n \"callback_url\": \"\",\n \"config\": {\n \"maxCallDuration\": 1800,\n \"conversationalContext\": \"customer-support\",\n \"memory\": {\n \"isEnabled\": false,\n \"instruction\": \"sample memory instruction for the agent\"\n }\n },\n \"knowledge_base\": [\n {\n \"id\": \"ac79226e-73e1-41fe-8cde-469ae4e244fa\",\n \"name\": \"Product Support Articles\",\n \"description\": \"Contains FAQs and troubleshooting guides for product lines.\"\n }\n ],\n \"record\": true,\n \"is_active\": true,\n \"created_at\": \"2025-12-01T10:20:30.000Z\",\n \"updated_at\": \"2025-12-03T14:50:00.000Z\"\n}"
response = http.request(request)
puts response.read_body{
"id": "098f083e-64c3-4c84-b3af-1b3e0b2538b3",
"message": "Agent updated successfully"
}{
"error": "Invalid request body"
}{
"error": "Unauthorized: not a valid authorization api key"
}{
"message": "Agent details not found"
}{
"error": "Failed to update agent"
}Authorizations
Path Parameters
Unique identifier for the Agent
Body
Display name of the agent.
"Customer Support Agent"
Foundational system instruction used by this agent.
"You are a helpful AI assistant that handles customer service inquiries."
List of avatars associated with this agent.
Show child attributes
Show child attributes
Webhook events that should trigger callbacks.
[
"participant_left",
"agent.started_speaking",
"agent.stopped_speaking",
"agent.interrupted",
"user.started_speaking",
"user.stopped_speaking",
"utterance_committed",
"max_call_duration_timeout"
]
Webhook endpoint URL to send callback events to.
"https://webhooks.example.com/agent-events"
Agent-level configuration properties.
Show child attributes
Show child attributes
List of knowledge bases attached to this agent.
Show child attributes
Show child attributes
List of tools attached to this agent.
Show child attributes
Show child attributes
List of MCPs attached to this agent.
Show child attributes
Show child attributes
Determines whether voice call recordings should be stored.
true
Determines whether this record is active or not.
true
Timestamp indicating when the agent was created.
"2025-12-01T10:20:30.000Z"
Last updated timestamp for the agent.
"2025-12-03T14:50:00.000Z"
Was this page helpful?