Developer platform · v2

Version 2

View as MarkdownAll docs

Dvaarik Developer Platform

Voice AI agents API — bring your own AI keys and your own phone line; Dvaarik operates the realtime voice infrastructure. Every credential, machine key, limit, agent, call, and webhook belongs to one project.

  • API origin: https://api.developers.dvaarik.com
  • Console auth: Authorization: Bearer <account-access-token>
  • Machine auth: X-Api-Key: <project-api-key>
  • Voice orchestration: ₹0.50 or $0.005 per connected minute, rounded up to the next minute, prepaid in rupees or dollars
  • Pay as you go: no monthly platform fee, no minimum spend, no seat fee, no contract
  • Provider and carrier usage: billed directly by the accounts you bring
  • Chat replies: ₹0.05 or $0.0005 per AI reply, from the same wallet, charged once a reply is delivered; messages people send are free
  • Release scope: phone and browser calls, and typed chats through the chat API, your own Telegram bot, and a WhatsApp number or Instagram professional account on your own Meta app

> Release status: projects, scoped keys, provider accounts, agents, knowledge bases, browser and outbound voice sessions, carrier connections and numbers, chats and chat channels (Telegram, WhatsApp, Instagram), webhooks, and billing are all served on two doors — a machine door that takes a project key from your server, and a console door that takes your account session from the browser. The console never holds a project key. The full contract is on the API reference page, derived from the backend's OpenAPI document.

Ownership model#

Dvaarik separates three responsibilities:

1. You own AI providers. Connect credentials to one project. The API never returns the secret after save, and a call is admitted only against accounts the provider has confirmed. 2. You own telephony. Keep the carrier account, numbers, routing, compliance, and carrier bill. Twilio, Plivo, Exotel, FreJun/Teler, and Telnyx connect with your own credentials; Dvaarik hands you the URL each number must point at. 3. Dvaarik owns infrastructure. Realtime voice orchestration, interruption handling, project admission, exact per-minute (rounded up) metering, and signed, retried event delivery live here.

A missing or invalid project credential is an error. Runtime code does not silently use a shared Dvaarik credential.

Resource map#

ResourceMachine door (project key)Console door (account JWT)
Projects and keys—/v2/projects, /v2/api-keys
Provider catalogue—/v2/provider-catalog
Provider accounts/v2/provider-accounts/console/v2/projects/{project_id}/provider-accounts
Agents/v2/agents/console/v2/projects/{project_id}/agents
Knowledge bases/v2/knowledge-bases/console/v2/projects/{project_id}/knowledge-bases
Voice sessions/v2/voice/sessions (+ /outbound)/console/v2/projects/{project_id}/voice/sessions (+ /outbound)
Chats/v2/chats/console/v2/projects/{project_id}/chats
Chat channels (Telegram, WhatsApp, Instagram)/v2/chat-channels/console/v2/projects/{project_id}/chat-channels
Carriers and numbers/v2/carriers/console/v2/projects/{project_id}/carriers
Webhooks/v2/projects/{project_id}/webhooks/console/v2/projects/{project_id}/webhooks
Billing—/console/v2/billing

Both doors call the same service and return the same shapes, so what the console shows is exactly what your server sees.

Commercial and launch status#

The active voice rate has no plan ladder or provider bundle. Connected seconds are charged with fixed-point integer arithmetic against a prepaid wallet in rupees or dollars. AI and carrier providers charge you separately under your own accounts.

Agents answer phone and browser calls, and typed chats through the chat API, your own Telegram bot, and a WhatsApp number or Instagram professional account on your own Meta app (Chat agents). Each AI chat reply costs ₹0.05 or $0.0005 from the same wallet, charged once it is delivered; messages people send are free. Meta's and Telegram's own charges, if any, are billed to you by them. On calls, agents can also use tools from your own MCP servers and hand the call to another agent of the same project (Agents).

Reference sections

Start with the quickstart; the API reference is derived from the backend's OpenAPI document. Search with /.

Delivery

Billing

Start at the security boundary

Create a project, connect only its providers, and issue a narrowly scoped server key.