Made in 10Docs
GuidesAPI
ReferenceMeetings

Move or rename a meeting

Moves a meeting to another time or renames its bot, while it waits here (`scheduled`, before its bot is sent).

PATCH
/meetings/{meeting_id}

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.

Path Parameters

meeting_id*string

The meeting's id.

Match^mtg_[0-9A-Za-z]{20}$
Example"mtg_8Rk2Vn5XqL9mTb3PcW7z"

Request Body

application/json
  1. body

What to change on a meeting that waits; send one or both.

Properties1 <= properties
Example
{  "join_at": "2026-11-07T10:00:00Z",  "bot_name": "Sara from Acme"}
join_at?||

The new time: unix seconds or an RFC 3339 time; null (or within 30 seconds) for now. At most 5 minutes in the past and 90 days ahead.

bot_name?|

The new name; " (AI)" is added unless it ends with "(AI)". Null for the character's name.

Lengthlength <= 100

Response Body

The meeting, moved or renamed.

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 PATCH 'https://api.daxov.com/v1/meetings/mtg_8Rk2Vn5XqL9mTb3PcW7z' \  -H 'Content-Type: application/json' \  -d '{  "join_at": "2026-11-07T10:00:00Z",  "bot_name": "Sara from Acme"}'
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}