Create Session Event

post

https://platform.perso.ai/api/v1/session/{session_id}/event/create/

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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

session_id

string

required

Body Params

detail

string

file

file | null

event

string

enum

required

SESSION_START - Session Start
SESSION_DURING - Session During
SESSION_LOG - Session Log
SESSION_END - Session End
SESSION_ERROR - Session Error
SESSION_TTS - Session TTS
SESSION_STT - Session STT
SESSION_LLM - Session LLM
SESSION_DASHBOARD - Session Dashboard

Headers

content-type

string

enum

Defaults to application/json

Generated from available request content types

Allowed:

Responses

400

Bad Request - Invalid input data or parameters.

401

Unauthorized - Invalid or missing authentication credentials.

403

Forbidden - You do not have permission to perform this action.

404

Not Found - The requested resource could not be found.

405

Method Not Allowed - Invalid HTTP method

406

Not Acceptable - Invalid request accept headers

415

Unsupported Media Type - Invalid content type

500

Internal Server Error - An unexpected error occurred.

201