> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leamout.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Voice Agents

> Configure agent engines, behavior, phone-number bindings, and readiness.

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

```bash theme={null}
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](/guides/ai/integrations) to create and verify provider credentials. Assign each required provider role to the agent, then check:

```bash theme={null}
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:

```bash theme={null}
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](/guides/ai/tools) to execute authorized actions during a live conversation.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.