Read a dispatched join's live status. {id} is the join id returned by POST /v1/meetings/join. Requires the meetings:join scope. Returns { id, type:"meeting_join", status, bot_in_call, fatal_reason, team_id, updated_at } where status is one of dispatched | joining | in_waiting_room | in_call | recording | done | fatal (fatal_reason carries the reason, e.g. meeting_requires_sign_in). A join you do not own, or that does not exist, returns 404 not_found (indistinguishable). The meeting URL / passcode is never returned.

get/v1/meetings/join/{id}

Request

  • Base URL
    https://api.usebubbles.com
  • Auth
    HTTP bearer

Path parameters

idstring required

Resource id (bubbles also accept the short id used in app URLs).

Response

Success.

idstring required

The join id.

type'meeting_join' required

The resource type.

status'dispatched' | 'joining' | 'in_waiting_room' | 'in_call' | 'recording' | 'done' | 'fatal' required

The live join status.

bot_in_callboolean required

Whether the notetaker is currently in the call.

fatal_reasonstring nullable required

The failure reason when status is fatal (e.g. meeting_requires_sign_in), else null.

team_idstring nullable required

The workspace the recording is saved into, or null.

updated_atstring nullable required

Last status update instant (ISO-8601 UTC), or null.

Changes

No recorded changes to this operation across all 1 revision of this API.