aethexDocs

API Reference

Complete reference for the AethexAI REST API. Authenticate with the X-API-Key header.

Base URL:https://api.aethexai.com/api/v1

Agents

Create and manage voice agents, tools, and knowledge bases.

17 endpoints

Reference links

Point an agent at a URL and keep the crawled pages under review.

9 endpoints

Chat

Talk to an agent over text, using the same prompt and tools as a call.

1 endpoint

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.

2 endpoints

Auth (portal session)

Developer profile, logout, account delete. Portal JWT only — not callable with an API key.

6 endpoints

Calls

Initiate outbound calls, batch calls, and retrieve call history.

18 endpoints

Conversation (WebRTC)

Create authenticated WebRTC voice sessions and interact in real time.

8 endpoints

Conversations

Access conversation history, transcripts, audio, and feedback.

8 endpoints

Phone Numbers

Register and manage phone numbers via Twilio or SIP.

8 endpoints

Text messages

The messages an agent may text, and the carrier that sends them.

12 endpoints

Text conversations

Customer text threads, operator replies and campaigns.

15 endpoints

WhatsApp

WhatsApp Business numbers, templates, conversations, campaigns and calling.

41 endpoints

SIP Trunks

Create outbound SIP trunks, register caller IDs, and manage BYO-carrier trunk policy.

7 endpoints

Twilio Accounts

Register and manage per-account Twilio accounts. Required before registering Twilio phone numbers.

4 endpoints

Carrier accounts

Link a carrier API key and let Aethex provision the trunks.

5 endpoints

Microsoft Teams

Connect a Microsoft Teams tenant, attach your Teams numbers to agents, and place outbound calls over Azure Communication Services.

6 endpoints

Integrations

Provision voice agents from third-party tools like SurveyMonkey.

15 endpoints

Recordings

List, download, and manage call recordings.

4 endpoints

Transcription

Transcribe audio files synchronously or async with webhook delivery for longer recordings.

6 endpoints

Text-to-Speech

Convert text to speech audio with batch or streaming output.

4 endpoints

Voices

Browse TTS voices and preview audio samples.

10 endpoints

Models

The speech and language models available to your agents.

1 endpoint

Uploads

Presigned uploads for audio too large to post inline.

1 endpoint

Usage

Monitor API usage, daily/monthly breakdowns, and alerts.

10 endpoints