Calls & Telephony

Placing and managing live calls, phone-number inventory, Twilio provisioning, and the call terminal. All /api endpoints require a valid Bearer JWT and are scoped to the token's project_id.

Calls

Method	Path	Description
POST	/api/calls/initiate	Initiate an outbound call.
POST	/api/calls/{activity_id}/hangup	Hang up an in-progress call.
POST	/api/manual-call	Initiate a manual (agent-dialed) call.
POST	/api/twilio-token	Mint a Twilio client token for browser calling.

Terminal

Method	Path	Description
GET	/api/terminal/calls/scheduled	List scheduled calls.
GET	/api/terminal/calls/ongoing	List ongoing calls.
GET	/api/terminal/calls/ended	List ended calls.

Phone numbers

Method	Path	Description
GET	/api/phone-numbers	List the project's phone numbers.
GET	/api/phone-numbers/{id}	Fetch a phone number.
POST	/api/phone-numbers	Add a phone number.
PUT	/api/phone-numbers/{id}	Update a phone number.
DELETE	/api/phone-numbers/{id}	Remove a phone number.
POST	/api/phone-numbers/bulk	Bulk-add phone numbers.

Twilio provisioning

Method	Path	Description
POST	/api/twilio/fetch-numbers	Fetch numbers from the connected Twilio account.
POST	/api/twilio/available-numbers	Search Twilio for purchasable numbers.
POST	/api/twilio/purchase-number	Purchase a Twilio number.
POST	/api/twilio/release-number	Release a Twilio number.
POST	/api/twilio/provision-for-project	Provision Twilio resources for the project.
GET	/api/twilio/addresses	List Twilio regulatory addresses.
GET	/api/twilio/bundles	List Twilio regulatory bundles.