Subscribe to real-time session status changes using Server-Sent Events (SSE).
Opens a persistent SSE connection that delivers session status updates, participant join/leave events, and error notifications in real time. The response uses the text/event-stream content type and keeps the connection open until the session ends or the client disconnects.
The server sends a keepalive comment (: keepalive) every 15 seconds to prevent proxy timeouts. When the session reaches a terminal state (completed or failed), a close event is sent and the stream ends.
session_id string required
The session identifier. Must start with mbsess_.
status — Session status change
Sent when the session transitions to a new status (e.g., joining, active, completed, failed). Also sent for participant join/leave events.
| Field | Type | Description |
|---|---|---|
session_id | string | Session identifier |
status | string | New session status |
previous_status | string or null | Previous status |
timestamp | string | ISO 8601 timestamp |
error_message | string or null | Error description (if failed) |
error_code | string or null | Error code (if failed) |
participant_name | string | Participant name (for join/leave events only) |
event | string | "joined" or "left" (for join/leave events only) |
close — Stream termination
Sent when the session reaches a terminal state. The stream closes after this event.
| Field | Type | Description |
|---|---|---|
reason | string | Always "session_ended" |
A text/event-stream response. Each event is formatted as:
event: <event_type>
data: <json_payload>
A keepalive comment is sent every 15 seconds:
: keepalive
- Bash
- Python
- Python
- JavaScript
curl -N -H "Authorization: Bearer $ACCESS_TOKEN" \
"https://api.aitronos.com/v1/meeting-buddy/sessions/mbsess_abc123def456/stream"