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

# Introduction

> Build AI meetings programmatically with the WaterrAI API.

The WaterrAI API lets you spin up live AI video meetings, embed them in your product, and pull back transcripts and analysis when the meeting ends.

The fastest way to get started is the [Quick Start](https://docs.waterr.ai/api-reference/quickstart.md) — two calls and you have a live meeting room.

## Core APIs

> **[Meetings](https://docs.waterr.ai/api-reference/meetings)**
>
> Create a meeting from a `scenario_id` and get back a join URL.

> **[Personas](https://docs.waterr.ai/api-reference/personas)**
>
> Define the AI character — name, role, demeanor, voice.

> **[Scenarios](https://docs.waterr.ai/api-reference/scenarios)**
>
> Combine a persona with a script and goals. Two are auto-seeded for every account.

> **[Post-Meeting Data](https://docs.waterr.ai/api-reference/post-meeting)**
>
> Summary, transcript, and goal scores — all in one call.

## Integrations

> **[MCP Server](https://docs.waterr.ai/api-reference/mcp.md)**
>
> Plug WaterrAI into Claude, ChatGPT, Cursor, and other MCP-aware clients.

> **[Webhooks](https://docs.waterr.ai/api-reference/webhooks.md)**
>
> Get notified the moment meetings end and analyses complete.

## Authentication

Send your API key on every request:

```
Authorization: Bearer wai_<your_key>
```

Get a key at [waterr.ai/settings?tab=api-keys](https://waterr.ai/settings?tab=api-keys). Full details in [Authentication](https://docs.waterr.ai/api-reference/authentication.md).

## Base URL

```
https://api.waterr.ai/v1
```

## Response format

Most endpoints return:

```json theme={null}
{ "status": "success", "data": { ... } }
```

A few (users, meetings) return:

```json theme={null}
{ "success": true, "data": { ... } }
```

Errors:

```json theme={null}
{ "status": "error", "message": "Error description" }
```

## Rate limits

Rate limits are applied per API key. Check the response headers:

* `X-RateLimit-Limit` — max requests in window
* `X-RateLimit-Remaining` — requests left in window
* `X-RateLimit-Reset` — when the window resets

> [!TIP]
>
> New here? Start with the [Quick Start](https://docs.waterr.ai/api-reference/quickstart.md) — you'll have a live AI meeting URL in two API calls.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.