Update agent
Patch metadata fields (name, description, categories, avatarUrl). Use null to clear nullable fields. Status transitions are NOT done via PATCH — use publish.
curl --request PATCH \
--url https://api.gennia.ai/public/api/v1/agents/{agentPublicId} \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"aiModelPublicId": "9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21",
"audioListeningEnabled": false,
"audioResponseEnabled": false,
"avatarUrl": "https://cdn.example.com/avatars/support-bot.png",
"categories": [
"support",
"billing"
],
"description": "Answers questions about billing, refunds and account access.",
"dynamicPromptEnabled": true,
"followUpAfterHours": 24,
"followUpBusinessHoursEnd": "18:00:00",
"followUpBusinessHoursStart": "09:00:00",
"followUpEnabled": false,
"followUpInactivityMinutes": 30,
"followUpIntervalMinutes": 60,
"followUpMaxAttempts": 3,
"followUpPrompt": "Politely check whether the customer still needs help.",
"genuiEnabled": false,
"longTermMemoryEnabled": false,
"memoryCustomInstructions": "Remember customer preferences and prior issues.",
"messageDelayEnabled": false,
"messageDelayType": {
"present": true
},
"messageSplittingEnabled": true,
"name": "Support Bot",
"sandboxEnabled": false,
"systemPrompt": "You are a friendly support agent for Acme Corp.",
"temperature": 0.7,
"thinkingEffort": "medium",
"thinkingEnabled": true,
"ttsVoice": "alloy",
"webSearchEnabled": true
}
'import requests
url = "https://api.gennia.ai/public/api/v1/agents/{agentPublicId}"
payload = {
"aiModelPublicId": "9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21",
"audioListeningEnabled": False,
"audioResponseEnabled": False,
"avatarUrl": "https://cdn.example.com/avatars/support-bot.png",
"categories": ["support", "billing"],
"description": "Answers questions about billing, refunds and account access.",
"dynamicPromptEnabled": True,
"followUpAfterHours": 24,
"followUpBusinessHoursEnd": "18:00:00",
"followUpBusinessHoursStart": "09:00:00",
"followUpEnabled": False,
"followUpInactivityMinutes": 30,
"followUpIntervalMinutes": 60,
"followUpMaxAttempts": 3,
"followUpPrompt": "Politely check whether the customer still needs help.",
"genuiEnabled": False,
"longTermMemoryEnabled": False,
"memoryCustomInstructions": "Remember customer preferences and prior issues.",
"messageDelayEnabled": False,
"messageDelayType": { "present": True },
"messageSplittingEnabled": True,
"name": "Support Bot",
"sandboxEnabled": False,
"systemPrompt": "You are a friendly support agent for Acme Corp.",
"temperature": 0.7,
"thinkingEffort": "medium",
"thinkingEnabled": True,
"ttsVoice": "alloy",
"webSearchEnabled": True
}
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
aiModelPublicId: '9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21',
audioListeningEnabled: false,
audioResponseEnabled: false,
avatarUrl: 'https://cdn.example.com/avatars/support-bot.png',
categories: ['support', 'billing'],
description: 'Answers questions about billing, refunds and account access.',
dynamicPromptEnabled: true,
followUpAfterHours: 24,
followUpBusinessHoursEnd: '18:00:00',
followUpBusinessHoursStart: '09:00:00',
followUpEnabled: false,
followUpInactivityMinutes: 30,
followUpIntervalMinutes: 60,
followUpMaxAttempts: 3,
followUpPrompt: 'Politely check whether the customer still needs help.',
genuiEnabled: false,
longTermMemoryEnabled: false,
memoryCustomInstructions: 'Remember customer preferences and prior issues.',
messageDelayEnabled: false,
messageDelayType: {present: true},
messageSplittingEnabled: true,
name: 'Support Bot',
sandboxEnabled: false,
systemPrompt: 'You are a friendly support agent for Acme Corp.',
temperature: 0.7,
thinkingEffort: 'medium',
thinkingEnabled: true,
ttsVoice: 'alloy',
webSearchEnabled: true
})
};
fetch('https://api.gennia.ai/public/api/v1/agents/{agentPublicId}', 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.gennia.ai/public/api/v1/agents/{agentPublicId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'aiModelPublicId' => '9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21',
'audioListeningEnabled' => false,
'audioResponseEnabled' => false,
'avatarUrl' => 'https://cdn.example.com/avatars/support-bot.png',
'categories' => [
'support',
'billing'
],
'description' => 'Answers questions about billing, refunds and account access.',
'dynamicPromptEnabled' => true,
'followUpAfterHours' => 24,
'followUpBusinessHoursEnd' => '18:00:00',
'followUpBusinessHoursStart' => '09:00:00',
'followUpEnabled' => false,
'followUpInactivityMinutes' => 30,
'followUpIntervalMinutes' => 60,
'followUpMaxAttempts' => 3,
'followUpPrompt' => 'Politely check whether the customer still needs help.',
'genuiEnabled' => false,
'longTermMemoryEnabled' => false,
'memoryCustomInstructions' => 'Remember customer preferences and prior issues.',
'messageDelayEnabled' => false,
'messageDelayType' => [
'present' => true
],
'messageSplittingEnabled' => true,
'name' => 'Support Bot',
'sandboxEnabled' => false,
'systemPrompt' => 'You are a friendly support agent for Acme Corp.',
'temperature' => 0.7,
'thinkingEffort' => 'medium',
'thinkingEnabled' => true,
'ttsVoice' => 'alloy',
'webSearchEnabled' => true
]),
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.gennia.ai/public/api/v1/agents/{agentPublicId}"
payload := strings.NewReader("{\n \"aiModelPublicId\": \"9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21\",\n \"audioListeningEnabled\": false,\n \"audioResponseEnabled\": false,\n \"avatarUrl\": \"https://cdn.example.com/avatars/support-bot.png\",\n \"categories\": [\n \"support\",\n \"billing\"\n ],\n \"description\": \"Answers questions about billing, refunds and account access.\",\n \"dynamicPromptEnabled\": true,\n \"followUpAfterHours\": 24,\n \"followUpBusinessHoursEnd\": \"18:00:00\",\n \"followUpBusinessHoursStart\": \"09:00:00\",\n \"followUpEnabled\": false,\n \"followUpInactivityMinutes\": 30,\n \"followUpIntervalMinutes\": 60,\n \"followUpMaxAttempts\": 3,\n \"followUpPrompt\": \"Politely check whether the customer still needs help.\",\n \"genuiEnabled\": false,\n \"longTermMemoryEnabled\": false,\n \"memoryCustomInstructions\": \"Remember customer preferences and prior issues.\",\n \"messageDelayEnabled\": false,\n \"messageDelayType\": {\n \"present\": true\n },\n \"messageSplittingEnabled\": true,\n \"name\": \"Support Bot\",\n \"sandboxEnabled\": false,\n \"systemPrompt\": \"You are a friendly support agent for Acme Corp.\",\n \"temperature\": 0.7,\n \"thinkingEffort\": \"medium\",\n \"thinkingEnabled\": true,\n \"ttsVoice\": \"alloy\",\n \"webSearchEnabled\": true\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://api.gennia.ai/public/api/v1/agents/{agentPublicId}")
.header("X-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"aiModelPublicId\": \"9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21\",\n \"audioListeningEnabled\": false,\n \"audioResponseEnabled\": false,\n \"avatarUrl\": \"https://cdn.example.com/avatars/support-bot.png\",\n \"categories\": [\n \"support\",\n \"billing\"\n ],\n \"description\": \"Answers questions about billing, refunds and account access.\",\n \"dynamicPromptEnabled\": true,\n \"followUpAfterHours\": 24,\n \"followUpBusinessHoursEnd\": \"18:00:00\",\n \"followUpBusinessHoursStart\": \"09:00:00\",\n \"followUpEnabled\": false,\n \"followUpInactivityMinutes\": 30,\n \"followUpIntervalMinutes\": 60,\n \"followUpMaxAttempts\": 3,\n \"followUpPrompt\": \"Politely check whether the customer still needs help.\",\n \"genuiEnabled\": false,\n \"longTermMemoryEnabled\": false,\n \"memoryCustomInstructions\": \"Remember customer preferences and prior issues.\",\n \"messageDelayEnabled\": false,\n \"messageDelayType\": {\n \"present\": true\n },\n \"messageSplittingEnabled\": true,\n \"name\": \"Support Bot\",\n \"sandboxEnabled\": false,\n \"systemPrompt\": \"You are a friendly support agent for Acme Corp.\",\n \"temperature\": 0.7,\n \"thinkingEffort\": \"medium\",\n \"thinkingEnabled\": true,\n \"ttsVoice\": \"alloy\",\n \"webSearchEnabled\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gennia.ai/public/api/v1/agents/{agentPublicId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"aiModelPublicId\": \"9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21\",\n \"audioListeningEnabled\": false,\n \"audioResponseEnabled\": false,\n \"avatarUrl\": \"https://cdn.example.com/avatars/support-bot.png\",\n \"categories\": [\n \"support\",\n \"billing\"\n ],\n \"description\": \"Answers questions about billing, refunds and account access.\",\n \"dynamicPromptEnabled\": true,\n \"followUpAfterHours\": 24,\n \"followUpBusinessHoursEnd\": \"18:00:00\",\n \"followUpBusinessHoursStart\": \"09:00:00\",\n \"followUpEnabled\": false,\n \"followUpInactivityMinutes\": 30,\n \"followUpIntervalMinutes\": 60,\n \"followUpMaxAttempts\": 3,\n \"followUpPrompt\": \"Politely check whether the customer still needs help.\",\n \"genuiEnabled\": false,\n \"longTermMemoryEnabled\": false,\n \"memoryCustomInstructions\": \"Remember customer preferences and prior issues.\",\n \"messageDelayEnabled\": false,\n \"messageDelayType\": {\n \"present\": true\n },\n \"messageSplittingEnabled\": true,\n \"name\": \"Support Bot\",\n \"sandboxEnabled\": false,\n \"systemPrompt\": \"You are a friendly support agent for Acme Corp.\",\n \"temperature\": 0.7,\n \"thinkingEffort\": \"medium\",\n \"thinkingEnabled\": true,\n \"ttsVoice\": \"alloy\",\n \"webSearchEnabled\": true\n}"
response = http.request(request)
puts response.read_body{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"audioListeningEnabled": true,
"audioResponseEnabled": true,
"avatarUrl": "<string>",
"categories": [
"<string>"
],
"createdAt": "2023-11-07T05:31:56Z",
"description": "<string>",
"draftVersionNumber": 123,
"dynamicPromptEnabled": true,
"followUpAfterHours": 123,
"followUpBusinessHoursEnd": "14:30:00",
"followUpBusinessHoursStart": "14:30:00",
"followUpEnabled": true,
"followUpInactivityMinutes": 123,
"followUpIntervalMinutes": 123,
"followUpMaxAttempts": 123,
"followUpPrompt": "<string>",
"genuiEnabled": true,
"hasExternalChannel": true,
"hasUnpublishedChanges": true,
"longTermMemoryEnabled": true,
"memoryCustomInstructions": "<string>",
"messageDelayEnabled": true,
"messageSplittingEnabled": true,
"name": "<string>",
"publicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"publishedVersionNumber": 123,
"sandboxEnabled": true,
"systemPrompt": "<string>",
"temperature": 123,
"thinkingEnabled": true,
"ttsVoice": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"webSearchEnabled": true
}{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"audioListeningEnabled": true,
"audioResponseEnabled": true,
"avatarUrl": "<string>",
"categories": [
"<string>"
],
"createdAt": "2023-11-07T05:31:56Z",
"description": "<string>",
"draftVersionNumber": 123,
"dynamicPromptEnabled": true,
"followUpAfterHours": 123,
"followUpBusinessHoursEnd": "14:30:00",
"followUpBusinessHoursStart": "14:30:00",
"followUpEnabled": true,
"followUpInactivityMinutes": 123,
"followUpIntervalMinutes": 123,
"followUpMaxAttempts": 123,
"followUpPrompt": "<string>",
"genuiEnabled": true,
"hasExternalChannel": true,
"hasUnpublishedChanges": true,
"longTermMemoryEnabled": true,
"memoryCustomInstructions": "<string>",
"messageDelayEnabled": true,
"messageSplittingEnabled": true,
"name": "<string>",
"publicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"publishedVersionNumber": 123,
"sandboxEnabled": true,
"systemPrompt": "<string>",
"temperature": 123,
"thinkingEnabled": true,
"ttsVoice": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"webSearchEnabled": true
}{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"audioListeningEnabled": true,
"audioResponseEnabled": true,
"avatarUrl": "<string>",
"categories": [
"<string>"
],
"createdAt": "2023-11-07T05:31:56Z",
"description": "<string>",
"draftVersionNumber": 123,
"dynamicPromptEnabled": true,
"followUpAfterHours": 123,
"followUpBusinessHoursEnd": "14:30:00",
"followUpBusinessHoursStart": "14:30:00",
"followUpEnabled": true,
"followUpInactivityMinutes": 123,
"followUpIntervalMinutes": 123,
"followUpMaxAttempts": 123,
"followUpPrompt": "<string>",
"genuiEnabled": true,
"hasExternalChannel": true,
"hasUnpublishedChanges": true,
"longTermMemoryEnabled": true,
"memoryCustomInstructions": "<string>",
"messageDelayEnabled": true,
"messageSplittingEnabled": true,
"name": "<string>",
"publicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"publishedVersionNumber": 123,
"sandboxEnabled": true,
"systemPrompt": "<string>",
"temperature": 123,
"thinkingEnabled": true,
"ttsVoice": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"webSearchEnabled": true
}{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"audioListeningEnabled": true,
"audioResponseEnabled": true,
"avatarUrl": "<string>",
"categories": [
"<string>"
],
"createdAt": "2023-11-07T05:31:56Z",
"description": "<string>",
"draftVersionNumber": 123,
"dynamicPromptEnabled": true,
"followUpAfterHours": 123,
"followUpBusinessHoursEnd": "14:30:00",
"followUpBusinessHoursStart": "14:30:00",
"followUpEnabled": true,
"followUpInactivityMinutes": 123,
"followUpIntervalMinutes": 123,
"followUpMaxAttempts": 123,
"followUpPrompt": "<string>",
"genuiEnabled": true,
"hasExternalChannel": true,
"hasUnpublishedChanges": true,
"longTermMemoryEnabled": true,
"memoryCustomInstructions": "<string>",
"messageDelayEnabled": true,
"messageSplittingEnabled": true,
"name": "<string>",
"publicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"publishedVersionNumber": 123,
"sandboxEnabled": true,
"systemPrompt": "<string>",
"temperature": 123,
"thinkingEnabled": true,
"ttsVoice": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"webSearchEnabled": true
}{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"audioListeningEnabled": true,
"audioResponseEnabled": true,
"avatarUrl": "<string>",
"categories": [
"<string>"
],
"createdAt": "2023-11-07T05:31:56Z",
"description": "<string>",
"draftVersionNumber": 123,
"dynamicPromptEnabled": true,
"followUpAfterHours": 123,
"followUpBusinessHoursEnd": "14:30:00",
"followUpBusinessHoursStart": "14:30:00",
"followUpEnabled": true,
"followUpInactivityMinutes": 123,
"followUpIntervalMinutes": 123,
"followUpMaxAttempts": 123,
"followUpPrompt": "<string>",
"genuiEnabled": true,
"hasExternalChannel": true,
"hasUnpublishedChanges": true,
"longTermMemoryEnabled": true,
"memoryCustomInstructions": "<string>",
"messageDelayEnabled": true,
"messageSplittingEnabled": true,
"name": "<string>",
"publicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"publishedVersionNumber": 123,
"sandboxEnabled": true,
"systemPrompt": "<string>",
"temperature": 123,
"thinkingEnabled": true,
"ttsVoice": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"webSearchEnabled": true
}{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"audioListeningEnabled": true,
"audioResponseEnabled": true,
"avatarUrl": "<string>",
"categories": [
"<string>"
],
"createdAt": "2023-11-07T05:31:56Z",
"description": "<string>",
"draftVersionNumber": 123,
"dynamicPromptEnabled": true,
"followUpAfterHours": 123,
"followUpBusinessHoursEnd": "14:30:00",
"followUpBusinessHoursStart": "14:30:00",
"followUpEnabled": true,
"followUpInactivityMinutes": 123,
"followUpIntervalMinutes": 123,
"followUpMaxAttempts": 123,
"followUpPrompt": "<string>",
"genuiEnabled": true,
"hasExternalChannel": true,
"hasUnpublishedChanges": true,
"longTermMemoryEnabled": true,
"memoryCustomInstructions": "<string>",
"messageDelayEnabled": true,
"messageSplittingEnabled": true,
"name": "<string>",
"publicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"publishedVersionNumber": 123,
"sandboxEnabled": true,
"systemPrompt": "<string>",
"temperature": 123,
"thinkingEnabled": true,
"ttsVoice": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"webSearchEnabled": true
}Autorizações
Parâmetros de caminho
Corpo
Body for updating an agent. All fields are independently optional; JsonNullable fields are tri-state (omit, set, or clear with null). Unknown fields are rejected with 400.
Public ID of the AI model to use.
Show child attributes
Show child attributes
"9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21"
Enable audio listening (speech-to-text).
Show child attributes
Show child attributes
false
Enable audio responses (text-to-speech).
Show child attributes
Show child attributes
false
New avatar URL (http or https).
Show child attributes
Show child attributes
"https://cdn.example.com/avatars/support-bot.png"
Up to 10 free-form category tags. Each tag must not exceed 100 characters.
10100["support", "billing"]
New short description shown in the agent catalogue.
Show child attributes
Show child attributes
"Answers questions about billing, refunds and account access."
Enable dynamic prompt variables for this agent.
Show child attributes
Show child attributes
true
Hours of inactivity before the first follow-up is sent (0..720).
Show child attributes
Show child attributes
24
End of the business-hours window for follow-ups.
Show child attributes
Show child attributes
"18:00:00"
Start of the business-hours window for follow-ups.
Show child attributes
Show child attributes
"09:00:00"
Enable proactive follow-up messages after inactivity.
Show child attributes
Show child attributes
false
Minutes of inactivity considered idle for follow-up logic (1..1440).
Show child attributes
Show child attributes
30
Minutes between follow-up attempts (1..10080).
Show child attributes
Show child attributes
60
Maximum number of follow-up attempts per conversation (1..10).
Show child attributes
Show child attributes
3
Prompt used to generate follow-up messages.
Show child attributes
Show child attributes
"Politely check whether the customer still needs help."
Enable generative UI responses.
Show child attributes
Show child attributes
false
Enable persistent long-term memory across conversations.
Show child attributes
Show child attributes
false
Custom instructions guiding what the agent should remember.
Show child attributes
Show child attributes
"Remember customer preferences and prior issues."
Insert artificial delay between messages to feel more natural.
Show child attributes
Show child attributes
false
Strategy used to compute the inter-message delay.
Show child attributes
Show child attributes
Split long responses into multiple messages.
Show child attributes
Show child attributes
true
New display name of the agent.
1 - 150"Support Bot"
Enable the sandbox (computer) tool for this agent.
Show child attributes
Show child attributes
false
New system prompt content.
Show child attributes
Show child attributes
"You are a friendly support agent for Acme Corp."
Sampling temperature between 0.0 and 2.0.
Show child attributes
Show child attributes
0.7
Reasoning effort level when thinking is enabled.
Show child attributes
Show child attributes
"medium"
Enable extended thinking for reasoning-capable models.
Show child attributes
Show child attributes
true
TTS voice identifier used when audio responses are enabled.
Show child attributes
Show child attributes
"alloy"
Enable the web-search tool for this agent.
Show child attributes
Show child attributes
true
Resposta
OK
Agent metadata + editable-state configuration.
Selected AI model display name; null when not yet configured.
Selected AI model public ID; null when not yet configured.
"14:30:00"
"14:30:00"
True if the editable state differs from the published snapshot.
Delay tier when messageDelayEnabled=true.
LOW, MEDIUM, HIGH, RANDOM draft, active, inactive, archived Thinking effort tier.
low, medium, high Esta página foi útil?
curl --request PATCH \
--url https://api.gennia.ai/public/api/v1/agents/{agentPublicId} \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"aiModelPublicId": "9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21",
"audioListeningEnabled": false,
"audioResponseEnabled": false,
"avatarUrl": "https://cdn.example.com/avatars/support-bot.png",
"categories": [
"support",
"billing"
],
"description": "Answers questions about billing, refunds and account access.",
"dynamicPromptEnabled": true,
"followUpAfterHours": 24,
"followUpBusinessHoursEnd": "18:00:00",
"followUpBusinessHoursStart": "09:00:00",
"followUpEnabled": false,
"followUpInactivityMinutes": 30,
"followUpIntervalMinutes": 60,
"followUpMaxAttempts": 3,
"followUpPrompt": "Politely check whether the customer still needs help.",
"genuiEnabled": false,
"longTermMemoryEnabled": false,
"memoryCustomInstructions": "Remember customer preferences and prior issues.",
"messageDelayEnabled": false,
"messageDelayType": {
"present": true
},
"messageSplittingEnabled": true,
"name": "Support Bot",
"sandboxEnabled": false,
"systemPrompt": "You are a friendly support agent for Acme Corp.",
"temperature": 0.7,
"thinkingEffort": "medium",
"thinkingEnabled": true,
"ttsVoice": "alloy",
"webSearchEnabled": true
}
'import requests
url = "https://api.gennia.ai/public/api/v1/agents/{agentPublicId}"
payload = {
"aiModelPublicId": "9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21",
"audioListeningEnabled": False,
"audioResponseEnabled": False,
"avatarUrl": "https://cdn.example.com/avatars/support-bot.png",
"categories": ["support", "billing"],
"description": "Answers questions about billing, refunds and account access.",
"dynamicPromptEnabled": True,
"followUpAfterHours": 24,
"followUpBusinessHoursEnd": "18:00:00",
"followUpBusinessHoursStart": "09:00:00",
"followUpEnabled": False,
"followUpInactivityMinutes": 30,
"followUpIntervalMinutes": 60,
"followUpMaxAttempts": 3,
"followUpPrompt": "Politely check whether the customer still needs help.",
"genuiEnabled": False,
"longTermMemoryEnabled": False,
"memoryCustomInstructions": "Remember customer preferences and prior issues.",
"messageDelayEnabled": False,
"messageDelayType": { "present": True },
"messageSplittingEnabled": True,
"name": "Support Bot",
"sandboxEnabled": False,
"systemPrompt": "You are a friendly support agent for Acme Corp.",
"temperature": 0.7,
"thinkingEffort": "medium",
"thinkingEnabled": True,
"ttsVoice": "alloy",
"webSearchEnabled": True
}
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
aiModelPublicId: '9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21',
audioListeningEnabled: false,
audioResponseEnabled: false,
avatarUrl: 'https://cdn.example.com/avatars/support-bot.png',
categories: ['support', 'billing'],
description: 'Answers questions about billing, refunds and account access.',
dynamicPromptEnabled: true,
followUpAfterHours: 24,
followUpBusinessHoursEnd: '18:00:00',
followUpBusinessHoursStart: '09:00:00',
followUpEnabled: false,
followUpInactivityMinutes: 30,
followUpIntervalMinutes: 60,
followUpMaxAttempts: 3,
followUpPrompt: 'Politely check whether the customer still needs help.',
genuiEnabled: false,
longTermMemoryEnabled: false,
memoryCustomInstructions: 'Remember customer preferences and prior issues.',
messageDelayEnabled: false,
messageDelayType: {present: true},
messageSplittingEnabled: true,
name: 'Support Bot',
sandboxEnabled: false,
systemPrompt: 'You are a friendly support agent for Acme Corp.',
temperature: 0.7,
thinkingEffort: 'medium',
thinkingEnabled: true,
ttsVoice: 'alloy',
webSearchEnabled: true
})
};
fetch('https://api.gennia.ai/public/api/v1/agents/{agentPublicId}', 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.gennia.ai/public/api/v1/agents/{agentPublicId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'aiModelPublicId' => '9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21',
'audioListeningEnabled' => false,
'audioResponseEnabled' => false,
'avatarUrl' => 'https://cdn.example.com/avatars/support-bot.png',
'categories' => [
'support',
'billing'
],
'description' => 'Answers questions about billing, refunds and account access.',
'dynamicPromptEnabled' => true,
'followUpAfterHours' => 24,
'followUpBusinessHoursEnd' => '18:00:00',
'followUpBusinessHoursStart' => '09:00:00',
'followUpEnabled' => false,
'followUpInactivityMinutes' => 30,
'followUpIntervalMinutes' => 60,
'followUpMaxAttempts' => 3,
'followUpPrompt' => 'Politely check whether the customer still needs help.',
'genuiEnabled' => false,
'longTermMemoryEnabled' => false,
'memoryCustomInstructions' => 'Remember customer preferences and prior issues.',
'messageDelayEnabled' => false,
'messageDelayType' => [
'present' => true
],
'messageSplittingEnabled' => true,
'name' => 'Support Bot',
'sandboxEnabled' => false,
'systemPrompt' => 'You are a friendly support agent for Acme Corp.',
'temperature' => 0.7,
'thinkingEffort' => 'medium',
'thinkingEnabled' => true,
'ttsVoice' => 'alloy',
'webSearchEnabled' => true
]),
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.gennia.ai/public/api/v1/agents/{agentPublicId}"
payload := strings.NewReader("{\n \"aiModelPublicId\": \"9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21\",\n \"audioListeningEnabled\": false,\n \"audioResponseEnabled\": false,\n \"avatarUrl\": \"https://cdn.example.com/avatars/support-bot.png\",\n \"categories\": [\n \"support\",\n \"billing\"\n ],\n \"description\": \"Answers questions about billing, refunds and account access.\",\n \"dynamicPromptEnabled\": true,\n \"followUpAfterHours\": 24,\n \"followUpBusinessHoursEnd\": \"18:00:00\",\n \"followUpBusinessHoursStart\": \"09:00:00\",\n \"followUpEnabled\": false,\n \"followUpInactivityMinutes\": 30,\n \"followUpIntervalMinutes\": 60,\n \"followUpMaxAttempts\": 3,\n \"followUpPrompt\": \"Politely check whether the customer still needs help.\",\n \"genuiEnabled\": false,\n \"longTermMemoryEnabled\": false,\n \"memoryCustomInstructions\": \"Remember customer preferences and prior issues.\",\n \"messageDelayEnabled\": false,\n \"messageDelayType\": {\n \"present\": true\n },\n \"messageSplittingEnabled\": true,\n \"name\": \"Support Bot\",\n \"sandboxEnabled\": false,\n \"systemPrompt\": \"You are a friendly support agent for Acme Corp.\",\n \"temperature\": 0.7,\n \"thinkingEffort\": \"medium\",\n \"thinkingEnabled\": true,\n \"ttsVoice\": \"alloy\",\n \"webSearchEnabled\": true\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://api.gennia.ai/public/api/v1/agents/{agentPublicId}")
.header("X-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"aiModelPublicId\": \"9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21\",\n \"audioListeningEnabled\": false,\n \"audioResponseEnabled\": false,\n \"avatarUrl\": \"https://cdn.example.com/avatars/support-bot.png\",\n \"categories\": [\n \"support\",\n \"billing\"\n ],\n \"description\": \"Answers questions about billing, refunds and account access.\",\n \"dynamicPromptEnabled\": true,\n \"followUpAfterHours\": 24,\n \"followUpBusinessHoursEnd\": \"18:00:00\",\n \"followUpBusinessHoursStart\": \"09:00:00\",\n \"followUpEnabled\": false,\n \"followUpInactivityMinutes\": 30,\n \"followUpIntervalMinutes\": 60,\n \"followUpMaxAttempts\": 3,\n \"followUpPrompt\": \"Politely check whether the customer still needs help.\",\n \"genuiEnabled\": false,\n \"longTermMemoryEnabled\": false,\n \"memoryCustomInstructions\": \"Remember customer preferences and prior issues.\",\n \"messageDelayEnabled\": false,\n \"messageDelayType\": {\n \"present\": true\n },\n \"messageSplittingEnabled\": true,\n \"name\": \"Support Bot\",\n \"sandboxEnabled\": false,\n \"systemPrompt\": \"You are a friendly support agent for Acme Corp.\",\n \"temperature\": 0.7,\n \"thinkingEffort\": \"medium\",\n \"thinkingEnabled\": true,\n \"ttsVoice\": \"alloy\",\n \"webSearchEnabled\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gennia.ai/public/api/v1/agents/{agentPublicId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"aiModelPublicId\": \"9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21\",\n \"audioListeningEnabled\": false,\n \"audioResponseEnabled\": false,\n \"avatarUrl\": \"https://cdn.example.com/avatars/support-bot.png\",\n \"categories\": [\n \"support\",\n \"billing\"\n ],\n \"description\": \"Answers questions about billing, refunds and account access.\",\n \"dynamicPromptEnabled\": true,\n \"followUpAfterHours\": 24,\n \"followUpBusinessHoursEnd\": \"18:00:00\",\n \"followUpBusinessHoursStart\": \"09:00:00\",\n \"followUpEnabled\": false,\n \"followUpInactivityMinutes\": 30,\n \"followUpIntervalMinutes\": 60,\n \"followUpMaxAttempts\": 3,\n \"followUpPrompt\": \"Politely check whether the customer still needs help.\",\n \"genuiEnabled\": false,\n \"longTermMemoryEnabled\": false,\n \"memoryCustomInstructions\": \"Remember customer preferences and prior issues.\",\n \"messageDelayEnabled\": false,\n \"messageDelayType\": {\n \"present\": true\n },\n \"messageSplittingEnabled\": true,\n \"name\": \"Support Bot\",\n \"sandboxEnabled\": false,\n \"systemPrompt\": \"You are a friendly support agent for Acme Corp.\",\n \"temperature\": 0.7,\n \"thinkingEffort\": \"medium\",\n \"thinkingEnabled\": true,\n \"ttsVoice\": \"alloy\",\n \"webSearchEnabled\": true\n}"
response = http.request(request)
puts response.read_body{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"audioListeningEnabled": true,
"audioResponseEnabled": true,
"avatarUrl": "<string>",
"categories": [
"<string>"
],
"createdAt": "2023-11-07T05:31:56Z",
"description": "<string>",
"draftVersionNumber": 123,
"dynamicPromptEnabled": true,
"followUpAfterHours": 123,
"followUpBusinessHoursEnd": "14:30:00",
"followUpBusinessHoursStart": "14:30:00",
"followUpEnabled": true,
"followUpInactivityMinutes": 123,
"followUpIntervalMinutes": 123,
"followUpMaxAttempts": 123,
"followUpPrompt": "<string>",
"genuiEnabled": true,
"hasExternalChannel": true,
"hasUnpublishedChanges": true,
"longTermMemoryEnabled": true,
"memoryCustomInstructions": "<string>",
"messageDelayEnabled": true,
"messageSplittingEnabled": true,
"name": "<string>",
"publicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"publishedVersionNumber": 123,
"sandboxEnabled": true,
"systemPrompt": "<string>",
"temperature": 123,
"thinkingEnabled": true,
"ttsVoice": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"webSearchEnabled": true
}{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"audioListeningEnabled": true,
"audioResponseEnabled": true,
"avatarUrl": "<string>",
"categories": [
"<string>"
],
"createdAt": "2023-11-07T05:31:56Z",
"description": "<string>",
"draftVersionNumber": 123,
"dynamicPromptEnabled": true,
"followUpAfterHours": 123,
"followUpBusinessHoursEnd": "14:30:00",
"followUpBusinessHoursStart": "14:30:00",
"followUpEnabled": true,
"followUpInactivityMinutes": 123,
"followUpIntervalMinutes": 123,
"followUpMaxAttempts": 123,
"followUpPrompt": "<string>",
"genuiEnabled": true,
"hasExternalChannel": true,
"hasUnpublishedChanges": true,
"longTermMemoryEnabled": true,
"memoryCustomInstructions": "<string>",
"messageDelayEnabled": true,
"messageSplittingEnabled": true,
"name": "<string>",
"publicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"publishedVersionNumber": 123,
"sandboxEnabled": true,
"systemPrompt": "<string>",
"temperature": 123,
"thinkingEnabled": true,
"ttsVoice": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"webSearchEnabled": true
}{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"audioListeningEnabled": true,
"audioResponseEnabled": true,
"avatarUrl": "<string>",
"categories": [
"<string>"
],
"createdAt": "2023-11-07T05:31:56Z",
"description": "<string>",
"draftVersionNumber": 123,
"dynamicPromptEnabled": true,
"followUpAfterHours": 123,
"followUpBusinessHoursEnd": "14:30:00",
"followUpBusinessHoursStart": "14:30:00",
"followUpEnabled": true,
"followUpInactivityMinutes": 123,
"followUpIntervalMinutes": 123,
"followUpMaxAttempts": 123,
"followUpPrompt": "<string>",
"genuiEnabled": true,
"hasExternalChannel": true,
"hasUnpublishedChanges": true,
"longTermMemoryEnabled": true,
"memoryCustomInstructions": "<string>",
"messageDelayEnabled": true,
"messageSplittingEnabled": true,
"name": "<string>",
"publicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"publishedVersionNumber": 123,
"sandboxEnabled": true,
"systemPrompt": "<string>",
"temperature": 123,
"thinkingEnabled": true,
"ttsVoice": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"webSearchEnabled": true
}{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"audioListeningEnabled": true,
"audioResponseEnabled": true,
"avatarUrl": "<string>",
"categories": [
"<string>"
],
"createdAt": "2023-11-07T05:31:56Z",
"description": "<string>",
"draftVersionNumber": 123,
"dynamicPromptEnabled": true,
"followUpAfterHours": 123,
"followUpBusinessHoursEnd": "14:30:00",
"followUpBusinessHoursStart": "14:30:00",
"followUpEnabled": true,
"followUpInactivityMinutes": 123,
"followUpIntervalMinutes": 123,
"followUpMaxAttempts": 123,
"followUpPrompt": "<string>",
"genuiEnabled": true,
"hasExternalChannel": true,
"hasUnpublishedChanges": true,
"longTermMemoryEnabled": true,
"memoryCustomInstructions": "<string>",
"messageDelayEnabled": true,
"messageSplittingEnabled": true,
"name": "<string>",
"publicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"publishedVersionNumber": 123,
"sandboxEnabled": true,
"systemPrompt": "<string>",
"temperature": 123,
"thinkingEnabled": true,
"ttsVoice": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"webSearchEnabled": true
}{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"audioListeningEnabled": true,
"audioResponseEnabled": true,
"avatarUrl": "<string>",
"categories": [
"<string>"
],
"createdAt": "2023-11-07T05:31:56Z",
"description": "<string>",
"draftVersionNumber": 123,
"dynamicPromptEnabled": true,
"followUpAfterHours": 123,
"followUpBusinessHoursEnd": "14:30:00",
"followUpBusinessHoursStart": "14:30:00",
"followUpEnabled": true,
"followUpInactivityMinutes": 123,
"followUpIntervalMinutes": 123,
"followUpMaxAttempts": 123,
"followUpPrompt": "<string>",
"genuiEnabled": true,
"hasExternalChannel": true,
"hasUnpublishedChanges": true,
"longTermMemoryEnabled": true,
"memoryCustomInstructions": "<string>",
"messageDelayEnabled": true,
"messageSplittingEnabled": true,
"name": "<string>",
"publicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"publishedVersionNumber": 123,
"sandboxEnabled": true,
"systemPrompt": "<string>",
"temperature": 123,
"thinkingEnabled": true,
"ttsVoice": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"webSearchEnabled": true
}{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"audioListeningEnabled": true,
"audioResponseEnabled": true,
"avatarUrl": "<string>",
"categories": [
"<string>"
],
"createdAt": "2023-11-07T05:31:56Z",
"description": "<string>",
"draftVersionNumber": 123,
"dynamicPromptEnabled": true,
"followUpAfterHours": 123,
"followUpBusinessHoursEnd": "14:30:00",
"followUpBusinessHoursStart": "14:30:00",
"followUpEnabled": true,
"followUpInactivityMinutes": 123,
"followUpIntervalMinutes": 123,
"followUpMaxAttempts": 123,
"followUpPrompt": "<string>",
"genuiEnabled": true,
"hasExternalChannel": true,
"hasUnpublishedChanges": true,
"longTermMemoryEnabled": true,
"memoryCustomInstructions": "<string>",
"messageDelayEnabled": true,
"messageSplittingEnabled": true,
"name": "<string>",
"publicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"publishedVersionNumber": 123,
"sandboxEnabled": true,
"systemPrompt": "<string>",
"temperature": 123,
"thinkingEnabled": true,
"ttsVoice": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"webSearchEnabled": true
}
