Update agent (partial)
curl --request PATCH \
--url https://api.agents.slng.ai/v1/agents/{agent_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"system_prompt": "<string>",
"greeting": "<string>",
"inbound_greeting": "<string>",
"outbound_greeting": "<string>",
"language": "<string>",
"region": "eu-west",
"world_part_code": "eu-north",
"llm_router_enabled": true,
"idle_nudges": {
"first_nudge_text": "<string>",
"second_nudge_text": "<string>",
"final_hangup_text": "<string>",
"enabled": true,
"first_nudge_delay_seconds": 15,
"second_nudge_delay_seconds": 30,
"hangup_delay_seconds": 15
},
"enable_interruptions": true,
"tool_refs": [
{
"attachment_id": "550e8400-e29b-41d4-a716-446655440000",
"tool_id": "550e8400-e29b-41d4-a716-446655440000",
"version": 2,
"description": "<string>",
"invocation": "model",
"system": {
"triggers": [
{
"source_attachment_id": "550e8400-e29b-41d4-a716-446655440000"
}
],
"arguments": []
},
"execution_policy": {
"pre_action_message": {
"enabled": false,
"text": {
"segments": [
{
"type": "literal",
"value": "<string>"
}
]
},
"wait": false
}
},
"argument_overrides": {},
"config_overrides": {
"type": "api_request",
"url": "<string>"
}
}
],
"mcp_refs": [
{
"attachment_id": "550e8400-e29b-41d4-a716-446655440000",
"server_id": "550e8400-e29b-41d4-a716-446655440000",
"tool_name": "<string>",
"observed_schema_hash": "<string>",
"description": "<string>",
"invocation": "model",
"execution_policy": {
"pre_action_message": {
"enabled": false,
"text": {
"segments": [
{
"type": "literal",
"value": "<string>"
}
]
},
"wait": false
}
},
"argument_overrides": {}
}
],
"sip_inbound_trunk_id": "550e8400-e29b-41d4-a716-446655440000",
"sip_outbound_trunk_id": "550e8400-e29b-41d4-a716-446655440000",
"template_defaults": {},
"template_variable_options": {},
"runtime_variables": [
{
"name": "<string>",
"description": "<string>"
}
]
}
'import requests
url = "https://api.agents.slng.ai/v1/agents/{agent_id}"
payload = {
"name": "<string>",
"system_prompt": "<string>",
"greeting": "<string>",
"inbound_greeting": "<string>",
"outbound_greeting": "<string>",
"language": "<string>",
"region": "eu-west",
"world_part_code": "eu-north",
"llm_router_enabled": True,
"idle_nudges": {
"first_nudge_text": "<string>",
"second_nudge_text": "<string>",
"final_hangup_text": "<string>",
"enabled": True,
"first_nudge_delay_seconds": 15,
"second_nudge_delay_seconds": 30,
"hangup_delay_seconds": 15
},
"enable_interruptions": True,
"tool_refs": [
{
"attachment_id": "550e8400-e29b-41d4-a716-446655440000",
"tool_id": "550e8400-e29b-41d4-a716-446655440000",
"version": 2,
"description": "<string>",
"invocation": "model",
"system": {
"triggers": [{ "source_attachment_id": "550e8400-e29b-41d4-a716-446655440000" }],
"arguments": []
},
"execution_policy": { "pre_action_message": {
"enabled": False,
"text": { "segments": [
{
"type": "literal",
"value": "<string>"
}
] },
"wait": False
} },
"argument_overrides": {},
"config_overrides": {
"type": "api_request",
"url": "<string>"
}
}
],
"mcp_refs": [
{
"attachment_id": "550e8400-e29b-41d4-a716-446655440000",
"server_id": "550e8400-e29b-41d4-a716-446655440000",
"tool_name": "<string>",
"observed_schema_hash": "<string>",
"description": "<string>",
"invocation": "model",
"execution_policy": { "pre_action_message": {
"enabled": False,
"text": { "segments": [
{
"type": "literal",
"value": "<string>"
}
] },
"wait": False
} },
"argument_overrides": {}
}
],
"sip_inbound_trunk_id": "550e8400-e29b-41d4-a716-446655440000",
"sip_outbound_trunk_id": "550e8400-e29b-41d4-a716-446655440000",
"template_defaults": {},
"template_variable_options": {},
"runtime_variables": [
{
"name": "<string>",
"description": "<string>"
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
system_prompt: '<string>',
greeting: '<string>',
inbound_greeting: '<string>',
outbound_greeting: '<string>',
language: '<string>',
region: 'eu-west',
world_part_code: 'eu-north',
llm_router_enabled: true,
idle_nudges: {
first_nudge_text: '<string>',
second_nudge_text: '<string>',
final_hangup_text: '<string>',
enabled: true,
first_nudge_delay_seconds: 15,
second_nudge_delay_seconds: 30,
hangup_delay_seconds: 15
},
enable_interruptions: true,
tool_refs: [
{
attachment_id: '550e8400-e29b-41d4-a716-446655440000',
tool_id: '550e8400-e29b-41d4-a716-446655440000',
version: 2,
description: '<string>',
invocation: 'model',
system: {
triggers: [{source_attachment_id: '550e8400-e29b-41d4-a716-446655440000'}],
arguments: []
},
execution_policy: {
pre_action_message: {
enabled: false,
text: {segments: [{type: 'literal', value: '<string>'}]},
wait: false
}
},
argument_overrides: {},
config_overrides: {type: 'api_request', url: '<string>'}
}
],
mcp_refs: [
{
attachment_id: '550e8400-e29b-41d4-a716-446655440000',
server_id: '550e8400-e29b-41d4-a716-446655440000',
tool_name: '<string>',
observed_schema_hash: '<string>',
description: '<string>',
invocation: 'model',
execution_policy: {
pre_action_message: {
enabled: false,
text: {segments: [{type: 'literal', value: '<string>'}]},
wait: false
}
},
argument_overrides: {}
}
],
sip_inbound_trunk_id: '550e8400-e29b-41d4-a716-446655440000',
sip_outbound_trunk_id: '550e8400-e29b-41d4-a716-446655440000',
template_defaults: {},
template_variable_options: {},
runtime_variables: [{name: '<string>', description: '<string>'}]
})
};
fetch('https://api.agents.slng.ai/v1/agents/{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.agents.slng.ai/v1/agents/{agent_id}",
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([
'name' => '<string>',
'system_prompt' => '<string>',
'greeting' => '<string>',
'inbound_greeting' => '<string>',
'outbound_greeting' => '<string>',
'language' => '<string>',
'region' => 'eu-west',
'world_part_code' => 'eu-north',
'llm_router_enabled' => true,
'idle_nudges' => [
'first_nudge_text' => '<string>',
'second_nudge_text' => '<string>',
'final_hangup_text' => '<string>',
'enabled' => true,
'first_nudge_delay_seconds' => 15,
'second_nudge_delay_seconds' => 30,
'hangup_delay_seconds' => 15
],
'enable_interruptions' => true,
'tool_refs' => [
[
'attachment_id' => '550e8400-e29b-41d4-a716-446655440000',
'tool_id' => '550e8400-e29b-41d4-a716-446655440000',
'version' => 2,
'description' => '<string>',
'invocation' => 'model',
'system' => [
'triggers' => [
[
'source_attachment_id' => '550e8400-e29b-41d4-a716-446655440000'
]
],
'arguments' => [
]
],
'execution_policy' => [
'pre_action_message' => [
'enabled' => false,
'text' => [
'segments' => [
[
'type' => 'literal',
'value' => '<string>'
]
]
],
'wait' => false
]
],
'argument_overrides' => [
],
'config_overrides' => [
'type' => 'api_request',
'url' => '<string>'
]
]
],
'mcp_refs' => [
[
'attachment_id' => '550e8400-e29b-41d4-a716-446655440000',
'server_id' => '550e8400-e29b-41d4-a716-446655440000',
'tool_name' => '<string>',
'observed_schema_hash' => '<string>',
'description' => '<string>',
'invocation' => 'model',
'execution_policy' => [
'pre_action_message' => [
'enabled' => false,
'text' => [
'segments' => [
[
'type' => 'literal',
'value' => '<string>'
]
]
],
'wait' => false
]
],
'argument_overrides' => [
]
]
],
'sip_inbound_trunk_id' => '550e8400-e29b-41d4-a716-446655440000',
'sip_outbound_trunk_id' => '550e8400-e29b-41d4-a716-446655440000',
'template_defaults' => [
],
'template_variable_options' => [
],
'runtime_variables' => [
[
'name' => '<string>',
'description' => '<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.agents.slng.ai/v1/agents/{agent_id}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"system_prompt\": \"<string>\",\n \"greeting\": \"<string>\",\n \"inbound_greeting\": \"<string>\",\n \"outbound_greeting\": \"<string>\",\n \"language\": \"<string>\",\n \"region\": \"eu-west\",\n \"world_part_code\": \"eu-north\",\n \"llm_router_enabled\": true,\n \"idle_nudges\": {\n \"first_nudge_text\": \"<string>\",\n \"second_nudge_text\": \"<string>\",\n \"final_hangup_text\": \"<string>\",\n \"enabled\": true,\n \"first_nudge_delay_seconds\": 15,\n \"second_nudge_delay_seconds\": 30,\n \"hangup_delay_seconds\": 15\n },\n \"enable_interruptions\": true,\n \"tool_refs\": [\n {\n \"attachment_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"tool_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"version\": 2,\n \"description\": \"<string>\",\n \"invocation\": \"model\",\n \"system\": {\n \"triggers\": [\n {\n \"source_attachment_id\": \"550e8400-e29b-41d4-a716-446655440000\"\n }\n ],\n \"arguments\": []\n },\n \"execution_policy\": {\n \"pre_action_message\": {\n \"enabled\": false,\n \"text\": {\n \"segments\": [\n {\n \"type\": \"literal\",\n \"value\": \"<string>\"\n }\n ]\n },\n \"wait\": false\n }\n },\n \"argument_overrides\": {},\n \"config_overrides\": {\n \"type\": \"api_request\",\n \"url\": \"<string>\"\n }\n }\n ],\n \"mcp_refs\": [\n {\n \"attachment_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"server_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"tool_name\": \"<string>\",\n \"observed_schema_hash\": \"<string>\",\n \"description\": \"<string>\",\n \"invocation\": \"model\",\n \"execution_policy\": {\n \"pre_action_message\": {\n \"enabled\": false,\n \"text\": {\n \"segments\": [\n {\n \"type\": \"literal\",\n \"value\": \"<string>\"\n }\n ]\n },\n \"wait\": false\n }\n },\n \"argument_overrides\": {}\n }\n ],\n \"sip_inbound_trunk_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"sip_outbound_trunk_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"template_defaults\": {},\n \"template_variable_options\": {},\n \"runtime_variables\": [\n {\n \"name\": \"<string>\",\n \"description\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://api.agents.slng.ai/v1/agents/{agent_id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"system_prompt\": \"<string>\",\n \"greeting\": \"<string>\",\n \"inbound_greeting\": \"<string>\",\n \"outbound_greeting\": \"<string>\",\n \"language\": \"<string>\",\n \"region\": \"eu-west\",\n \"world_part_code\": \"eu-north\",\n \"llm_router_enabled\": true,\n \"idle_nudges\": {\n \"first_nudge_text\": \"<string>\",\n \"second_nudge_text\": \"<string>\",\n \"final_hangup_text\": \"<string>\",\n \"enabled\": true,\n \"first_nudge_delay_seconds\": 15,\n \"second_nudge_delay_seconds\": 30,\n \"hangup_delay_seconds\": 15\n },\n \"enable_interruptions\": true,\n \"tool_refs\": [\n {\n \"attachment_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"tool_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"version\": 2,\n \"description\": \"<string>\",\n \"invocation\": \"model\",\n \"system\": {\n \"triggers\": [\n {\n \"source_attachment_id\": \"550e8400-e29b-41d4-a716-446655440000\"\n }\n ],\n \"arguments\": []\n },\n \"execution_policy\": {\n \"pre_action_message\": {\n \"enabled\": false,\n \"text\": {\n \"segments\": [\n {\n \"type\": \"literal\",\n \"value\": \"<string>\"\n }\n ]\n },\n \"wait\": false\n }\n },\n \"argument_overrides\": {},\n \"config_overrides\": {\n \"type\": \"api_request\",\n \"url\": \"<string>\"\n }\n }\n ],\n \"mcp_refs\": [\n {\n \"attachment_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"server_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"tool_name\": \"<string>\",\n \"observed_schema_hash\": \"<string>\",\n \"description\": \"<string>\",\n \"invocation\": \"model\",\n \"execution_policy\": {\n \"pre_action_message\": {\n \"enabled\": false,\n \"text\": {\n \"segments\": [\n {\n \"type\": \"literal\",\n \"value\": \"<string>\"\n }\n ]\n },\n \"wait\": false\n }\n },\n \"argument_overrides\": {}\n }\n ],\n \"sip_inbound_trunk_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"sip_outbound_trunk_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"template_defaults\": {},\n \"template_variable_options\": {},\n \"runtime_variables\": [\n {\n \"name\": \"<string>\",\n \"description\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.agents.slng.ai/v1/agents/{agent_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"system_prompt\": \"<string>\",\n \"greeting\": \"<string>\",\n \"inbound_greeting\": \"<string>\",\n \"outbound_greeting\": \"<string>\",\n \"language\": \"<string>\",\n \"region\": \"eu-west\",\n \"world_part_code\": \"eu-north\",\n \"llm_router_enabled\": true,\n \"idle_nudges\": {\n \"first_nudge_text\": \"<string>\",\n \"second_nudge_text\": \"<string>\",\n \"final_hangup_text\": \"<string>\",\n \"enabled\": true,\n \"first_nudge_delay_seconds\": 15,\n \"second_nudge_delay_seconds\": 30,\n \"hangup_delay_seconds\": 15\n },\n \"enable_interruptions\": true,\n \"tool_refs\": [\n {\n \"attachment_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"tool_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"version\": 2,\n \"description\": \"<string>\",\n \"invocation\": \"model\",\n \"system\": {\n \"triggers\": [\n {\n \"source_attachment_id\": \"550e8400-e29b-41d4-a716-446655440000\"\n }\n ],\n \"arguments\": []\n },\n \"execution_policy\": {\n \"pre_action_message\": {\n \"enabled\": false,\n \"text\": {\n \"segments\": [\n {\n \"type\": \"literal\",\n \"value\": \"<string>\"\n }\n ]\n },\n \"wait\": false\n }\n },\n \"argument_overrides\": {},\n \"config_overrides\": {\n \"type\": \"api_request\",\n \"url\": \"<string>\"\n }\n }\n ],\n \"mcp_refs\": [\n {\n \"attachment_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"server_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"tool_name\": \"<string>\",\n \"observed_schema_hash\": \"<string>\",\n \"description\": \"<string>\",\n \"invocation\": \"model\",\n \"execution_policy\": {\n \"pre_action_message\": {\n \"enabled\": false,\n \"text\": {\n \"segments\": [\n {\n \"type\": \"literal\",\n \"value\": \"<string>\"\n }\n ]\n },\n \"wait\": false\n }\n },\n \"argument_overrides\": {}\n }\n ],\n \"sip_inbound_trunk_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"sip_outbound_trunk_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"template_defaults\": {},\n \"template_variable_options\": {},\n \"runtime_variables\": [\n {\n \"name\": \"<string>\",\n \"description\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "550e8400-e29b-41d4-a716-446655440000",
"organisation_id": "550e8400-e29b-41d4-a716-446655440000",
"name": "<string>",
"system_prompt": "<string>",
"greeting": "<string>",
"language": "<string>",
"region": "<string>",
"models": {
"stt": "slng/deepgram/nova:3-en",
"llm": "groq/openai/gpt-oss-120b",
"tts": "slng/deepgram/aura:2-en",
"tts_voice": "aura-2-thalia-en",
"stt_kwargs": {},
"llm_kwargs": {},
"tts_kwargs": {},
"fallbacks": {
"stt": [],
"llm": [],
"tts": []
},
"stt_final_timeout_s": 1,
"llm_first_token_timeout_s": 1,
"tts_first_audio_timeout_s": 1,
"failure_audio_enabled": true
},
"idle_nudges": {
"first_nudge_text": "<string>",
"second_nudge_text": "<string>",
"final_hangup_text": "<string>",
"enabled": true,
"first_nudge_delay_seconds": 15,
"second_nudge_delay_seconds": 30,
"hangup_delay_seconds": 15
},
"enable_interruptions": true,
"tool_mode": "legacy",
"tools": [
{}
],
"tool_refs": [
{
"attachment_id": "550e8400-e29b-41d4-a716-446655440000",
"tool_id": "550e8400-e29b-41d4-a716-446655440000",
"version": 2,
"description": "<string>",
"invocation": "model",
"system": {
"triggers": [
{
"event": "call_start",
"source_attachment_id": "550e8400-e29b-41d4-a716-446655440000"
}
],
"arguments": []
},
"execution_policy": {
"pre_action_message": {
"enabled": false,
"text": {
"segments": [
{
"type": "literal",
"value": "<string>"
}
]
},
"wait": false
}
},
"argument_overrides": {},
"config_overrides": {
"type": "api_request",
"url": "<string>"
}
}
],
"mcp_refs": [
{
"attachment_id": "550e8400-e29b-41d4-a716-446655440000",
"server_id": "550e8400-e29b-41d4-a716-446655440000",
"tool_name": "<string>",
"observed_schema_hash": "<string>",
"description": "<string>",
"invocation": "model",
"execution_policy": {
"pre_action_message": {
"enabled": false,
"text": {
"segments": [
{
"type": "literal",
"value": "<string>"
}
]
},
"wait": false
}
},
"argument_overrides": {}
}
],
"livekit_deployment": "<string>",
"template_variables": {},
"created_at": "2026-01-15T10:30:00Z",
"updated_at": "2026-01-15T10:30:00Z",
"inbound_greeting": "<string>",
"outbound_greeting": "<string>",
"project_id": "550e8400-e29b-41d4-a716-446655440000",
"world_part_code": "eu-west",
"world_part_label": "<string>",
"models_validation_error": "<string>",
"llm_router_enabled": true,
"sip_inbound_trunk_id": "550e8400-e29b-41d4-a716-446655440000",
"sip_outbound_trunk_id": "550e8400-e29b-41d4-a716-446655440000",
"runtime_variables": [
{
"name": "<string>",
"description": "<string>"
}
],
"deleted_at": "2026-01-15T10:30:00Z"
}{
"detail": "The request could not be processed."
}{
"detail": "Authentication is required for this endpoint."
}{
"detail": "You do not have access to this resource."
}{
"detail": "The requested resource was not found."
}{
"detail": "The requested operation conflicts with the current resource state."
}{
"detail": [
{
"loc": [
"body",
"language"
],
"msg": "Input should be a valid string",
"type": "string_type"
}
]
}{
"detail": "An unexpected internal error occurred."
}{
"detail": "The upstream service failed to process the request."
}Agents
Update agent (partial)
Partially update a voice agent. Shared tool and MCP attachments cannot be changed with PATCH; download the full config and use PUT instead.
PATCH
/
v1
/
agents
/
{agent_id}
Update agent (partial)
curl --request PATCH \
--url https://api.agents.slng.ai/v1/agents/{agent_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"system_prompt": "<string>",
"greeting": "<string>",
"inbound_greeting": "<string>",
"outbound_greeting": "<string>",
"language": "<string>",
"region": "eu-west",
"world_part_code": "eu-north",
"llm_router_enabled": true,
"idle_nudges": {
"first_nudge_text": "<string>",
"second_nudge_text": "<string>",
"final_hangup_text": "<string>",
"enabled": true,
"first_nudge_delay_seconds": 15,
"second_nudge_delay_seconds": 30,
"hangup_delay_seconds": 15
},
"enable_interruptions": true,
"tool_refs": [
{
"attachment_id": "550e8400-e29b-41d4-a716-446655440000",
"tool_id": "550e8400-e29b-41d4-a716-446655440000",
"version": 2,
"description": "<string>",
"invocation": "model",
"system": {
"triggers": [
{
"source_attachment_id": "550e8400-e29b-41d4-a716-446655440000"
}
],
"arguments": []
},
"execution_policy": {
"pre_action_message": {
"enabled": false,
"text": {
"segments": [
{
"type": "literal",
"value": "<string>"
}
]
},
"wait": false
}
},
"argument_overrides": {},
"config_overrides": {
"type": "api_request",
"url": "<string>"
}
}
],
"mcp_refs": [
{
"attachment_id": "550e8400-e29b-41d4-a716-446655440000",
"server_id": "550e8400-e29b-41d4-a716-446655440000",
"tool_name": "<string>",
"observed_schema_hash": "<string>",
"description": "<string>",
"invocation": "model",
"execution_policy": {
"pre_action_message": {
"enabled": false,
"text": {
"segments": [
{
"type": "literal",
"value": "<string>"
}
]
},
"wait": false
}
},
"argument_overrides": {}
}
],
"sip_inbound_trunk_id": "550e8400-e29b-41d4-a716-446655440000",
"sip_outbound_trunk_id": "550e8400-e29b-41d4-a716-446655440000",
"template_defaults": {},
"template_variable_options": {},
"runtime_variables": [
{
"name": "<string>",
"description": "<string>"
}
]
}
'import requests
url = "https://api.agents.slng.ai/v1/agents/{agent_id}"
payload = {
"name": "<string>",
"system_prompt": "<string>",
"greeting": "<string>",
"inbound_greeting": "<string>",
"outbound_greeting": "<string>",
"language": "<string>",
"region": "eu-west",
"world_part_code": "eu-north",
"llm_router_enabled": True,
"idle_nudges": {
"first_nudge_text": "<string>",
"second_nudge_text": "<string>",
"final_hangup_text": "<string>",
"enabled": True,
"first_nudge_delay_seconds": 15,
"second_nudge_delay_seconds": 30,
"hangup_delay_seconds": 15
},
"enable_interruptions": True,
"tool_refs": [
{
"attachment_id": "550e8400-e29b-41d4-a716-446655440000",
"tool_id": "550e8400-e29b-41d4-a716-446655440000",
"version": 2,
"description": "<string>",
"invocation": "model",
"system": {
"triggers": [{ "source_attachment_id": "550e8400-e29b-41d4-a716-446655440000" }],
"arguments": []
},
"execution_policy": { "pre_action_message": {
"enabled": False,
"text": { "segments": [
{
"type": "literal",
"value": "<string>"
}
] },
"wait": False
} },
"argument_overrides": {},
"config_overrides": {
"type": "api_request",
"url": "<string>"
}
}
],
"mcp_refs": [
{
"attachment_id": "550e8400-e29b-41d4-a716-446655440000",
"server_id": "550e8400-e29b-41d4-a716-446655440000",
"tool_name": "<string>",
"observed_schema_hash": "<string>",
"description": "<string>",
"invocation": "model",
"execution_policy": { "pre_action_message": {
"enabled": False,
"text": { "segments": [
{
"type": "literal",
"value": "<string>"
}
] },
"wait": False
} },
"argument_overrides": {}
}
],
"sip_inbound_trunk_id": "550e8400-e29b-41d4-a716-446655440000",
"sip_outbound_trunk_id": "550e8400-e29b-41d4-a716-446655440000",
"template_defaults": {},
"template_variable_options": {},
"runtime_variables": [
{
"name": "<string>",
"description": "<string>"
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
system_prompt: '<string>',
greeting: '<string>',
inbound_greeting: '<string>',
outbound_greeting: '<string>',
language: '<string>',
region: 'eu-west',
world_part_code: 'eu-north',
llm_router_enabled: true,
idle_nudges: {
first_nudge_text: '<string>',
second_nudge_text: '<string>',
final_hangup_text: '<string>',
enabled: true,
first_nudge_delay_seconds: 15,
second_nudge_delay_seconds: 30,
hangup_delay_seconds: 15
},
enable_interruptions: true,
tool_refs: [
{
attachment_id: '550e8400-e29b-41d4-a716-446655440000',
tool_id: '550e8400-e29b-41d4-a716-446655440000',
version: 2,
description: '<string>',
invocation: 'model',
system: {
triggers: [{source_attachment_id: '550e8400-e29b-41d4-a716-446655440000'}],
arguments: []
},
execution_policy: {
pre_action_message: {
enabled: false,
text: {segments: [{type: 'literal', value: '<string>'}]},
wait: false
}
},
argument_overrides: {},
config_overrides: {type: 'api_request', url: '<string>'}
}
],
mcp_refs: [
{
attachment_id: '550e8400-e29b-41d4-a716-446655440000',
server_id: '550e8400-e29b-41d4-a716-446655440000',
tool_name: '<string>',
observed_schema_hash: '<string>',
description: '<string>',
invocation: 'model',
execution_policy: {
pre_action_message: {
enabled: false,
text: {segments: [{type: 'literal', value: '<string>'}]},
wait: false
}
},
argument_overrides: {}
}
],
sip_inbound_trunk_id: '550e8400-e29b-41d4-a716-446655440000',
sip_outbound_trunk_id: '550e8400-e29b-41d4-a716-446655440000',
template_defaults: {},
template_variable_options: {},
runtime_variables: [{name: '<string>', description: '<string>'}]
})
};
fetch('https://api.agents.slng.ai/v1/agents/{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.agents.slng.ai/v1/agents/{agent_id}",
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([
'name' => '<string>',
'system_prompt' => '<string>',
'greeting' => '<string>',
'inbound_greeting' => '<string>',
'outbound_greeting' => '<string>',
'language' => '<string>',
'region' => 'eu-west',
'world_part_code' => 'eu-north',
'llm_router_enabled' => true,
'idle_nudges' => [
'first_nudge_text' => '<string>',
'second_nudge_text' => '<string>',
'final_hangup_text' => '<string>',
'enabled' => true,
'first_nudge_delay_seconds' => 15,
'second_nudge_delay_seconds' => 30,
'hangup_delay_seconds' => 15
],
'enable_interruptions' => true,
'tool_refs' => [
[
'attachment_id' => '550e8400-e29b-41d4-a716-446655440000',
'tool_id' => '550e8400-e29b-41d4-a716-446655440000',
'version' => 2,
'description' => '<string>',
'invocation' => 'model',
'system' => [
'triggers' => [
[
'source_attachment_id' => '550e8400-e29b-41d4-a716-446655440000'
]
],
'arguments' => [
]
],
'execution_policy' => [
'pre_action_message' => [
'enabled' => false,
'text' => [
'segments' => [
[
'type' => 'literal',
'value' => '<string>'
]
]
],
'wait' => false
]
],
'argument_overrides' => [
],
'config_overrides' => [
'type' => 'api_request',
'url' => '<string>'
]
]
],
'mcp_refs' => [
[
'attachment_id' => '550e8400-e29b-41d4-a716-446655440000',
'server_id' => '550e8400-e29b-41d4-a716-446655440000',
'tool_name' => '<string>',
'observed_schema_hash' => '<string>',
'description' => '<string>',
'invocation' => 'model',
'execution_policy' => [
'pre_action_message' => [
'enabled' => false,
'text' => [
'segments' => [
[
'type' => 'literal',
'value' => '<string>'
]
]
],
'wait' => false
]
],
'argument_overrides' => [
]
]
],
'sip_inbound_trunk_id' => '550e8400-e29b-41d4-a716-446655440000',
'sip_outbound_trunk_id' => '550e8400-e29b-41d4-a716-446655440000',
'template_defaults' => [
],
'template_variable_options' => [
],
'runtime_variables' => [
[
'name' => '<string>',
'description' => '<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.agents.slng.ai/v1/agents/{agent_id}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"system_prompt\": \"<string>\",\n \"greeting\": \"<string>\",\n \"inbound_greeting\": \"<string>\",\n \"outbound_greeting\": \"<string>\",\n \"language\": \"<string>\",\n \"region\": \"eu-west\",\n \"world_part_code\": \"eu-north\",\n \"llm_router_enabled\": true,\n \"idle_nudges\": {\n \"first_nudge_text\": \"<string>\",\n \"second_nudge_text\": \"<string>\",\n \"final_hangup_text\": \"<string>\",\n \"enabled\": true,\n \"first_nudge_delay_seconds\": 15,\n \"second_nudge_delay_seconds\": 30,\n \"hangup_delay_seconds\": 15\n },\n \"enable_interruptions\": true,\n \"tool_refs\": [\n {\n \"attachment_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"tool_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"version\": 2,\n \"description\": \"<string>\",\n \"invocation\": \"model\",\n \"system\": {\n \"triggers\": [\n {\n \"source_attachment_id\": \"550e8400-e29b-41d4-a716-446655440000\"\n }\n ],\n \"arguments\": []\n },\n \"execution_policy\": {\n \"pre_action_message\": {\n \"enabled\": false,\n \"text\": {\n \"segments\": [\n {\n \"type\": \"literal\",\n \"value\": \"<string>\"\n }\n ]\n },\n \"wait\": false\n }\n },\n \"argument_overrides\": {},\n \"config_overrides\": {\n \"type\": \"api_request\",\n \"url\": \"<string>\"\n }\n }\n ],\n \"mcp_refs\": [\n {\n \"attachment_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"server_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"tool_name\": \"<string>\",\n \"observed_schema_hash\": \"<string>\",\n \"description\": \"<string>\",\n \"invocation\": \"model\",\n \"execution_policy\": {\n \"pre_action_message\": {\n \"enabled\": false,\n \"text\": {\n \"segments\": [\n {\n \"type\": \"literal\",\n \"value\": \"<string>\"\n }\n ]\n },\n \"wait\": false\n }\n },\n \"argument_overrides\": {}\n }\n ],\n \"sip_inbound_trunk_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"sip_outbound_trunk_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"template_defaults\": {},\n \"template_variable_options\": {},\n \"runtime_variables\": [\n {\n \"name\": \"<string>\",\n \"description\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://api.agents.slng.ai/v1/agents/{agent_id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"system_prompt\": \"<string>\",\n \"greeting\": \"<string>\",\n \"inbound_greeting\": \"<string>\",\n \"outbound_greeting\": \"<string>\",\n \"language\": \"<string>\",\n \"region\": \"eu-west\",\n \"world_part_code\": \"eu-north\",\n \"llm_router_enabled\": true,\n \"idle_nudges\": {\n \"first_nudge_text\": \"<string>\",\n \"second_nudge_text\": \"<string>\",\n \"final_hangup_text\": \"<string>\",\n \"enabled\": true,\n \"first_nudge_delay_seconds\": 15,\n \"second_nudge_delay_seconds\": 30,\n \"hangup_delay_seconds\": 15\n },\n \"enable_interruptions\": true,\n \"tool_refs\": [\n {\n \"attachment_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"tool_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"version\": 2,\n \"description\": \"<string>\",\n \"invocation\": \"model\",\n \"system\": {\n \"triggers\": [\n {\n \"source_attachment_id\": \"550e8400-e29b-41d4-a716-446655440000\"\n }\n ],\n \"arguments\": []\n },\n \"execution_policy\": {\n \"pre_action_message\": {\n \"enabled\": false,\n \"text\": {\n \"segments\": [\n {\n \"type\": \"literal\",\n \"value\": \"<string>\"\n }\n ]\n },\n \"wait\": false\n }\n },\n \"argument_overrides\": {},\n \"config_overrides\": {\n \"type\": \"api_request\",\n \"url\": \"<string>\"\n }\n }\n ],\n \"mcp_refs\": [\n {\n \"attachment_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"server_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"tool_name\": \"<string>\",\n \"observed_schema_hash\": \"<string>\",\n \"description\": \"<string>\",\n \"invocation\": \"model\",\n \"execution_policy\": {\n \"pre_action_message\": {\n \"enabled\": false,\n \"text\": {\n \"segments\": [\n {\n \"type\": \"literal\",\n \"value\": \"<string>\"\n }\n ]\n },\n \"wait\": false\n }\n },\n \"argument_overrides\": {}\n }\n ],\n \"sip_inbound_trunk_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"sip_outbound_trunk_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"template_defaults\": {},\n \"template_variable_options\": {},\n \"runtime_variables\": [\n {\n \"name\": \"<string>\",\n \"description\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.agents.slng.ai/v1/agents/{agent_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"system_prompt\": \"<string>\",\n \"greeting\": \"<string>\",\n \"inbound_greeting\": \"<string>\",\n \"outbound_greeting\": \"<string>\",\n \"language\": \"<string>\",\n \"region\": \"eu-west\",\n \"world_part_code\": \"eu-north\",\n \"llm_router_enabled\": true,\n \"idle_nudges\": {\n \"first_nudge_text\": \"<string>\",\n \"second_nudge_text\": \"<string>\",\n \"final_hangup_text\": \"<string>\",\n \"enabled\": true,\n \"first_nudge_delay_seconds\": 15,\n \"second_nudge_delay_seconds\": 30,\n \"hangup_delay_seconds\": 15\n },\n \"enable_interruptions\": true,\n \"tool_refs\": [\n {\n \"attachment_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"tool_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"version\": 2,\n \"description\": \"<string>\",\n \"invocation\": \"model\",\n \"system\": {\n \"triggers\": [\n {\n \"source_attachment_id\": \"550e8400-e29b-41d4-a716-446655440000\"\n }\n ],\n \"arguments\": []\n },\n \"execution_policy\": {\n \"pre_action_message\": {\n \"enabled\": false,\n \"text\": {\n \"segments\": [\n {\n \"type\": \"literal\",\n \"value\": \"<string>\"\n }\n ]\n },\n \"wait\": false\n }\n },\n \"argument_overrides\": {},\n \"config_overrides\": {\n \"type\": \"api_request\",\n \"url\": \"<string>\"\n }\n }\n ],\n \"mcp_refs\": [\n {\n \"attachment_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"server_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"tool_name\": \"<string>\",\n \"observed_schema_hash\": \"<string>\",\n \"description\": \"<string>\",\n \"invocation\": \"model\",\n \"execution_policy\": {\n \"pre_action_message\": {\n \"enabled\": false,\n \"text\": {\n \"segments\": [\n {\n \"type\": \"literal\",\n \"value\": \"<string>\"\n }\n ]\n },\n \"wait\": false\n }\n },\n \"argument_overrides\": {}\n }\n ],\n \"sip_inbound_trunk_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"sip_outbound_trunk_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"template_defaults\": {},\n \"template_variable_options\": {},\n \"runtime_variables\": [\n {\n \"name\": \"<string>\",\n \"description\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "550e8400-e29b-41d4-a716-446655440000",
"organisation_id": "550e8400-e29b-41d4-a716-446655440000",
"name": "<string>",
"system_prompt": "<string>",
"greeting": "<string>",
"language": "<string>",
"region": "<string>",
"models": {
"stt": "slng/deepgram/nova:3-en",
"llm": "groq/openai/gpt-oss-120b",
"tts": "slng/deepgram/aura:2-en",
"tts_voice": "aura-2-thalia-en",
"stt_kwargs": {},
"llm_kwargs": {},
"tts_kwargs": {},
"fallbacks": {
"stt": [],
"llm": [],
"tts": []
},
"stt_final_timeout_s": 1,
"llm_first_token_timeout_s": 1,
"tts_first_audio_timeout_s": 1,
"failure_audio_enabled": true
},
"idle_nudges": {
"first_nudge_text": "<string>",
"second_nudge_text": "<string>",
"final_hangup_text": "<string>",
"enabled": true,
"first_nudge_delay_seconds": 15,
"second_nudge_delay_seconds": 30,
"hangup_delay_seconds": 15
},
"enable_interruptions": true,
"tool_mode": "legacy",
"tools": [
{}
],
"tool_refs": [
{
"attachment_id": "550e8400-e29b-41d4-a716-446655440000",
"tool_id": "550e8400-e29b-41d4-a716-446655440000",
"version": 2,
"description": "<string>",
"invocation": "model",
"system": {
"triggers": [
{
"event": "call_start",
"source_attachment_id": "550e8400-e29b-41d4-a716-446655440000"
}
],
"arguments": []
},
"execution_policy": {
"pre_action_message": {
"enabled": false,
"text": {
"segments": [
{
"type": "literal",
"value": "<string>"
}
]
},
"wait": false
}
},
"argument_overrides": {},
"config_overrides": {
"type": "api_request",
"url": "<string>"
}
}
],
"mcp_refs": [
{
"attachment_id": "550e8400-e29b-41d4-a716-446655440000",
"server_id": "550e8400-e29b-41d4-a716-446655440000",
"tool_name": "<string>",
"observed_schema_hash": "<string>",
"description": "<string>",
"invocation": "model",
"execution_policy": {
"pre_action_message": {
"enabled": false,
"text": {
"segments": [
{
"type": "literal",
"value": "<string>"
}
]
},
"wait": false
}
},
"argument_overrides": {}
}
],
"livekit_deployment": "<string>",
"template_variables": {},
"created_at": "2026-01-15T10:30:00Z",
"updated_at": "2026-01-15T10:30:00Z",
"inbound_greeting": "<string>",
"outbound_greeting": "<string>",
"project_id": "550e8400-e29b-41d4-a716-446655440000",
"world_part_code": "eu-west",
"world_part_label": "<string>",
"models_validation_error": "<string>",
"llm_router_enabled": true,
"sip_inbound_trunk_id": "550e8400-e29b-41d4-a716-446655440000",
"sip_outbound_trunk_id": "550e8400-e29b-41d4-a716-446655440000",
"runtime_variables": [
{
"name": "<string>",
"description": "<string>"
}
],
"deleted_at": "2026-01-15T10:30:00Z"
}{
"detail": "The request could not be processed."
}{
"detail": "Authentication is required for this endpoint."
}{
"detail": "You do not have access to this resource."
}{
"detail": "The requested resource was not found."
}{
"detail": "The requested operation conflicts with the current resource state."
}{
"detail": [
{
"loc": [
"body",
"language"
],
"msg": "Input should be a valid string",
"type": "string_type"
}
]
}{
"detail": "An unexpected internal error occurred."
}{
"detail": "The upstream service failed to process the request."
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Voice agent ID.
Example:
"550e8400-e29b-41d4-a716-446655440000"
Body
application/json
Maximum string length:
255Maximum string length:
10Agent region code to move the agent to, for future calls. When the agent's project has a World part, an update made with an API key moves the project with it, to the place that region runs in. The agent's current region changes nothing. Send a new region or a world_part_code, not both. See Change an agent's region.
Pattern:
^[a-z0-9]+(?:-[a-z0-9]+)*$Example:
"eu-west"
Gateway code of the place to move the agent's project to, from Region availability. The agent moves to an agent region at that place, and a project shown as Not connected gets connected. A place where no agent of the agent's runtime runs is refused with 422. Send a new region or a world_part_code, not both.
Maximum string length:
20Pattern:
^[a-z0-9]+(?:-[a-z0-9]+)*$Example:
"eu-north"
Model configuration for the agent runtime (STT + LLM + TTS).
Show child attributes
Show child attributes
Routes the agent's LLM traffic through SLNG's managed LLM routing layer. Omit to keep the current setting.
Optional silence recovery behavior. The runtime can send two follow-up nudges, then speak a final message and hang up.
Show child attributes
Show child attributes
Complete shared tool attachment list. PATCH rejects attachment changes; use PUT.
Maximum array length:
128Show child attributes
Show child attributes
Complete MCP attachment list. PATCH rejects attachment changes; use PUT.
Maximum array length:
128Show child attributes
Show child attributes
Example:
"550e8400-e29b-41d4-a716-446655440000"
Example:
"550e8400-e29b-41d4-a716-446655440000"
Show child attributes
Show child attributes
Per-variable options for the input variables used in the prompt and greetings, keyed by variable name. Use this to mark an input variable optional.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Response
Updated agent.
Example:
"550e8400-e29b-41d4-a716-446655440000"
Example:
"550e8400-e29b-41d4-a716-446655440000"
Model configuration for the agent runtime (STT + LLM + TTS).
Show child attributes
Show child attributes
Optional silence recovery behavior. The runtime can send two follow-up nudges, then speak a final message and hang up.
Show child attributes
Show child attributes
Tool system fixed when the agent was created. New agents use shared.
Available options:
legacy, shared Legacy compatibility output. New shared agents return an empty array. Use tool_refs and mcp_refs for all new configuration.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Name of the runtime deployment serving this agent.
Show child attributes
Show child attributes
Example:
"2026-01-15T10:30:00Z"
Example:
"2026-01-15T10:30:00Z"
The project the agent belongs to.
Example:
"550e8400-e29b-41d4-a716-446655440000"
Gateway code of the place the agent's project runs in. Null when the project shows Not connected under World part.
Example:
"eu-west"
Display name of world_part_code.
Set when the stored models configuration no longer validates against the
current rules. In that case models is returned as stored, without
validation.
Whether the agent's LLM traffic is routed through SLNG's managed LLM routing layer.
Example:
"550e8400-e29b-41d4-a716-446655440000"
Example:
"550e8400-e29b-41d4-a716-446655440000"
Show child attributes
Show child attributes
Example:
"2026-01-15T10:30:00Z"