API Reference
Complete reference for the AethexAI REST API. Authenticate with the X-API-Key header.
https://api.aethexai.com/api/v1Agents
Create and manage voice agents, tools, and knowledge bases.
Reference links
Point an agent at a URL and keep the crawled pages under review.
Chat
Talk to an agent over text, using the same prompt and tools as a call.
API Keys
List your tenant's API keys and rotate the key you call with; rotating another key needs `api_keys:write`. Owners manage keys in the developer portal.
Auth (portal session)
Developer profile, logout, account delete. Portal JWT only — not callable with an API key.
Calls
Initiate outbound calls, batch calls, and retrieve call history.
Conversation (WebRTC)
Create authenticated WebRTC voice sessions and interact in real time.
Conversations
Access conversation history, transcripts, audio, and feedback.
Phone Numbers
Register and manage phone numbers via Twilio or SIP.
Text messages
The messages an agent may text, and the carrier that sends them.
Text conversations
Customer text threads, operator replies and campaigns.
WhatsApp Business numbers, templates, conversations, campaigns and calling.
SIP Trunks
Create outbound SIP trunks, register caller IDs, and manage BYO-carrier trunk policy.
Twilio Accounts
Register and manage per-account Twilio accounts. Required before registering Twilio phone numbers.
Carrier accounts
Link a carrier API key and let Aethex provision the trunks.
Microsoft Teams
Connect a Microsoft Teams tenant, attach your Teams numbers to agents, and place outbound calls over Azure Communication Services.
Integrations
Provision voice agents from third-party tools like SurveyMonkey.
Recordings
List, download, and manage call recordings.
Transcription
Transcribe audio files synchronously or async with webhook delivery for longer recordings.
Text-to-Speech
Convert text to speech audio with batch or streaming output.
Voices
Browse TTS voices and preview audio samples.
Models
The speech and language models available to your agents.
Uploads
Presigned uploads for audio too large to post inline.
Usage
Monitor API usage, daily/monthly breakdowns, and alerts.
