Xentree Live
Core capabilities
Authentication and scopes
live:read for quota and transcript readslive:write for session start/end/heartbeat and nickname updatesREST endpoints
Quota and profile
/api/live/quota/api/live/nicknameSession lifecycle
/api/live/session/start/api/live/session/heartbeat/api/live/session/endTranscript storage
/api/live/transcripts/api/live/transcripts/api/live/transcripts/{transcript_id}POST /api/live/transcripts is intended for bearer (and internal service-key flow). For general server-to-server access, prefer documented hybrid endpoints first.Realtime architecture
wss://orchstr.xentree.comstart-sessionend-sessionaudio-inputaudio-responsesession-startedsession-endedavatar-expressionSecure integration token lifecycle
POST /api/integration/grant).1.
POST /api/integration/grant with short TTL (for example 90-120 seconds).2.
integration_token in embed bootstrapping.3.
POST /api/integration/verify in backend middleware/gateway.4.
POST /api/integration/rotate to issue a new token and revoke old token in one call.5.
POST /api/integration/revoke for immediate emergency invalidation.jti in database for immediate invalidation.GET /api/integration/jwks and GET /api/integration/fingerprint (query param: tenantId).Example start request
{
"session_type": "voice"
}Example transcript payload
{
"session_started_at": "2026-04-16T10:00:00Z",
"session_ended_at": "2026-04-16T10:05:00Z",
"transcripts": [
{
"role": "user",
"text": "Hello Xentree",
"timestamp": "2026-04-16T10:00:03Z"
},
{
"role": "ai",
"text": "Hi, how can I help you today?",
"timestamp": "2026-04-16T10:00:05Z"
}
]
}Quota behavior
Modified at 2026-04-29 23:54:20