# WaterrAI API API

**Canonical:** https://apis.io/apis/waterr-ai/waterrai-api-api/  
**Provider:** waterr-ai — https://apis.io/providers/waterr-ai/  
**Base URL:** https://api.waterr.ai/v1  
**Documentation:** https://docs.waterr.ai/llms.txt

WaterrAI API API is one of 2 APIs that [waterr-ai](https://apis.io/providers/waterr-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

REST API for the WaterrAI meeting platform — create scenarios, spin up AI-driven meetings, fetch transcripts and analyses.

## Operations (60 of 69)

| Method | Path | Summary |
|---|---|---|
| GET | `/analyses/{id}` | Get an analysis by ID |
| GET | `/analyses/meeting/{meetingId}` | Get analysis by meeting ID |
| POST | `/analyses/trigger/{meetingId}` | Trigger manual analysis for a meeting |
| GET | `/goals` | Get all goals |
| POST | `/goals` | Create a new goal |
| PUT | `/goals/{id}` | Update a goal |
| DELETE | `/goals/{id}` | Delete a goal |
| GET | `/meetings` | Get all meetings |
| POST | `/meetings` | Create a new meeting |
| GET | `/meetings/{id}` | Get a meeting by ID |
| GET | `/meetings/{id}/events` | A meeting's event log |
| POST | `/meetings/{id}/actions` | Push an action into a live meeting |
| PUT | `/meetings/{meetingId}` | Update a meeting |
| DELETE | `/meetings/{meetingId}` | Delete a meeting |
| PUT | `/meetings/{meetingId}/end` | End a meeting |
| GET | `/avatars` | List the avatar catalog |
| GET | `/avatars/{id}` | Get an avatar by ID |
| GET | `/personas` | Get all personas |
| POST | `/personas` | Create a new persona |
| GET | `/personas/{id}` | Get a persona by ID |
| PUT | `/personas/{id}` | Update a persona |
| DELETE | `/personas/{id}` | Delete a persona |
| GET | `/recordings/url-with-thumbnail/{meetingId}` | Get recording CloudFront URL with thumbnail by Daily meeting ID |
| GET | `/recordings/meeting/{meetingId}` | Get recordings by meeting ID |
| GET | `/scenarios` | Get all scenarios |
| POST | `/scenarios` | Create a new scenario |
| PUT | `/personas/{id}/avatar` | Set a persona's avatar |
| PUT | `/scenarios/{id}` | Update a scenario |
| DELETE | `/scenarios/{id}` | Delete a scenario |
| GET | `/scenarios/{id}/export` | Export a scenario as JSON |
| GET | `/scenarios/membership/{membershipId}/meetings` | Get all meetings for all scenarios of a user |
| GET | `/transcripts/{id}` | Get a transcript by ID |
| GET | `/transcripts/meeting/{meetingId}` | Get transcripts by meeting ID |
| GET | `/voices` | List available voices |
| GET | `/custom-functions` | List tools |
| POST | `/custom-functions` | Create a tool |
| GET | `/custom-functions/{id}` | Get a tool |
| PATCH | `/custom-functions/{id}` | Update a tool |
| DELETE | `/custom-functions/{id}` | Delete a tool |
| POST | `/skill-packages` | Register a skill package version |
| GET | `/skill-packages` | List registered packages |
| POST | `/skill-installs` | Install a package |
| GET | `/skill-installs` | List installs |
| GET | `/skill-installs/{id}` | One install, with what it materialised and its keys |
| PATCH | `/skill-installs/{id}` | Update config, secrets or status |
| DELETE | `/skill-installs/{id}` | Uninstall — removes every row the install created |
| POST | `/skill-installs/{id}/upgrade` | Move an install to another registered version |
| POST | `/skill-installs/{id}/keys` | Mint a wsk_ key bound to the install (shown once) |
| POST | `/scenarios/{scenarioId}/skill-installs/{id}/attach` | Attach an installed skill to a scenario |
| DELETE | `/scenarios/{scenarioId}/skill-installs/{id}/attach` | Detach an installed skill from a scenario |
| POST | `/stage-tokens/introspect` | Introspect a stage token |
| GET | `/guardrails` | List guardrails |
| POST | `/guardrails` | Create a guardrail |
| GET | `/guardrails/{id}` | Get a guardrail |
| PATCH | `/guardrails/{id}` | Update a guardrail |
| DELETE | `/guardrails/{id}` | Delete a guardrail |
| GET | `/skills` | List skills |
| POST | `/skills` | Create a skill |
| GET | `/skills/{id}` | Get a skill |
| PATCH | `/skills/{id}` | Update a skill |

…and 9 more operations. They are listed in full on the page.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/waterr-ai/openapi/_original/waterr-ai-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/waterr-ai/json-schema/waterr-ai-custom-function-schema.json
- **JSONSchema** — https://artifacts.apis.io/waterr-ai/json-schema/waterr-ai-avatar-schema.json
- **JSONSchema** — https://artifacts.apis.io/waterr-ai/json-schema/waterr-ai-skill-schema.json
- **JSONSchema** — https://artifacts.apis.io/waterr-ai/json-schema/waterr-ai-guardrail-schema.json
- **JSONSchema** — https://artifacts.apis.io/waterr-ai/json-schema/waterr-ai-memory-schema.json
- **JSONSchema** — https://artifacts.apis.io/waterr-ai/json-schema/waterr-ai-memory-container-schema.json

## Other waterr-ai APIs (1)

- [WaterrAI API](https://apis.io/apis/waterr-ai/waterrai-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/waterr-ai/waterrai-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/waterr-ai/.