Quickstart

This walks through starting a web voice session end to end. You’ll need a workspace API key and a login session (see Authentication).

Verify your workspace

curl "$LEHAR_BASE_URL/workspace" -H "X-API-KEY: $LEHAR_API_KEY"

List published agents

curl "$LEHAR_BASE_URL/agent/all" -H "X-API-KEY: $LEHAR_API_KEY"

Pick an id from the returned catalog.

Create a session

Session creation is authenticated with a bearer login session, not an API key.

curl -X POST "$LEHAR_BASE_URL/sessions" \
  -H "Authorization: Bearer $LEHAR_LOGIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_sales_hi",
    "custom_variables": { "callee_name": "Jane", "company": "Acme" }
  }'

The session runs the agent’s saved config. The response includes participant_token, room_name, and livekit_url.

Connect the participant

Use the returned values to connect a voice client in the browser. The agent joins the room automatically.

Read results

Fetch session state any time:

curl "$LEHAR_BASE_URL/sessions/$SESSION_ID" -H "X-API-KEY: $LEHAR_API_KEY"

Or subscribe to webhooks for transcript and cost.

Prompt placeholders like {{company}} are filled from custom_variables at dispatch time. {{callee_name}} is built in: it also comes from the call’s callee name, and is spoken in Title Case.

Get Started

Key Concepts

Guides

Deep Dives