Skip to main content
POST
Talk to a character (one turn)

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.

Path Parameters

id
string<uuid>
required

Body

application/json
text
string
required

What the player just said.

token
string

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

currentStance
string
history
object[]
affect
object | null
memory
string

Response

The character's turn

One character turn.

reply
string

What the character says aloud.

stance
string

The stance id it moved to.

emotion
string
affect
object

Running mood + rapport {v,a,d,rapport}.

action
object | null

An optional thing it DOES this turn (show_image | fetch_object | change_location).

mock
boolean

Present and true only for a TEST-mode session token, a canned reply, no LLM call. See Testing.