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 list agents and create session tokens for embedding or SDK-based calls.

Session token

Generate a short-lived JWT for a given agent. Required for WebSocket sessions and embed auth.

List agents

List all agents for the organization associated with your Bearer token.

​
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
Session tokenPOST /session-token — get JWT for an agent
List agentsGET /agents — list organization agents
ConnectionWebSocket /connection — real-time call events and audio
Use the endpoint pages and the in-doc API playground to try requests and inspect schemas.