Call Sessions API Documentation & Reference

Manage active call sessions, lifecycle events, metadata, communication states, and voice interaction workflows.

Endpoints

Method	Path	Description
POST	/calls	Start an outbound call
GET	/calls	List call sessions
GET	/calls/{id}	Get call details
POST	/calls/{id}/end	End an active call
WS	/calls/{id}/stream	Real-time audio stream

Start Outbound Call

curl -X POST https://api.voxentis.com/v1/calls \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agt_9f2k4h1a",
    "to": "+14155551234",
    "metadata": {
      "campaign": "Q1-outreach",
      "lead_id": "lead_xyz"
    }
  }'

Call Status Lifecycle

Status	Description
`ringing`	Call is being placed, waiting for answer
`in_progress`	Call is active, agent and caller are connected
`transferring`	Call is being transferred to another party
`completed`	Call ended normally
`failed`	Call could not connect (busy, no answer, network error)
`cancelled`	Call was ended before being answered

List Calls

Name	Type	Description
agent_id	string	Filter by agent
status	string	Filter by call status
direction	string	"inbound" or "outbound"
from_date	string	Start date (ISO 8601)
to_date	string	End date (ISO 8601)
page	integer	Page number (default: 1)
limit	integer	Items per page (default: 20)

End a Call

curl -X POST https://api.voxentis.com/v1/calls/call_7k3m9p2q/end \
  -H "Authorization: Bearer YOUR_API_KEY"

Inbound Calls

Inbound calls are created automatically when a caller dials a phone number assigned to one of your agents. Use the /phone-numbers endpoint to assign numbers to agents.