Replace agent

Replace agent

curl --request PUT \
  --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>",
  "language": "<string>",
  "region": "eu-west",
  "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
  },
  "inbound_greeting": "<string>",
  "outbound_greeting": "<string>",
  "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,
  "schema_version": 2,
  "tool_mode": "shared",
  "tool_refs": [],
  "mcp_refs": [],
  "template_id": "550e8400-e29b-41d4-a716-446655440000",
  "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": []
}
'

import requests

url = "https://api.agents.slng.ai/v1/agents/{agent_id}"

payload = {
    "name": "<string>",
    "system_prompt": "<string>",
    "greeting": "<string>",
    "language": "<string>",
    "region": "eu-west",
    "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
    },
    "inbound_greeting": "<string>",
    "outbound_greeting": "<string>",
    "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,
    "schema_version": 2,
    "tool_mode": "shared",
    "tool_refs": [],
    "mcp_refs": [],
    "template_id": "550e8400-e29b-41d4-a716-446655440000",
    "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": []
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    system_prompt: '<string>',
    greeting: '<string>',
    language: '<string>',
    region: 'eu-west',
    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
    },
    inbound_greeting: '<string>',
    outbound_greeting: '<string>',
    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,
    schema_version: 2,
    tool_mode: 'shared',
    tool_refs: [],
    mcp_refs: [],
    template_id: '550e8400-e29b-41d4-a716-446655440000',
    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: []
  })
};

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 => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'system_prompt' => '<string>',
    'greeting' => '<string>',
    'language' => '<string>',
    'region' => 'eu-west',
    '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
    ],
    'inbound_greeting' => '<string>',
    'outbound_greeting' => '<string>',
    '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,
    'schema_version' => 2,
    'tool_mode' => 'shared',
    'tool_refs' => [
        
    ],
    'mcp_refs' => [
        
    ],
    'template_id' => '550e8400-e29b-41d4-a716-446655440000',
    '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' => [
        
    ]
  ]),
  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  \"language\": \"<string>\",\n  \"region\": \"eu-west\",\n  \"models\": {\n    \"stt\": \"slng/deepgram/nova:3-en\",\n    \"llm\": \"groq/openai/gpt-oss-120b\",\n    \"tts\": \"slng/deepgram/aura:2-en\",\n    \"tts_voice\": \"aura-2-thalia-en\",\n    \"stt_kwargs\": {},\n    \"llm_kwargs\": {},\n    \"tts_kwargs\": {},\n    \"fallbacks\": {\n      \"stt\": [],\n      \"llm\": [],\n      \"tts\": []\n    },\n    \"stt_final_timeout_s\": 1,\n    \"llm_first_token_timeout_s\": 1,\n    \"tts_first_audio_timeout_s\": 1,\n    \"failure_audio_enabled\": true\n  },\n  \"inbound_greeting\": \"<string>\",\n  \"outbound_greeting\": \"<string>\",\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  \"schema_version\": 2,\n  \"tool_mode\": \"shared\",\n  \"tool_refs\": [],\n  \"mcp_refs\": [],\n  \"template_id\": \"550e8400-e29b-41d4-a716-446655440000\",\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}")

	req, _ := http.NewRequest("PUT", 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.put("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  \"language\": \"<string>\",\n  \"region\": \"eu-west\",\n  \"models\": {\n    \"stt\": \"slng/deepgram/nova:3-en\",\n    \"llm\": \"groq/openai/gpt-oss-120b\",\n    \"tts\": \"slng/deepgram/aura:2-en\",\n    \"tts_voice\": \"aura-2-thalia-en\",\n    \"stt_kwargs\": {},\n    \"llm_kwargs\": {},\n    \"tts_kwargs\": {},\n    \"fallbacks\": {\n      \"stt\": [],\n      \"llm\": [],\n      \"tts\": []\n    },\n    \"stt_final_timeout_s\": 1,\n    \"llm_first_token_timeout_s\": 1,\n    \"tts_first_audio_timeout_s\": 1,\n    \"failure_audio_enabled\": true\n  },\n  \"inbound_greeting\": \"<string>\",\n  \"outbound_greeting\": \"<string>\",\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  \"schema_version\": 2,\n  \"tool_mode\": \"shared\",\n  \"tool_refs\": [],\n  \"mcp_refs\": [],\n  \"template_id\": \"550e8400-e29b-41d4-a716-446655440000\",\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}")
  .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::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"system_prompt\": \"<string>\",\n  \"greeting\": \"<string>\",\n  \"language\": \"<string>\",\n  \"region\": \"eu-west\",\n  \"models\": {\n    \"stt\": \"slng/deepgram/nova:3-en\",\n    \"llm\": \"groq/openai/gpt-oss-120b\",\n    \"tts\": \"slng/deepgram/aura:2-en\",\n    \"tts_voice\": \"aura-2-thalia-en\",\n    \"stt_kwargs\": {},\n    \"llm_kwargs\": {},\n    \"tts_kwargs\": {},\n    \"fallbacks\": {\n      \"stt\": [],\n      \"llm\": [],\n      \"tts\": []\n    },\n    \"stt_final_timeout_s\": 1,\n    \"llm_first_token_timeout_s\": 1,\n    \"tts_first_audio_timeout_s\": 1,\n    \"failure_audio_enabled\": true\n  },\n  \"inbound_greeting\": \"<string>\",\n  \"outbound_greeting\": \"<string>\",\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  \"schema_version\": 2,\n  \"tool_mode\": \"shared\",\n  \"tool_refs\": [],\n  \"mcp_refs\": [],\n  \"template_id\": \"550e8400-e29b-41d4-a716-446655440000\",\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}"

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"
}

{
  "state": "ready",
  "candidate_hash": "<string>",
  "resource_hash": "<string>",
  "config": {},
  "dependency_hash": "<string>",
  "preparation_operation_id": "<string>",
  "retry_after_seconds": 30
}

{
  "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."
}

PUT

agents

{agent_id}

Replace agent

curl --request PUT \
  --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>",
  "language": "<string>",
  "region": "eu-west",
  "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
  },
  "inbound_greeting": "<string>",
  "outbound_greeting": "<string>",
  "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,
  "schema_version": 2,
  "tool_mode": "shared",
  "tool_refs": [],
  "mcp_refs": [],
  "template_id": "550e8400-e29b-41d4-a716-446655440000",
  "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": []
}
'

import requests

url = "https://api.agents.slng.ai/v1/agents/{agent_id}"

payload = {
    "name": "<string>",
    "system_prompt": "<string>",
    "greeting": "<string>",
    "language": "<string>",
    "region": "eu-west",
    "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
    },
    "inbound_greeting": "<string>",
    "outbound_greeting": "<string>",
    "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,
    "schema_version": 2,
    "tool_mode": "shared",
    "tool_refs": [],
    "mcp_refs": [],
    "template_id": "550e8400-e29b-41d4-a716-446655440000",
    "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": []
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    system_prompt: '<string>',
    greeting: '<string>',
    language: '<string>',
    region: 'eu-west',
    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
    },
    inbound_greeting: '<string>',
    outbound_greeting: '<string>',
    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,
    schema_version: 2,
    tool_mode: 'shared',
    tool_refs: [],
    mcp_refs: [],
    template_id: '550e8400-e29b-41d4-a716-446655440000',
    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: []
  })
};

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 => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'system_prompt' => '<string>',
    'greeting' => '<string>',
    'language' => '<string>',
    'region' => 'eu-west',
    '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
    ],
    'inbound_greeting' => '<string>',
    'outbound_greeting' => '<string>',
    '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,
    'schema_version' => 2,
    'tool_mode' => 'shared',
    'tool_refs' => [
        
    ],
    'mcp_refs' => [
        
    ],
    'template_id' => '550e8400-e29b-41d4-a716-446655440000',
    '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' => [
        
    ]
  ]),
  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  \"language\": \"<string>\",\n  \"region\": \"eu-west\",\n  \"models\": {\n    \"stt\": \"slng/deepgram/nova:3-en\",\n    \"llm\": \"groq/openai/gpt-oss-120b\",\n    \"tts\": \"slng/deepgram/aura:2-en\",\n    \"tts_voice\": \"aura-2-thalia-en\",\n    \"stt_kwargs\": {},\n    \"llm_kwargs\": {},\n    \"tts_kwargs\": {},\n    \"fallbacks\": {\n      \"stt\": [],\n      \"llm\": [],\n      \"tts\": []\n    },\n    \"stt_final_timeout_s\": 1,\n    \"llm_first_token_timeout_s\": 1,\n    \"tts_first_audio_timeout_s\": 1,\n    \"failure_audio_enabled\": true\n  },\n  \"inbound_greeting\": \"<string>\",\n  \"outbound_greeting\": \"<string>\",\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  \"schema_version\": 2,\n  \"tool_mode\": \"shared\",\n  \"tool_refs\": [],\n  \"mcp_refs\": [],\n  \"template_id\": \"550e8400-e29b-41d4-a716-446655440000\",\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}")

	req, _ := http.NewRequest("PUT", 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.put("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  \"language\": \"<string>\",\n  \"region\": \"eu-west\",\n  \"models\": {\n    \"stt\": \"slng/deepgram/nova:3-en\",\n    \"llm\": \"groq/openai/gpt-oss-120b\",\n    \"tts\": \"slng/deepgram/aura:2-en\",\n    \"tts_voice\": \"aura-2-thalia-en\",\n    \"stt_kwargs\": {},\n    \"llm_kwargs\": {},\n    \"tts_kwargs\": {},\n    \"fallbacks\": {\n      \"stt\": [],\n      \"llm\": [],\n      \"tts\": []\n    },\n    \"stt_final_timeout_s\": 1,\n    \"llm_first_token_timeout_s\": 1,\n    \"tts_first_audio_timeout_s\": 1,\n    \"failure_audio_enabled\": true\n  },\n  \"inbound_greeting\": \"<string>\",\n  \"outbound_greeting\": \"<string>\",\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  \"schema_version\": 2,\n  \"tool_mode\": \"shared\",\n  \"tool_refs\": [],\n  \"mcp_refs\": [],\n  \"template_id\": \"550e8400-e29b-41d4-a716-446655440000\",\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}")
  .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::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"system_prompt\": \"<string>\",\n  \"greeting\": \"<string>\",\n  \"language\": \"<string>\",\n  \"region\": \"eu-west\",\n  \"models\": {\n    \"stt\": \"slng/deepgram/nova:3-en\",\n    \"llm\": \"groq/openai/gpt-oss-120b\",\n    \"tts\": \"slng/deepgram/aura:2-en\",\n    \"tts_voice\": \"aura-2-thalia-en\",\n    \"stt_kwargs\": {},\n    \"llm_kwargs\": {},\n    \"tts_kwargs\": {},\n    \"fallbacks\": {\n      \"stt\": [],\n      \"llm\": [],\n      \"tts\": []\n    },\n    \"stt_final_timeout_s\": 1,\n    \"llm_first_token_timeout_s\": 1,\n    \"tts_first_audio_timeout_s\": 1,\n    \"failure_audio_enabled\": true\n  },\n  \"inbound_greeting\": \"<string>\",\n  \"outbound_greeting\": \"<string>\",\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  \"schema_version\": 2,\n  \"tool_mode\": \"shared\",\n  \"tool_refs\": [],\n  \"mcp_refs\": [],\n  \"template_id\": \"550e8400-e29b-41d4-a716-446655440000\",\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}"

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"
}

{
  "state": "ready",
  "candidate_hash": "<string>",
  "resource_hash": "<string>",
  "config": {},
  "dependency_hash": "<string>",
  "preparation_operation_id": "<string>",
  "retry_after_seconds": 30
}

{
  "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

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

agent_id

string<uuid>

required

Voice agent ID.

Example:

"550e8400-e29b-41d4-a716-446655440000"

Body

application/json

name

string

required

Maximum string length: 255

system_prompt

string

required

System prompt (Handlebars template).

greeting

string

required

Default greeting.

language

string

required

Maximum string length: 10

region

string

required

Agent region code where the agent runs, for example eu-west (SLNG Managed) or eu-central-livekit (LiveKit Cloud). On replace, a new region moves the agent there, as a partial update does. See Agent regions.

Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$

Example:

"eu-west"

models

object

required

Model configuration for the agent runtime (STT + LLM + TTS).

Show child attributes

inbound_greeting

string | null

Optional greeting override for inbound calls.

outbound_greeting

string | null

Optional greeting override for outbound calls.

llm_router_enabled

boolean

default:true

Routes the agent's LLM traffic through SLNG's managed LLM routing layer. Enabled by default.

idle_nudges

object | null

Optional silence recovery behavior. The runtime can send two follow-up nudges, then speak a final message and hang up.

Show child attributes

enable_interruptions

boolean

default:true

schema_version

enum<integer> | null

AgentConfig schema version. Set this to 2 for portable shared-agent configuration documents.

Available options:

2

tool_mode

enum<string>

default:shared

New agents use the shared organisation tool library.

Available options:

shared

tool_refs

object[]

Published organisation or curated tools attached to this agent.

Maximum array length: 128

Show child attributes

mcp_refs

object[]

MCP server tools attached to this agent.

Maximum array length: 128

Show child attributes

template_id

string<uuid> | null

Optional SLNG agent template. It cannot be combined with explicit tool_refs.

Example:

"550e8400-e29b-41d4-a716-446655440000"

sip_inbound_trunk_id

string<uuid> | null

Example:

"550e8400-e29b-41d4-a716-446655440000"

sip_outbound_trunk_id

string<uuid> | null

Example:

"550e8400-e29b-41d4-a716-446655440000"

template_defaults

object

Show child attributes

template_variable_options

object

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

runtime_variables

object[]

Show child attributes

Response

Replaced agent.

string<uuid>

required

Example:

"550e8400-e29b-41d4-a716-446655440000"

organisation_id

string<uuid>

required

Example:

"550e8400-e29b-41d4-a716-446655440000"

name

string

required

system_prompt

string

required

greeting

string

required

language

string

required

region

string

required

models

object

required

Model configuration for the agent runtime (STT + LLM + TTS).

Show child attributes

idle_nudges

object

required

Optional silence recovery behavior. The runtime can send two follow-up nudges, then speak a final message and hang up.

Show child attributes

enable_interruptions

boolean

required

tool_mode

enum<string>

required

Tool system fixed when the agent was created. New agents use shared.

Available options:

legacy,

shared

tools

object[]

required

deprecated

read-only

Legacy compatibility output. New shared agents return an empty array. Use tool_refs and mcp_refs for all new configuration.

tool_refs

object[]

required

Show child attributes

mcp_refs

object[]

required

Show child attributes

livekit_deployment

string

required

Name of the runtime deployment serving this agent.

template_variables

object

required

Show child attributes

created_at

string<date-time>

required

Example:

"2026-01-15T10:30:00Z"

updated_at

string<date-time>

required

Example:

"2026-01-15T10:30:00Z"

inbound_greeting

string | null

outbound_greeting

string | null

project_id

string<uuid> | null

The project the agent belongs to.

Example:

"550e8400-e29b-41d4-a716-446655440000"

world_part_code

string | null

Gateway code of the place the agent's project runs in. Null when the project shows Not connected under World part.

Example:

"eu-west"

world_part_label

string | null

Display name of world_part_code.

models_validation_error

string | null

Set when the stored models configuration no longer validates against the current rules. In that case models is returned as stored, without validation.

llm_router_enabled

boolean

Whether the agent's LLM traffic is routed through SLNG's managed LLM routing layer.

sip_inbound_trunk_id

string<uuid> | null

Example:

"550e8400-e29b-41d4-a716-446655440000"

sip_outbound_trunk_id

string<uuid> | null

Example:

"550e8400-e29b-41d4-a716-446655440000"

runtime_variables

object[]

Show child attributes

deleted_at

string<date-time> | null

Example:

"2026-01-15T10:30:00Z"

Speech to text

Context Router (LLM)

Text to speech

Agents

Unified API

Metadata API

Authorizations

Path Parameters

Body

Response