Skip to main content
POST
Import agent

Authorizations

Authorization
string
header
required

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

Query Parameters

sip_outbound_trunk_id
string<uuid>

Optional outbound SIP trunk to attach to the imported agent.

Example:

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

Body

application/json

Canonical agent configuration document, exactly as produced by the agent config download endpoints. The document is a portable, secret-free representation of the agent's configuration; webhook auth is carried as organisation Vault secret references. Treat it as an opaque file: download, store, and re-import it without modification.

Response

Agent created from the imported config.

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
region
string
required
models
object
required

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

idle_nudges
object
required

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

enable_interruptions
boolean
required
tools
(Template tool · object | Utility tool · object | Webhook · object | Human transfer · object)[]
required
livekit_deployment
string
required

Name of the runtime deployment serving this agent.

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
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[]
deleted_at
string<date-time> | null
Example:

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