Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.kataven.ai/llms.txt

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

Place outbound voice calls. Server enforces caller-ID ownership and per-tenant cost caps. Wrapped by the Python SDK and Node SDK.

​
Endpoints at a glance

MethodPathSummary
POST/api/v1/calls/originateOriginate an outbound call

​
Reference

​
POST /api/v1/calls/originate

Originate an outbound call Places an outbound call from one of your registered phone numbers to an arbitrary E.164 destination using a configured agent. Subject to per-tenant cost caps (see /api/v1/call-limits). Request body (application/json) Schema: handlers.originateRequest. Server-set fields (id, created_at, updated_at, …) are ignored if supplied; only the user-settable fields are shown below.
FieldTypeDescription
agent_idstringe.g. agent_01HZ2N7G3K8M0Q5R7T9V2X4Y6Z
from_numberstringe.g. +12025550123
to_numberstringe.g. +14155550100
Responses
CodeDescriptionBody
200OKobject
400Invalid body or missing fieldstring
404Phone number or agent not foundstring
429Cost cap exceededstring
500Carrier or database errorstring
Example 
curl https://api.kataven.ai/v1/calls/originate \
  -X POST \
  -H "Authorization: Bearer $KATAVEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "agent_id": "agent_01HZ2N7G3K8M0Q5R7T9V2X4Y6Z",
  "from_number": "+12025550123",
  "to_number": "+14155550100"
}'