Meetings

A meeting is a live AI conversation session. Creating one spins up a Daily.co video room with your AI persona ready to talk and returns the join URL.

Every account is auto-seeded with two ready-to-use scenarios — Plus One and Requirement Gathering. List them with GET /scenarios and look for the default_kind field. No need to build a scenario before your first meeting.

Create a meeting

The minimum you need is a scenario_id and a person_name.

curl -X POST https://api.waterr.ai/v1/meetings \
  -H "Authorization: Bearer wai_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "person_name": "John Doe",
    "scenario_id": "scenario-uuid"
  }'

string

required

Name of the participant joining the session.

string

required

UUID of the scenario this meeting runs.

string

Override the persona’s default voice for this session. See Voices.

string

regular (default) or instant.

string

Session-specific context injected into the AI’s prompt without changing the scenario. Use this to personalize: “Candidate has 8 years at Google, focus on ML infrastructure.”

Response

{
  "success": true,
  "data": {
    "id": "meeting-uuid",
    "daily_meeting_url": "https://waterr-xx.daily.co/abc123",
    "room_token": "eyJhbGciOiJIUzI1NiIs...",
    "meeting_url": "https://waterr.ai/meeting/meeting-uuid",
    "status": "created"
  },
  "session_minutes_info": {
    "estimatedMinutes": 25,
    "remainingMinutes": 75
  }
}

Field	Use
`meeting_url`	WaterrAI-hosted page — easiest way to drop a user in.
`daily_meeting_url`	Raw Daily.co room URL — for embeds or SDK joins.
`room_token`	Auth token for SDK joins.
`id`	Use this to fetch post-meeting data.

Joining the meeting

Hosted page — redirect the participant to meeting_url. Iframe embed:

<iframe
  src="DAILY_MEETING_URL?t=ROOM_TOKEN"
  allow="camera; microphone; autoplay; display-capture"
  style="width: 100%; height: 600px; border: none;"
></iframe>

Daily.co SDK for full UI control:

import DailyIframe from '@daily-co/daily-js';
const call = DailyIframe.createCallObject();
await call.join({ url: data.daily_meeting_url, token: data.room_token });

End-user meetings (no JWT)

For public or embedded scenarios, you can create a meeting without an API key — session minutes are billed to the scenario creator’s account.

curl -X POST https://api.waterr.ai/v1/meetings/end-user \
  -H "Content-Type: application/json" \
  -d '{
    "person_name": "Jane Smith",
    "scenario_id": "scenario-uuid",
    "end_user_id": "end-user-uuid"
  }'

After the meeting ends

GET /meetings/{id} returns the meeting along with its transcript, summary, and goal scores. See Post-Meeting Data.

All meeting endpoints

Method	Endpoint	Use
`POST`	`/meetings`	Create
`GET`	`/meetings/{id}`	Get one — includes transcript + analysis
`GET`	`/meetings`	List
`PUT`	`/meetings/{id}/end`	End a live meeting
`PUT`	`/meetings/{id}`	Update
`DELETE`	`/meetings/{id}`	Delete

Getting Started

Personas

Scenarios

Embed Scenario

Post-Meeting Data

Goals

Avatars

Voices

Tools

Users

Guides

Integrations

Agent Skills

Meetings

Create a meeting

Response

Joining the meeting

End-user meetings (no JWT)

After the meeting ends

All meeting endpoints

​Create a meeting

​Response

​Joining the meeting

​End-user meetings (no JWT)

​After the meeting ends

​All meeting endpoints

Create a meeting

Response

Joining the meeting

End-user meetings (no JWT)

After the meeting ends

All meeting endpoints