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" },
    "config": { "tts_provider": "sarvam", "voice": "anushka" }
  }'

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 usage.

Prompt placeholders like {{callee_name}} are filled from custom_variables at dispatch time.

Get Started

Key Concepts

Guides

Deep Dives