Skip to main content

Documentation Index

Fetch the complete documentation index at: https://katavenai.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

result = client.calls.originate(
    from_number="+12025550123",
    to_number="+14155550100",
    agent_id="<agent uuid>",
)
The pipeline is documented in Telephony — caller-ID ownership check, cost-cap check, decrypt creds, dispatch to Call Processor.

​
Cost-cap behavior

If your account is at its cap, the call returns 429:
429 reasonCause
Concurrent call limit reachedToo many calls in flight right now.
Call rate limitToo many calls in the current minute.
Daily call limit reachedToday’s call budget exhausted.
Daily minute budget exhaustedToday’s talk-time budget exhausted.
Pause and retry, or raise the cap with client.call_limits.update(...).

​
Watch the call live

The response includes session_id. Open https://hub.kataven.ai/conversations/<session_id> to see the transcript stream as the call happens. For programmatic monitoring, the Context Service has a separate HTTP admin surface — see the Context Service docs for /api/conversations/*.

​
Outbound at scale

For more than a handful of calls, use Campaigns instead — they handle concurrency budgeting, retries, and CSV-driven dispatch for you.