Made in 10Docs
GuidesAPI
ReferenceMeetings

Get a meeting

One meeting, brought up to date first.

GET
/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"

Response Body

The meeting.

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 GET 'https://api.daxov.com/v1/meetings/mtg_8Rk2Vn5XqL9mTb3PcW7z'
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}