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`.
secretKeyAuthorizationBearer <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.
Idempotency-Key?stringAny 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.
1 <= length <= 200application/json- body
{ "character_id": "chr_4fT9kQ2mXw7LbN3pZs8V", "meeting_url": "https://meet.google.com/abc-defg-hij", "join_at": "2026-11-06T15:00:00Z"}character_id*CharacterIdA character's id.
^chr_[0-9A-Za-z]{20}$"chr_4fT9kQ2mXw7LbN3pZs8V"meeting_url*stringA Zoom, Google Meet or Microsoft Teams meeting link (see createMeeting).
length <= 2000join_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.
60 <= value <= 108003600bot_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)".
length <= 100record?|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.
A meeting this Idempotency-Key already made, as it is now.
application/json- response
A character sent into a meeting.
{ "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^mtg_[0-9A-Za-z]{20}$"mtg_8Rk2Vn5XqL9mTb3PcW7z"character_id*CharacterIdA character's id.
^chr_[0-9A-Za-z]{20}$"chr_4fT9kQ2mXw7LbN3pZs8V"character_name*string|nullmeeting_url*stringThe link as it is used (without a #fragment).
platform*string"zoom""google_meet""microsoft_teams"bot_name*stringThe name it has in the meeting. It always says it is an AI.
status*MeetingStatusscheduled (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).
"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*booleanWhether the bot is waiting to be let in, now.
join_at_unix*|When it joins; null for at once.
int64max_seconds*integerThe 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*Envlive (real, charged) or test (a test key's, never charged).
"live""test"metadata*What you sent ({} otherwise). Its call carries it too.
memory_key*string|nullcreated_unix*UnixUnix seconds, UTC.
int641793300000joined_unix*|When the bot got in.
int64ended_unix*|When it ended or failed.
int64record*booleanWhether 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.
int64curl -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"}'{ "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}