Skip to main content
POST
/
v1
/
agents
Create agent
curl --request POST \
  --url https://api.slng.ai/v1/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "system_prompt": "<string>",
  "greeting": "<string>",
  "language": "<string>",
  "models": {
    "stt": "slng/deepgram/nova:3-en",
    "llm": "groq/moonshotai/kimi-k2-instruct-0905",
    "tts": "slng/deepgram/aura:2-en",
    "tts_voice": "aura-2-thalia-en",
    "stt_kwargs": {},
    "llm_kwargs": {},
    "tts_kwargs": {}
  },
  "slng_api_key": "<string>",
  "inbound_greeting": "<string>",
  "outbound_greeting": "<string>",
  "enable_interruptions": true,
  "tools": [],
  "livekit_deployment": "default-eu",
  "sip_inbound_trunk_id": "550e8400-e29b-41d4-a716-446655440000",
  "sip_outbound_trunk_id": "550e8400-e29b-41d4-a716-446655440000",
  "template_defaults": {}
}
'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "organisation_id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "<string>",
  "system_prompt": "<string>",
  "greeting": "<string>",
  "language": "<string>",
  "models": {
    "stt": "slng/deepgram/nova:3-en",
    "llm": "groq/moonshotai/kimi-k2-instruct-0905",
    "tts": "slng/deepgram/aura:2-en",
    "tts_voice": "aura-2-thalia-en",
    "stt_kwargs": {},
    "llm_kwargs": {},
    "tts_kwargs": {}
  },
  "enable_interruptions": true,
  "tools": [
    {
      "type": "template",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "template": "hangup",
      "prompt": "<string>",
      "execution_policy": {
        "pre_action_message": {
          "enabled": false,
          "text": "<string>"
        }
      }
    }
  ],
  "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>",
  "sip_inbound_trunk_id": "550e8400-e29b-41d4-a716-446655440000",
  "sip_outbound_trunk_id": "550e8400-e29b-41d4-a716-446655440000",
  "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
​
models
object
required

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

​
slng_api_key
string
required

SLNG API key the agent runtime uses to call STT/LLM/TTS.

​
inbound_greeting
string | null

Optional greeting override for inbound calls.

​
outbound_greeting
string | null

Optional greeting override for outbound calls.

​
enable_interruptions
boolean
default:true
​
tools
(Built-in · object | Webhook · object | Human transfer · object)[]

Built-in call control tools (hangup, voicemail detection).

​
livekit_deployment
string
default:default-eu

LiveKit deployment name (defaults to default-eu).

​
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

Response

Agent created.

​
id
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
​
models
object
required

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

​
enable_interruptions
boolean
required
​
tools
(Built-in · object | Webhook · object | Human transfer · object)[]
required
​
livekit_deployment
string
required
​
template_variables
object
required
​
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
​
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"

​
deleted_at
string<date-time> | null
Example:

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