Create Session Event
Session Lifecycle
Create Session Event
Record a session lifecycle event.
Event Types
| Event | Description | When to Use |
|---|---|---|
SESSION_START | Session has started | After WebRTC connection is established |
SESSION_DURING | Session heartbeat | Periodically during active session |
SESSION_END | Session ended normally | When user ends the session |
SESSION_ERROR | Session ended with error | When an error occurs |
SESSION_LOG | Custom log entry | For debugging/analytics |
Example
Select “CreateSessionEventRequest” from the Examples dropdown to see the request format.
POST
Create Session Event
Path Parameters
Body
Event type — see SessionEventType enum (e.g. SESSION_END, SESSION_ERROR).
SESSION_START- Session StartSESSION_DURING- Session DuringSESSION_LOG- Session LogSESSION_END- Session EndSESSION_ERROR- Session ErrorSESSION_TTS- Session TTSSESSION_STT- Session STTSESSION_LLM- Session LLMSESSION_DASHBOARD- Session DashboardSESSION_WS_LOG- Session WS LogSESSION_WS_ERROR- Session WS Error
Available options:
SESSION_START, SESSION_DURING, SESSION_LOG, SESSION_END, SESSION_ERROR, SESSION_TTS, SESSION_STT, SESSION_LLM, SESSION_DASHBOARD, SESSION_WS_LOG, SESSION_WS_ERROR Optional human-readable detail describing the event.
Optional binary file attached to the event (max 10 MB).
Response
SESSION_EVENT_GRACEFUL_TERMINATION- Graceful TerminationSESSION_EVENT_SESSION_EXPIRED_BEFORE_CONNECTION- Session Expired Before ConnectionSESSION_EVENT_SESSION_LOST_AFTER_CONNECTION- Session Lost After ConnectionSESSION_EVENT_MISC_ERROR- Session Misc ErrorSESSION_EVENT_MAX_ACTIVE_SESSION_QUOTA_EXCEEDED- Max Active Session Quota ExceededSESSION_EVENT_MAX_MIN_PER_SESSION_QUOTA_EXCEEDED- Max Min Per Session Quota ExceededSESSION_EVENT_TOTAL_MIN_PER_MONTH_QUOTA_EXCEEDED- Total Min Per Month Quota ExceededSESSION_EVENT_INSUFFICIENT_CREDITS- Insufficient Credits
Available options:
SESSION_EVENT_GRACEFUL_TERMINATION, SESSION_EVENT_SESSION_EXPIRED_BEFORE_CONNECTION, SESSION_EVENT_SESSION_LOST_AFTER_CONNECTION, SESSION_EVENT_MISC_ERROR, SESSION_EVENT_MAX_ACTIVE_SESSION_QUOTA_EXCEEDED, SESSION_EVENT_MAX_MIN_PER_SESSION_QUOTA_EXCEEDED, SESSION_EVENT_TOTAL_MIN_PER_MONTH_QUOTA_EXCEEDED, SESSION_EVENT_INSUFFICIENT_CREDITS Event type — see SessionEventType enum (e.g. SESSION_END, SESSION_ERROR).
SESSION_START- Session StartSESSION_DURING- Session DuringSESSION_LOG- Session LogSESSION_END- Session EndSESSION_ERROR- Session ErrorSESSION_TTS- Session TTSSESSION_STT- Session STTSESSION_LLM- Session LLMSESSION_DASHBOARD- Session DashboardSESSION_WS_LOG- Session WS LogSESSION_WS_ERROR- Session WS Error
Available options:
SESSION_START, SESSION_DURING, SESSION_LOG, SESSION_END, SESSION_ERROR, SESSION_TTS, SESSION_STT, SESSION_LLM, SESSION_DASHBOARD, SESSION_WS_LOG, SESSION_WS_ERROR Optional human-readable detail describing the event.
Optional binary file attached to the event (max 10 MB).

