Skip to main content
POST
Beta Feature: This endpoint is currently in beta. Features and specifications may change.
This endpoint requires authentication with your API key and should be called from your backend server, not directly from client applications.
string
required
The unique identifier of the assistant
string
required
Display name for the user participant
string
Optional custom room name. If not provided, a unique room name will be generated

Session Token Details

The returned token is a JWT that contains:
  • User identity and display name
  • Room access permissions
  • Expiration time (based on TTL configuration)
  • Audio/video capabilities

Connection Flow

  1. Backend: Call this endpoint with your API key
  2. Backend: Return session data to your frontend
  3. Frontend: Use the token and wsUrl to connect via SDK
  4. WebRTC: Establish peer connection for real-time audio

Security Best Practices

Never expose your API key in client-side code. Always create sessions from your backend server.
  • Validate user authentication before creating sessions
  • Implement rate limiting per user
  • Monitor session creation for abuse
  • Set appropriate TTL values for your use case