Core resources

Calls

Start web (browser) calls, read call records, transcripts, recordings, the per-turn event timeline, and analytics. Outbound phone calls are started via the Phone numbers → dial endpoint.

POST/calls calls:write

Start a web call

Create a browser call to an assistant. Returns a LiveKit room token + websocket URL to connect from the client.

Body

agentId*	uuid	Assistant to run.
metadata	object	Arbitrary metadata stored on the call.

bash

curl -X POST https://api.bolchoai.in/v1/calls -H "Authorization: Bearer $BOLCHO_API_KEY" -H "Content-Type: application/json" \
  -d '{ "agentId": "'$AGENT_ID'" }'

Response

json

{ "callId": "c1…", "room": "call_…", "token": "<livekit-jwt>", "wsUrl": "wss://…livekit.cloud" }

GET/calls calls:read

List calls

List calls, newest first, with rich filters.

Query parameters

agentId	uuid	Filter by assistant.
status	string	queued \| in_progress \| completed \| failed.
direction	string	inbound \| outbound \| web.
endedReason	string	Filter by how the call ended.
success	boolean	true \| false — filter by success evaluation.
from	string	ISO date — calls on/after this time.
to	string	ISO date — calls on/before this time.
minCost	number	Minimum call cost in USD.
limit	number	Page size.
offset	number	Pagination offset.

bash

curl "https://api.bolchoai.in/v1/calls?limit=20&status=completed" -H "Authorization: Bearer $BOLCHO_API_KEY"

GET/calls/{id} calls:read

Get call

Full call record: status, end reason, duration, cost breakdown, summary, structured data, TTS-cache savings, and the transcript turns.

Path parameters

id*

uuid

Call id.

bash

curl https://api.bolchoai.in/v1/calls/$ID \
  -H "Authorization: Bearer $BOLCHO_API_KEY"

GET/calls/{id}/events calls:read

Get event timeline

The ordered event stream for session replay — turn latencies, tool calls, speech events.

Path parameters

id*

uuid

Call id.

bash

curl https://api.bolchoai.in/v1/calls/$ID/events \
  -H "Authorization: Bearer $BOLCHO_API_KEY"

GET/calls/{id}/recording calls:read

Get recording URL

A short-lived signed URL to the call audio recording.

Path parameters

id*

uuid

Call id.

bash

curl https://api.bolchoai.in/v1/calls/$ID/recording \
  -H "Authorization: Bearer $BOLCHO_API_KEY"

Response

json

{ "url": "https://…?signature=…" }

GET/calls/analytics analytics:read

Analytics rollup

Daily time-series + totals: calls, minutes, cost, success rate, latency (avg/p95), TTS-cache savings, and outcome breakdown.

Query parameters

days	number	Window in days (default 14).
agentId	uuid	Scope the rollup to one assistant.

bash

curl https://api.bolchoai.in/v1/calls/analytics \
  -H "Authorization: Bearer $BOLCHO_API_KEY"