API

Everything the web app does is done through this API. Rooms, transcripts, live streams and agents are all yours to drive from a script or an agent.

Authentication

Send a blah.dev OAuth access token, or a meet API key beginning mk_, as Authorization: Bearer. A key acts as the user who created it and can never hold more scopes than they do.

Listen to a call live

Connect a WebSocket to receive transcript lines as they are recognised, plus joins, leaves and chat. This is the intended way to point an agent at a room.

wss://meet.blah.dev/api/v1/sessions/{id}/live?token=…

Quick start

bash

# Create a room and get the link to hand out
curl -X POST https://meet.blah.dev/api/v1/rooms \
  -H "Authorization: Bearer $MEET_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"name":"Thursday ideas call"}'

# After the call: read the transcript as Markdown
curl "https://meet.blah.dev/api/v1/sessions/$SESSION_ID/transcript?format=markdown" \
  -H "Authorization: Bearer $MEET_TOKEN"