DocsAPI ReferenceGet SSE stream URL and auth token
POST/api/v1/bots/{bot_id}/subscribe

Returns an SSE `url` and short-lived JWT `token` for connecting to the bot's live event stream. This endpoint waits up to 30 seconds for the bot VM to register. If the bot is not yet active, retry after a few seconds. Connect using the returned `url` with `Authorization: Bearer <token>` in the request headers. The stream pushes named SSE events: `transcript_segment`, `bot_status`, `participant_update`, `action_detected`, `recording_ready`.

Path Parameters

bot_idstringrequirede.g. "550e8400-e29b-41d4-a716-446655440000"

Bot UUID.

Headers

X-API-Keystringrequired

Your workspace API key.

Responses

200Stream URL and JWT. Open `url` as an EventSource with `Authorization: Bearer <token>` header.
{
  "url": "https://stream.serveka.com/sse/550e8400-e29b-41d4-a716-446655440000",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
404Bot not found or not yet active (retry after a few seconds).