Create agent

curl --request POST \
  --url https://api.agents.slng.ai/v1/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "schema_version": 2,
  "tool_mode": "shared",
  "name": "Appointment Reminder",
  "system_prompt": "You are a friendly appointment reminder for {{clinic_name}}. Confirm the patient's upcoming visit or help them reschedule. Keep responses to one or two sentences.",
  "greeting": "Hi {{patient_name}}, this is a reminder from {{clinic_name}} about your upcoming appointment.",
  "language": "en",
  "region": "eu-central",
  "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"
  },
  "tool_refs": [],
  "mcp_refs": [],
  "template_defaults": {
    "clinic_name": "Downtown Health Clinic",
    "patient_name": "there"
  }
}
EOF

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

POST

agents

curl --request POST \
  --url https://api.agents.slng.ai/v1/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "schema_version": 2,
  "tool_mode": "shared",
  "name": "Appointment Reminder",
  "system_prompt": "You are a friendly appointment reminder for {{clinic_name}}. Confirm the patient's upcoming visit or help them reschedule. Keep responses to one or two sentences.",
  "greeting": "Hi {{patient_name}}, this is a reminder from {{clinic_name}} about your upcoming appointment.",
  "language": "en",
  "region": "eu-central",
  "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"
  },
  "tool_refs": [],
  "mcp_refs": [],
  "template_defaults": {
    "clinic_name": "Downtown Health Clinic",
    "patient_name": "there"
  }
}
EOF

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

Authorizations

Authorization

string

header

required

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

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

enum<string>

required

Region where the agent runs.

Available options:

us-east,

eu-central,

ap-south

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

Agent created.

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

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"

Overview

Unified API

Text-to-Speech

Speech-to-Text

Managed Agents

Agent resources

Batch

Account

Bridges

Authorizations

Body

Response