Manifests · Liforma Docs

Schema version 1

Both /v1/sessions and /v1/public-sessions return this shape. Breaking changes increment schemaVersion.

{
  "schemaVersion": 1,
  "sessionId": "sess_01…",
  "experienceId": "exp_01DEMO1SPANISHCAFE",
  "expiresAt": "2026-06-16T12:30:00Z",
  "sessionToken": "eyJ…",
  "experience": {
    "title": "Spanish Tutor Sofia",
    "slug": "spanish-tutor-sofia",
    "mode": "conversation"
  },
  "transport": { "type": "http", "config": { "apiBaseUrl": "https://api.liforma.ai" } },
  "runtime": {
    "cdnBaseUrl": "https://cdn.liforma.ai",
    "input": "browserStt",
    "renderer": "morph2d"
  },
  "characters": [{
    "characterId": "char_…",
    "displayName": "Sofia",
    "avatarId": "ava_c4e71fe5",
    "voiceId": "es-ES-ElviraNeural",
    "sttLang": "es-ES",
    "agentId": "agt_spanish_tutor"
  }],
  "activeCharacterId": "char_…"
}

Top-level fields

Field	Type	Description
`schemaVersion`	`number`	Always `1` today
`sessionId`	`string`	Unique session identifier
`experienceId`	`string`	Experience being run
`expiresAt`	`string`	ISO 8601 expiry
`sessionToken`	`string`	JWT for runtime authorisation (SDK internal)
`transport`	`object`	`type` + `config`
`runtime`	`object`	CDN URL, input mode, renderer
`characters`	`array`	Character definitions
`billing`	`object`	Meter ID and payer

Transport types

`transport.type`	Status
`http`	Available
`livekit`	Future transport option
`webrtc`	Future transport option