Skip to main content
POST
Exchange a session token for a runtime connect token

Authorizations

Authorization
string
header
required

The scoped runtime session JWT from POST /v1/sessions/token. The embed's browser presents it (Authorization: Bearer, or a token body field) to the runtime exchange routes. Not an API key.

Body

application/json
token
string

The session JWT (or send it as Authorization: Bearer).

Response

A runtime connect token + the world.

worldId
string<uuid>

The resource id (for a character, the /v1/characters/{id} to talk to).

reactorJwt
string
expiresIn
integer
expiresAt
integer | null
world
object

The SMWorld to play. For a character, world.kind=='character' and world.character carries the render-safe brain (stances/voice/greeting/intro). Never the persona/lore.

mock
boolean

Present and true only for TEST-mode session tokens: a fake runtime token, no real Reactor connection. See Testing.