Voice Agents

A Voice Agent contains its name, engine, instructions, optional voice and language, engine_config, interruption policy, and recording policy.

Choose an engine

Engine	Required provider roles	Description
`realtime`	`realtime`	One provider handles the realtime voice session.
`composable`	`stt`, `llm`, `tts`	Separate speech recognition, language model, and speech synthesis providers.

The default language is en; interruption_policy accepts allow or disabled, and recording_policy accepts none or all.

Create an agent

curl -sS -X POST "https://api.leamout.com/v1/voice-agents/" \
  -H "Authorization: Bearer $LEAMOUT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Customer support",
    "engine": "composable",
    "instructions": "Help customers with product questions.",
    "interruption_policy": "allow",
    "recording_policy": "none"
  }'

Bind AI integrations

Use AI integrations to create and verify provider credentials. Assign each required provider role to the agent, then check:

curl -sS "https://api.leamout.com/v1/voice-agents/$VOICE_AGENT_ID/readiness" \
  -H "Authorization: Bearer $LEAMOUT_TOKEN"

The response includes ready, configuration_revision, bindings, and issues. Calls requiring this agent are rejected when readiness fails.

Bind a phone number

An inbound binding associates an existing organization-owned number with an agent:

curl -sS -X POST "https://api.leamout.com/v1/voice-agents/$VOICE_AGENT_ID/bindings" \
  -H "Authorization: Bearer $LEAMOUT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"phone_number_id":"YOUR_NUMBER_UUID"}'

List bindings using GET /v1/voice-agents/{voice_agent_id}/bindings and delete one using DELETE /v1/voice-agents/{voice_agent_id}/bindings/{binding_id}. An agent can also have tools to execute authorized actions during a live conversation.

Get started

Calling

SIP connectivity

Data & security

Usage

Webhooks

Reference

Voice Agents

Choose an engine

Create an agent

Bind AI integrations

Bind a phone number

​Choose an engine

​Create an agent

​Bind AI integrations

​Bind a phone number

Choose an engine

Create an agent

Bind AI integrations

Bind a phone number