Start a session

Start a session between one of the caller app’s characters and an end-user.

Keyed by (tenant, app, external_user_ref) — the end-user is BYO auth (an opaque ref the developer controls), never an operator identity.

AuthorizationBearer

LoreOS API key, sent as Authorization: Bearer <key>.

This endpoint expects an object.

characterstringRequired1-128 characters

character slug

external_user_refstringRequired1-200 characters

external_user_display_namestring or nullOptional<=120 characters

proactive_enabledboolean or nullOptional

Successful Response

422

Unprocessable Entity Error

$	curl -X POST https://api.loreos.app/v1/sessions \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"character": "string",
>	"external_user_ref": "string"
>	}'