Introduction

This documents the v1 product. It is kept for integrations already running on it. If you are building something new, start with the Quickstart.

The Voice Agents API lets you onboard workspaces, create and manage assistants, initiate outbound calls and handle real-time webhook events.

Base URL

All API requests target the production server:

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

A staging environment is also available for testing:

https://api.stage.voice-agent.miraiminds.co

Authentication

Every request must include two API key headers:

Header	Description
`x-public-key`	Your public API key for identification
`x-private-key`	Your private API key for authorization

Most endpoints also require a workspace header to scope requests to a specific workspace.

curl -X POST https://api.voice-agents.miraiminds.co/v2/call/initiate \
  -H "x-public-key: pk_your_public_key" \
  -H "x-private-key: sk_your_private_key" \
  -H "workspace: your_workspace_id" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

Contact sneh@miraiminds.co to get your API keys and workspace ID.

API endpoints

The endpoints fall into these groups:

Onboarding

Assistant

Create, retrieve, and update voice agent configurations.

Call

Initiate outbound calls and abort queued calls.

Webhooks

Receive real-time call status and action events.

Organization

Archive and unarchive organizations and workspaces.

Voice Gallery

Browse available voice options for your agents.

Common error codes

Code	Meaning
`200`	Success
`201`	Resource created
`400`	Bad request: check your request body or parameters
`401`	Unauthorized: missing or invalid API keys
`403`	Forbidden: insufficient permissions
`404`	Not found: the resource does not exist
`429`	Rate limit exceeded: wait before retrying
`500`	Internal server error

Rate limits

The API rate-limits requests to keep the service stable. If you get a 429 response, wait before retrying. Assistant updates also have a cooldown period so that update operations don’t overlap.

Keep your x-private-key secure. Never expose it in client-side code or public repositories.

Start

Developer guides

API v1 reference

Endpoints

Guides

Integrations

Use cases

Base URL

Authentication

API endpoints

Onboarding

Assistant

Call

Webhooks

Organization

Voice Gallery

Common error codes

Rate limits

​Base URL

​Authentication

​API endpoints

Onboarding

Assistant

Call

Webhooks

Organization

Voice Gallery

​Common error codes

​Rate limits

Base URL

Authentication

API endpoints

Common error codes

Rate limits