# Classic API

{% hint style="info" %}
**This is the Classic API** for text-based digital health experiences. It uses organization-scoped endpoints at `api.amigo.ai/v1` with per-user JWT authentication. For enterprise voice deployments with phone-based agents, EHR integration, and operator workflows, see the [Platform API](/developer-guide/platform-api/platform-api.md).
{% endhint %}

The Classic API provides programmatic access to text-based conversational AI: chat agents, async voice notes, WebSocket streaming, user management, simulations, and data access. It was built for consumer-facing digital health products.

## Overview

The Classic API is a RESTful API at `https://api.amigo.ai/v1/{organization}/...` that lets developers run conversations, manage users, deploy tools, and execute simulations. All endpoints return JSON responses and support standard HTTP methods (GET, POST, PUT, DELETE). The API is versioned (`/v1/`) so that existing integrations keep working as the platform evolves.

**Key capabilities:**

* **Organization Management**: create and configure organizations
* **Agents and Context Graphs**: define agent personas and conversational flows
* **User Management**: create and manage users, customize preferences
* **Service Discovery**: list available AI services and configurations
* **Tool Management**: version and deploy custom tools for agents
* **Conversations**: create, interact with, and manage AI conversations
* **Real-time Streaming**: WebSocket support for live voice and events
* **Simulations**: evaluate and test agent behavior with automated test suites
* **Admin**: platform configuration and debugging utilities

All operations are organization-scoped and require authentication. For complete endpoint specifications, see the [API Reference](https://docs.amigo.ai/api-reference).

## API Categories

### Organization Management

{% content-ref url="/pages/5qEfFjETuCjKtceKQ8Jh" %}
[Organization](/developer-guide/classic-api/core-api/organization.md)
{% endcontent-ref %}

### Agents & Context Graphs

{% content-ref url="/pages/dUssfSegVjBdSEZHGGwz" %}
[Agents & Context Graphs](/developer-guide/classic-api/core-api/agents-and-context-graphs.md)
{% endcontent-ref %}

### User Management

{% content-ref url="/pages/siVD5m89tzTjuEElMDKU" %}
[Users](/developer-guide/classic-api/core-api/users.md)
{% endcontent-ref %}

### Service Management

{% content-ref url="/pages/CRTLl3Mk9YncyqAAgHhz" %}
[Services](/developer-guide/classic-api/core-api/services.md)
{% endcontent-ref %}

### Tools

{% content-ref url="/pages/FiWFxckoVBai1s6IFcp1" %}
[Tools](/developer-guide/classic-api/core-api/tools.md)
{% endcontent-ref %}

### Admin

{% content-ref url="/pages/o0i4zCtnfcuZgkeijil8" %}
[Admin](/developer-guide/classic-api/core-api/admin.md)
{% endcontent-ref %}

### Conversations

The core of the platform for managing AI-powered conversations:

| Endpoint                                                                                                                            | Description                          |
| ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ |
| [**Create**](/developer-guide/classic-api/core-api/conversations/conversations-create.md)                                           | Initialize new conversations         |
| [**Interact**](/developer-guide/classic-api/core-api/conversations/conversations-interact.md)                                       | Send messages and receive responses  |
| [**Events**](/developer-guide/classic-api/core-api/conversations/conversations-events.md)                                           | Real-time event streaming            |
| [**Lifecycle**](/developer-guide/classic-api/core-api/conversations/conversations-lifecycle.md)                                     | Manage conversation states           |
| [**Voice**](/developer-guide/classic-api/core-api/conversations/conversations-voice.md)                                             | Voice-enabled conversations          |
| [**Real-time Voice (WebSocket)**](/developer-guide/classic-api/core-api/conversations/conversations-realtime.md)                    | Low-latency streaming via WebSocket  |
| [**External Events & Multi-Stream**](/developer-guide/classic-api/core-api/conversations/conversations-realtime-external-events.md) | Interleave external events and audio |
| [**Conversation History**](/developer-guide/classic-api/core-api/conversations/conversation-history.md)                             | Retrieve messages and interactions   |

### Simulations

[**Simulations**](/developer-guide/classic-api/core-api/simulations.md): evaluate and test agent behavior using simulated personas and scenarios.

| Endpoint                                                                                                     | Description                                        |
| ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------- |
| [**Personas**](/developer-guide/classic-api/core-api/simulations/simulation-personas.md)                     | Simulated user profiles with background and role   |
| [**Scenarios**](/developer-guide/classic-api/core-api/simulations/simulation-scenarios.md)                   | Conversation test scripts with objectives          |
| [**Unit Tests**](/developer-guide/classic-api/core-api/simulations/simulation-unit-tests.md)                 | Individual test cases combining persona + scenario |
| [**Unit Test Sets**](/developer-guide/classic-api/core-api/simulations/simulation-unit-test-sets.md)         | Grouped test suites with run counts                |
| [**Unit Test Set Runs**](/developer-guide/classic-api/core-api/simulations/simulation-unit-test-set-runs.md) | Execute suites and retrieve results                |

## Authentication

All API requests require authentication. See the [Authentication Guide](/developer-guide/getting-started/authentication.md) for details.

## Base URLs

| Region | Endpoint                                 |
| ------ | ---------------------------------------- |
| **US** | `https://api.amigo.ai/v1`                |
| **CA** | `https://api-ca-central-1.amigo.ai/v1`   |
| **EU** | `https://api-eu-central-1.amigo.ai/v1`   |
| **AU** | `https://api-ap-southeast-2.amigo.ai/v1` |

{% hint style="info" %}
**Regional Configuration**\
See [Regions & Endpoints](/developer-guide/getting-started/regions-and-endpoints.md) for guidance on choosing the right regional base URL and configuring dedicated clusters.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.amigo.ai/developer-guide/classic-api/core-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.