Skip to main content

​
Overview

The Vatel AI API lets you manage agents, generate session tokens for calls, and run real-time voice sessions over WebSockets. Use the REST API for configuration and session auth, and the WebSocket API for streaming audio and events during a call.

​
Base URLs

APIBase URL
RESThttps://api.vatel.ai/v1
WebSocketwss://api.vatel.ai/v1

​
Authentication

REST endpoints use Bearer token authentication with your organization API key. Send it in the Authorization header: 
Authorization: Bearer <your-api-key>
The same API key identifies your organization; agents must belong to that organization. WebSocket connections use a short-lived session token obtained from the REST API (see Session token).

​
REST API

Use the REST API to read your organization, list allowed LLMs and TTS voices, manage agents (including versions, publish, and outbound dial), list calls and recordings, import Twilio numbers, configure SIP trunks and per-trunk agent assignments, and mint session tokens for embedding or SDK-based calls.

Organization

Resolve the organization for your API key.

Agents

CRUD agents, list and publish versions, and outbound dial via Twilio or SIP trunk.

Calls

Paginated call history, single call details, and WAV recording download.

Session token

Short-lived JWT for a given agent; required for WebSocket sessions and embed auth.

SIP trunks

Trunk CRUD and agent assignments for inbound routing.

LLMs

List allowed provider/model strings for agent LLM fields.

Voices

Aggregated TTS voice catalog from configured providers.

Twilio numbers

List, import, and relabel imported phone numbers.

​
WebSocket API

The WebSocket API is used for real-time call sessions: the server sends session, audio, and transcript events; the client sends input audio.

Connection

Single bidirectional channel. Send audio and recieve agent responses.

​
Quick reference

AreaPurpose
OrganizationGET /organization — current org from API key
Agents/agents — CRUD, versions, publish, dial
Calls/calls — list, get, recording download
Session tokenPOST /session-token — JWT for an agent
SIP trunks/sip-trunks — trunks and /assignments
LLMsGET /llms — allowed model id strings
VoicesGET /voices — TTS voice catalog
Twilio/twilio/numbers — list, import, update label
ConnectionWebSocket /connection — real-time audio and events
Use the endpoint pages in the API reference tab and the in-doc playground to try requests and inspect schemas.