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

# API Reference

> Vaani Backend API - Agent Builder, Call Management, and WebRTC

## Overview

The Vaani Backend API provides endpoints for building and configuring voice agents, triggering and managing calls, and connecting in-browser sessions via WebRTC. All endpoints require API key authentication via the `X-API-Key` header.

## Authentication

All endpoints require API key authentication. Include your API key in the request header:

```
X-API-Key: vaani_<your_key>
```

> [!NOTE]
>
> Keep your API key secure and never expose it in client-side code or public repositories.

## Base URL

All endpoints are prefixed with `/api/`. The base URL is:

```
https://api.vaanivoice.ai
```

## API Version

Current API version: **2.0.0**

***

## Agent Builder

Use these endpoints to programmatically create and configure agents via the API.

| Method | Endpoint | Description |
| - | - | - |
| `POST` | `/api/create-agent` | Create a new agent |
| `PATCH` | `/api/agent/{agent_id}/persona` | Update identity, AI providers |
| `PATCH` | `/api/agent/{agent_id}/training` | Update knowledge base, FAQ, guardrails |
| `PATCH` | `/api/agent/{agent_id}/experience` | Update conversational feel and call settings |
| `PATCH` | `/api/agent/{agent_id}/analysis` | Update post-call evaluation and data extraction |
| `PATCH` | `/api/agent/{agent_id}/deployment` | Update phone number routing |

All PATCH endpoints perform a **partial merge** - only the fields you send are updated.

***

## Call Management

| Method | Endpoint | Description |
| - | - | - |
| `POST` | `/api/trigger-call/` | Trigger an outbound call |
| `POST` | `/api/webrtc/token` | Generate a LiveKit WebRTC token |
| `GET` | `/api/call-history` | Paginated call history |
| `GET` | `/api/transcript/{call_id}` | Get call transcript |
| `GET` | `/api/call_details/{call_id}` | Get call details, summary, and extractions |
| `GET` | `/api/stream/{call_id}` | Stream audio recording |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.