Integrate like Teams

Other applications should talk to this API from their backend, then send users a join URL or embed the room. Do not put the API secret in a browser app.

1. Create a meeting

curl -sS -X POST https://meet.beelivekit.me/api/v1/meetings \
  -H "X-API-Key: $LIVEKIT_API_KEY" \
  -H "X-API-Secret: $LIVEKIT_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"title":"Weekly standup"}'

Response includes join_url and embed_url. Open the join URL in a new window, or iframe the embed URL.

2. Mint a token for a known user

curl -sS -X POST https://meet.beelivekit.me/api/v1/meetings/ROOM_ID/token \
  -H "X-API-Key: $LIVEKIT_API_KEY" \
  -H "X-API-Secret: $LIVEKIT_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"identity":"user-42","name":"Ada","host":true}'

Attach the token if you already authenticated the user in your app:

https://meet.beelivekit.me/r/ROOM_ID?token=...

3. Embed in another product

<iframe
  src="https://meet.beelivekit.me/embed/ROOM_ID"
  allow="camera; microphone; display-capture; fullscreen"
  style="width:100%;height:100%;border:0"
></iframe>

5. Voice call, video call, and meeting invite

Same three actions as Teams. Calls ring the other user. Meeting invites are a link you send; anyone with it can join.

# Voice
curl -sS -X POST https://meet.beelivekit.me/api/v1/calls \
  -H "X-API-Key: $LIVEKIT_API_KEY" -H "X-API-Secret: $LIVEKIT_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"caller_identity":"ada","callee_identity":"bob","media":"audio"}'

# Video
curl -sS -X POST https://meet.beelivekit.me/api/v1/calls \
  -H "X-API-Key: $LIVEKIT_API_KEY" -H "X-API-Secret: $LIVEKIT_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"caller_identity":"ada","callee_identity":"bob","media":"video"}'

# Meeting invite
curl -sS -X POST https://meet.beelivekit.me/api/v1/meetings \
  -H "X-API-Key: $LIVEKIT_API_KEY" -H "X-API-Secret: $LIVEKIT_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"title":"Design review"}'

Calls return caller_url / callee_url. Meetings return invite_url, join_url, and invite_text to paste into email or chat.