Made in 10Docs
GuidesAPI
ReferenceMeetings

Send a character into a meeting

Sends a character into a Zoom, Google Meet or Microsoft Teams meeting by its link, now or at `join_at`.

POST
/meetings

Authorization

secretKey
headerAuthorizationBearer <sk_live_… or sk_test_… (a prefix and 40 base62 characters)>

A secret key from the dashboard, sent as Authorization: Bearer sk_live_…. Live keys run real, charged calls; test keys (sk_test_…) run calls of at most 60 seconds, 20 a day per organization, never charged. Each key sees only its own env's calls, meetings, webhooks, memories and analytics. Publishable keys (pk_…) are refused.

Header Parameters

Idempotency-Key?string

Any string of 1 to 200 bytes (surrounding spaces are trimmed), unique per call you mean to start, such as a UUID. The same key gives back the same call. While the first request with it is still starting: 409 idempotency_in_progress; if it failed: 409 idempotency_failed (send a new key); used for another character: 422 idempotency_mismatch. Only the character is compared: a different max_seconds or metadata with the same key still gives back the first call. Keys are kept with the call, per organization and env: a test key and a live key sending the same value each get their own call (or meeting), never the other's. Use plain ASCII: a value that isn't is ignored, as if no key were sent.

Length1 <= length <= 200

Request Body

application/json
  1. body
Example
{  "character_id": "chr_4fT9kQ2mXw7LbN3pZs8V",  "meeting_url": "https://meet.google.com/abc-defg-hij",  "join_at": "2026-11-06T15:00:00Z"}
character_id*CharacterId

A character's id.

Match^chr_[0-9A-Za-z]{20}$
Example"chr_4fT9kQ2mXw7LbN3pZs8V"
meeting_url*string

A Zoom, Google Meet or Microsoft Teams meeting link (see createMeeting).

Lengthlength <= 2000
join_at?||

When to join: unix seconds, or an RFC 3339 time (2026-11-06T15:00:00Z, …+01:00). Left out, null or within 30 seconds: now. At most 5 minutes in the past and 90 days ahead.

max_seconds?|

The longest it stays. The character's max_call_seconds doesn't apply; the balance may cap it when it starts, and a test key's is 60.

Range60 <= value <= 10800
Default3600
bot_name?|

The name shown in the meeting, on one line. " (AI)" is added unless it already ends with "(AI)". Left out: the character's name and " (AI)".

Lengthlength <= 100
record?|

Record this meeting's call; left out or null, the character's record.

respond?|

When the character speaks (see Meeting.respond); left out or null, decided by who is there.

memory_key?|

Who the meeting is with, for memories, as for startCall.

metadata?|

Any JSON object of at most 4 KB, carried by the meeting, its call and their webhooks.

Response Body

A meeting this Idempotency-Key already made, as it is now.

application/json
  1. response

A character sent into a meeting.

Example
{  "id": "mtg_8Rk2Vn5XqL9mTb3PcW7z",  "character_id": "chr_4fT9kQ2mXw7LbN3pZs8V",  "character_name": "Sara",  "meeting_url": "https://meet.google.com/abc-defg-hij",  "platform": "google_meet",  "bot_name": "Sara (AI)",  "status": "scheduled",  "reason": null,  "error": null,  "waiting_room": false,  "join_at_unix": 1793977200,  "max_seconds": 3600,  "call_id": null,  "env": "live",  "metadata": {},  "memory_key": null,  "created_unix": 1793900000,  "joined_unix": null,  "ended_unix": null,  "record": true,  "respond": null,  "people": null,  "waiting_since_unix": null}
id*MeetingId
Match^mtg_[0-9A-Za-z]{20}$
Example"mtg_8Rk2Vn5XqL9mTb3PcW7z"
character_id*CharacterId

A character's id.

Match^chr_[0-9A-Za-z]{20}$
Example"chr_4fT9kQ2mXw7LbN3pZs8V"
character_name*string|null
meeting_url*string

The link as it is used (without a #fragment).

platform*string
Value in"zoom""google_meet""microsoft_teams"
bot_name*string

The name it has in the meeting. It always says it is an AI.

status*MeetingStatus

scheduled (waiting for its time, or for the bot to be sent), joining (the bot is on its way in, or waiting to be let in), in_meeting, ended (it was in and left, or it was called off), failed (it never got in; nothing charged).

Value in"scheduled""joining""in_meeting""ended""failed"
reason*|

Why it ended or failed; null until then.

error*|

For a failed meeting, a plain sentence saying why ("Nobody let the AI in from the waiting room within 10 minutes. Nothing was charged."); null otherwise.

waiting_room*boolean

Whether the bot is waiting to be let in, now.

join_at_unix*|

When it joins; null for at once.

Formatint64
max_seconds*integer

The longest it stays: what was asked for, then (once it is on its way) what the balance covers, 60 seconds for a test key.

call_id*|

Its call (getCall), once it is on its way; null before.

env*Env

live (real, charged) or test (a test key's, never charged).

Value in"live""test"
metadata*

What you sent ({} otherwise). Its call carries it too.

memory_key*string|null
created_unix*Unix

Unix seconds, UTC.

Formatint64
Example1793300000
joined_unix*|

When the bot got in.

Formatint64
ended_unix*|

When it ended or failed.

Formatint64
record*boolean

Whether its call records the voices (the character's record unless you said). When it does, the meeting is told: in the bot's first line and in the meeting's chat.

respond*|

When the character speaks: when_addressed (by its name, "AI" or "assistant", or right after it spoke), always (everything said, as on a call), or null (only when addressed once more than one other person is there; everything in a one-to-one).

people*|

The other people in the meeting now (not our bot, not other bots or note-takers); null until the meeting has said who joined.

waiting_since_unix*|

When the bot first waited in the meeting's waiting room; null if it never did.

Formatint64
Example Request
curl -X POST 'https://api.daxov.com/v1/meetings' \  -H 'Idempotency-Key: 5f0c7a52-3d1e-4b8a-9f61-2c4d8e7b9a10' \  -H 'Content-Type: application/json' \  -d '{  "character_id": "chr_4fT9kQ2mXw7LbN3pZs8V",  "meeting_url": "https://meet.google.com/abc-defg-hij",  "join_at": "2026-11-06T15:00:00Z"}'
Example Response
{  "id": "mtg_8Rk2Vn5XqL9mTb3PcW7z",  "character_id": "chr_4fT9kQ2mXw7LbN3pZs8V",  "character_name": "Sara",  "meeting_url": "https://meet.google.com/abc-defg-hij",  "platform": "google_meet",  "bot_name": "Sara (AI)",  "status": "scheduled",  "reason": null,  "error": null,  "waiting_room": false,  "join_at_unix": 1793977200,  "max_seconds": 3600,  "call_id": null,  "env": "live",  "metadata": {},  "memory_key": null,  "created_unix": 1793900000,  "joined_unix": null,  "ended_unix": null,  "record": true,  "respond": null,  "people": null,  "waiting_since_unix": null}