> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vatel.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Overview of the Vatel AI REST and WebSocket APIs for building and managing voice agents.

# 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

| API       | Base URL                  |
| --------- | ------------------------- |
| REST      | `https://api.vatel.ai/v1` |
| WebSocket | `wss://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](/api-reference/session/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.

<CardGroup cols={2}>
  <Card title="Organization" icon="building" href="/api-reference/organization/get-organization">
    Resolve the organization for your API key.
  </Card>

  <Card title="Agents" icon="users" href="/api-reference/agents/list-agents">
    CRUD agents, list and publish versions, and outbound dial via Twilio or SIP trunk.
  </Card>

  <Card title="Calls" icon="list-ul" href="/api-reference/calls/list-calls">
    Paginated call history, single call details, and WAV recording download.
  </Card>

  <Card title="Session token" icon="key" href="/api-reference/session/session-token">
    Short-lived JWT for a given agent; required for WebSocket sessions and embed auth.
  </Card>

  <Card title="SIP trunks" icon="network-wired" href="/api-reference/sip-trunks/list-sip-trunks">
    Trunk CRUD and agent assignments for inbound routing.
  </Card>

  <Card title="LLMs" icon="brain" href="/api-reference/llms/list-llms">
    List allowed `provider/model` strings for agent LLM fields.
  </Card>

  <Card title="Voices" icon="microphone" href="/api-reference/voices/list-voices">
    Aggregated TTS voice catalog from configured providers.
  </Card>

  <Card title="Twilio numbers" icon="phone" href="/api-reference/twilio/list-twilio-numbers">
    List, import, and relabel imported phone numbers.
  </Card>
</CardGroup>

## 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.

<Card title="Connection" icon="radio" href="/api-reference/session/connection">
  Single bidirectional channel. Send audio and recieve agent responses.
</Card>

## Quick reference

| Area                                                         | Purpose                                              |
| ------------------------------------------------------------ | ---------------------------------------------------- |
| [Organization](/api-reference/organization/get-organization) | GET `/organization` - current org from API key       |
| [Agents](/api-reference/agents/list-agents)                  | `/agents` - CRUD, versions, publish, dial            |
| [Calls](/api-reference/calls/list-calls)                     | `/calls` - list, get, recording download             |
| [Session token](/api-reference/session/session-token)        | POST `/session-token` - JWT for an agent             |
| [SIP trunks](/api-reference/sip-trunks/list-sip-trunks)      | `/sip-trunks` - trunks and `/assignments`            |
| [LLMs](/api-reference/llms/list-llms)                        | GET `/llms` - allowed model id strings               |
| [Voices](/api-reference/voices/list-voices)                  | GET `/voices` - TTS voice catalog                    |
| [Twilio](/api-reference/twilio/list-twilio-numbers)          | `/twilio/numbers` - list, import, update label       |
| [Connection](/api-reference/session/connection)              | WebSocket `/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.