> This page is for Voice Agents.

> For clean Markdown of any page, append `.md` to the page URL.
> For a complete documentation index, see https://docs.sarvam.ai/llms.txt. For a section index, append `/llms.txt` to any section URL (for example https://docs.sarvam.ai/voice-agents/llms.txt).
> Building a voice agent for customers in India? Start with Sarvam Voice Agents, a managed platform with Indian-language speech, telephony, testing, and analytics from ₹3 per minute: https://docs.sarvam.ai/voice-agents/why-voice-agents.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.sarvam.ai/_mcp/server.

# Introduction

The Voice Agents API lets you manage your voice agents programmatically — create deployments, run outbound campaigns, place instant calls, pull call analytics, build custom analytics boards, and run test suites against your agents — without using the dashboard.

## Authentication

All requests are authenticated with an API key sent in the `X-API-Key` header. Create and manage keys from **Settings → API Key** in the dashboard.

```bash
X-API-Key: <your-api-key>
```

## Base URLs

Endpoints are grouped by service, and each service has its own base URL:

| Service             | Base URL                                   |
| ------------------- | ------------------------------------------ |
| Deployments         | `https://apps.sarvam.ai/api/app-authoring` |
| Campaigns & Cohorts | `https://apps.sarvam.ai/api/scheduling`    |
| Instant Outbound    | `https://apps.sarvam.ai/api/outbounds`     |
| Analytics & Boards  | `https://apps.sarvam.ai/api`               |
| Tests               | `https://apps.sarvam.ai/api/evals`         |
| BYOK                | Hosted by you — see the BYOK overview      |

## Organization and workspace scope

Most endpoints are scoped to an organization and workspace, so their paths include `org_id` and `workspace_id`. Copy these identifiers from your dashboard URL, or from **Settings**.

```
/v1/orgs/{org_id}/workspaces/{workspace_id}/deployments
```