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

# Create Assistant

> Create a new voice assistant with specific configuration.

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

The `Create Assistant` endpoint allows you to programmatically create a new voice assistant. You can configure its personality, voice, tools, and other settings.

## Endpoint

<div style={{backgroundColor: '#e6f4ea', color: '#1e7e34', padding: '10px', borderRadius: '4px', fontFamily: 'monospace', fontWeight: 'bold', display: 'inline-block', marginBottom: '20px'}}>
  POST /admin/assistant
</div>

## Request Flow

```mermaid theme={null}
sequenceDiagram
    participant App as Your App
    participant API as Voice API
    participant DB as Database

    App->>API: POST /admin/assistant
    Note right of App: Includes config, name,<br/>and preferences
    
    API->>API: Validate Request
    API->>DB: Create Assistant Record
    DB-->>API: Assistant Created
    
    API-->>App: 200 OK { assistant_id: "..." }
```

## Request Parameters

### Headers

| Header          | Type   | Required | Description                      |
| :-------------- | :----- | :------- | :------------------------------- |
| `workspace`     | string | **Yes**  | Your unique workspace ID.        |
| `organization`  | string | **Yes**  | Your organization ID.            |
| `Authorization` | string | **Yes**  | Bearer token for authentication. |
| `Content-Type`  | string | **Yes**  | Must be `application/json`.      |

### Body Parameters

| Parameter | Type   | Required | Description                             |
| :-------- | :----- | :------- | :-------------------------------------- |
| `name`    | string | **Yes**  | Name of the assistant.                  |
| `config`  | object | **Yes**  | Configuration object for the assistant. |

### Config Object

| Parameter         | Type   | Required | Description                                     |
| :---------------- | :----- | :------- | :---------------------------------------------- |
| `system_prompt`   | string | **Yes**  | The persona and instructions for the assistant. |
| `end_message`     | string | No       | Message to speak when ending the call.          |
| `tool_config`     | array  | No       | List of tools enabled for the assistant.        |
| `model`           | object | **Yes**  | LLM configuration (provider, model).            |
| `transcriber`     | object | **Yes**  | Transcriber configuration (provider, model).    |
| `voice`           | object | **Yes**  | Voice configuration (provider, voiceId, model). |
| `structured_data` | array  | No       | Schema for structured data extraction.          |

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl --location 'https://api.voice-agents.miraiminds.co/v1/admin/assistant' \
  --header 'workspace: 68a4410242a5c31c24ed063b' \
  --header 'organization: 68a44064be1aab154e4806ee' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <YOUR_TOKEN>' \
  --data '{
      "name": "test assistant",
      "config": {
          "system_prompt": "You are a helpful assistant.",
          "end_message": "Goodbye!",
          "tool_config": [],
          "model": {
              "provider": "openai",
              "model": "gpt-4o-mini"
          },
          "transcriber": {
              "provider": "deepgram",
              "model": "nova-3"
          },
          "voice": {
              "provider": "cartesia",
              "voiceId": "791d5162-d5eb-40f0-8189-f19db44611d8",
              "model": "sonic-2"
          },
          "structured_data": []
      }
  }'
  ```

  ```javascript Node.js theme={null}
  const myHeaders = new Headers();
  myHeaders.append("workspace", "68a4410242a5c31c24ed063b");
  myHeaders.append("organization", "68a44064be1aab154e4806ee");
  myHeaders.append("Content-Type", "application/json");
  myHeaders.append("Authorization", "Bearer <YOUR_TOKEN>");

  const raw = JSON.stringify({
    "name": "test assistant",
    "config": {
      "system_prompt": "You are a helpful assistant.",
      "end_message": "Goodbye!",
      "tool_config": [],
      "model": {
        "provider": "openai",
        "model": "gpt-4o-mini"
      },
      "transcriber": {
        "provider": "deepgram",
        "model": "nova-3"
      },
      "voice": {
        "provider": "cartesia",
        "voiceId": "791d5162-d5eb-40f0-8189-f19db44611d8",
        "model": "sonic-2"
      },
      "structured_data": []
    }
  });

  const requestOptions = {
    method: "POST",
    headers: myHeaders,
    body: raw,
    redirect: "follow"
  };

  fetch("https://api.voice-agents.miraiminds.co/v1/admin/assistant", requestOptions)
    .then((response) => response.json())
    .then((result) => console.log(result))
    .catch((error) => console.error(error));
  ```

  ```python Python theme={null}
  import requests
  import json

  url = "https://api.voice-agents.miraiminds.co/v1/admin/assistant"

  payload = json.dumps({
    "name": "test assistant",
    "config": {
      "system_prompt": "You are a helpful assistant.",
      "end_message": "Goodbye!",
      "tool_config": [],
      "model": {
        "provider": "openai",
        "model": "gpt-4o-mini"
      },
      "transcriber": {
        "provider": "deepgram",
        "model": "nova-3"
      },
      "voice": {
        "provider": "cartesia",
        "voiceId": "791d5162-d5eb-40f0-8189-f19db44611d8",
        "model": "sonic-2"
      },
      "structured_data": []
    }
  })
  headers = {
    'workspace': '68a4410242a5c31c24ed063b',
    'organization': '68a44064be1aab154e4806ee',
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <YOUR_TOKEN>'
  }

  response = requests.request("POST", url, headers=headers, data=payload)

  print(response.text)
  ```
</CodeGroup>

## Response

Returns a JSON object containing the created assistant details.

### Success Response (`200 OK`)

```json theme={null}
{
  "success": true,
  "message": "Assistant created successfully",
  "data": {
    "_id": "6927ec5c9322ed9f9fb55c68",
    "name": "test assistant",
    "config": { ... },
    "createdAt": "2025-11-27T10:00:00.000Z"
  }
}
```