> ## Documentation Index
> Fetch the complete documentation index at: https://docs.miraiminds.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Developer Introduction

> Get started with the Voice Agents API to build programmatic voice interactions.

<Note>
  **This documents the v1 product.** It is kept for integrations already running
  on it. If you are building something new, start with the
  [Quickstart](/v2/quickstart).
</Note>

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:

```bash theme={null}
https://api.voice-agents.miraiminds.co/v1
```

## Authentication

We use a workspace and organization-based authentication system. Every request to the API must include the following headers to identify your account:

| Header          | Description                                                         |
| :-------------- | :------------------------------------------------------------------ |
| `workspace`     | Your unique workspace identifier (e.g., `68d63c242cd956c2bb41cd3a`) |
| `organization`  | Your organization identifier (e.g., `68d63c242cd956c2bb41cd12`)     |
| `Authorization` | Your Bearer token (e.g., `Bearer eyJhbGciOiJIUzI1Ni...`)            |

<Note>
  To get your Organization ID, Workspace ID, and Authorization Token, please contact [sneh@miraiminds.co](mailto:sneh@miraiminds.co).
</Note>

## Quick Start

<Steps>
  <Step title="Get your Credentials">
    Contact [sneh@miraiminds.co](mailto:sneh@miraiminds.co) to obtain your `workspace`, `organization`, and `Authorization` token.
  </Step>

  <Step title="Choose an Assistant">
    Identify the `assistant_id` of the voice agent you want to trigger.
  </Step>

  <Step title="Make your first Call">
    Use our [Make a Call](/developers/make-a-call) endpoint to trigger an outbound call immediately.
  </Step>
</Steps>

## 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                           |