Agents

Create

POST /v1/agents
{
  "name": "Support LT",
  "prompt": "You are the receptionist for Acme Ltd. Be brief, factual, friendly.",
  "first_message": "Hello! How can I help you today?",
  "first_speaker": "assistant",
  "voice": "Sari",
  "language": "lt",
  "max_duration_sec": 300,
  "voicemail_action": "leave_message",
  "filler_phrases": "One moment please.\nLet me check that.",
  "webhook_url": "https://your-app.com/lionvoice",
  "transcript_email": "[email protected]",
  "transcript_email_enabled": true
}

Fields

| Field | Values |

|---|---|

| voice | Sari · Emma · Nathan · Adrian |

| language | lt · lv · en · ru |

| first_speaker | assistant · customer |

| voicemail_action | leave_message · hangup |

| max_duration_sec | 30–3600 |

Other methods

- `GET /v1/agents` — list

- `GET /v1/agents/{id}` — get

- `PATCH /v1/agents/{id}` — update (any subset of fields)

- `DELETE /v1/agents/{id}` — delete (knowledge detaches)

Agent behaviour notes

- **Knowledge** — all files assigned to the agent are appended to the system prompt as facts.

- **Tools** — the agent can call your HTTP endpoints live during the call (see Tools).

- **Fillers** — if a tool call takes longer than 2.5 s, a filler phrase is spoken so the caller never hears dead silence.