Skip to main content
POST
/
api
/
ai
/
rtProxy
/
rtSession
Create realtime AI session
curl --request POST \
  --url https://pria.praxislxp.com/api/ai/rtProxy/rtSession \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "token": "<string>",
  "requestArgs": {
    "assistantId": "<string>",
    "selectedCourse": {},
    "userISODate": "2023-11-07T05:31:56Z",
    "userTimezone": "<string>",
    "socketId": "<string>"
  }
}
'
{
  "provider": "<string>",
  "sessionId": "<string>",
  "ephemeralKey": "<string>",
  "model": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.praxis-ai.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-access-token
string
header
required

JWT token passed in x-access-token header

Body

application/json

Provider, model, and voice are NOT accepted from the request — they are resolved server-side from the user's institution.rtModel setting. The client only needs to send requestArgs carrying the realtime context (assistant, course, user clock) so the server can build the right system prompt. An optional top-level token is accepted as an alternative to the Authorization / x-access-token headers for browser clients that cannot set custom headers.

​
token
string

Optional auth JWT — alternative to Authorization / x-access-token headers.

​
requestArgs
object

Realtime context bag merged into the user object before context build.

Response

Realtime session created successfully

OpenAI/Gemini/xAI realtime session response

​
provider
string
​
sessionId
string

Realtime session identifier

​
ephemeralKey
string

Ephemeral key for WebRTC connection

​
model
string

AI model being used