Sign in

v4

latestOpenAPI 3.1.02026-08-086635375.7 KB
Meetings

Get meeting invite

Get a meeting invite by ID for the authenticated organization.

get/v1/meetings/invites/{id}

Path parameters

idstring uuid required

Meeting invite ID.

Response

Successfully retrieved meeting invite

idstring uuid required

Unique identifier for the meeting invite.

provider'google_meet' | 'zoom' | 'microsoft_teams' required

Meeting provider inferred from the meeting URL.

meetingUrlstring uri required

Normalized meeting URL.

displayNamestring required

Display name used in the meeting.

status'pending' | 'active' | 'cancelled' | 'ended' | 'failed' required

Current invite status.

createdAtstring date-time required

Time the invite was created.

joinAtstring date-time nullable required

Scheduled time the persona joins the meeting, or null when the persona was asked to join immediately.

groupCallboolean required

Whether group-call turn-taking is enabled for this invite (respond only when addressed by name; silent join).

sessionIdstring nullable required

Engine session ID once the meeting session has started, otherwise null.

region'eu' | 'us-east' | 'us-west' | 'null' nullable required

Region the persona joined the call from. May differ from the requested region when the invite was served by another region for availability. Additional region values may be introduced over time; treat unrecognized values as informational rather than an error.

joinState'joining' | 'waiting_room' | 'in_call' | 'media_denied' | 'media_granted' | 'media_active' | 'left' | 'done' | 'error' | 'null' nullable required

Latest observed call-participation detail for the persona, updated asynchronously as the persona connects, waits for admission, joins, and leaves. Null until the first update arrives. Values may be added over time; treat unrecognized values as informational.

statusReasonstring nullable required

Reason attached to a terminal participation state — for example removed_by_host, meeting_ended, not_admitted, join_denied, meeting_link_invalid, meeting_not_started, idle_timeout, left_call, or provider_error. Null while the invite is in progress. Values may be added over time; treat unrecognized values as informational.