Developer Introduction

Welcome to the Voice Agents Developer Hub. Our API allows you to programmatically trigger voice calls, manage agents, and integrate voice capabilities directly into your applications.

Base URL

All API requests should be made to:

https://api.voice-agents.miraiminds.co

Authentication

Every request except GET /health carries two key headers. Workspace-scoped endpoints add a third.

Header	Description
`x-public-key`	Your public key (`pk_` + 32 hex)
`x-private-key`	Your private key (`sk_` + 64 hex) — secret, also signs webhooks
`workspace`	Your workspace `_id` (e.g. `6690a1b2c3d4e5f600000002`), on workspace-scoped endpoints

Full details: v1 authentication.

Quick Start

Get your Credentials Contact sneh@miraiminds.co to obtain your workspace, organization, and Authorization token.
Choose an Assistant Identify the assistant_id of the voice agent you want to trigger.
Make your first Call Use POST /v2/call/initiate to trigger an outbound call immediately.

Common Error Codes

Code	Meaning
`200`	Success
`400`	Bad Request (Check your JSON body)
`401`	Unauthorized (Check your workspace/org headers)
`429`	Rate Limit Exceeded
`500`	Internal Server Error