Introduction

Manage deployments, campaigns, outbound calls, and analytics for your voice agents over REST.
View as Markdown

The Sarvam Conversations API lets you manage your voice agents programmatically — create deployments, run outbound campaigns, place instant calls, and pull call analytics — 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.

$X-API-Key: <your-api-key>

Base URLs

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

ServiceBase URL
Deploymentshttps://apps.sarvam.ai/api/app-authoring
Campaigns & Cohortshttps://apps.sarvam.ai/api/scheduling
Instant Outboundhttps://apps.sarvam.ai/api/outbounds
Analyticshttps://apps.sarvam.ai/api
BYOKHosted 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