Send a message

Deliver an end-user message; the character’s reply arrives async on the event log. Returns immediately with the user-message cursor — poll GET .../events?since=<cursor> for the reply (delayed-exposure UX).

Send Idempotency-Key: <unique-per-message> to make retries safe (common on serverless/Vercel): a same-key re-call returns the original cursor + turn index (idempotent_replay: true) instead of creating a duplicate turn/reply.

Deliver an end-user message; the character's reply arrives async on the event log. Returns immediately with the user-message cursor — poll ``GET .../events?since=<cursor>`` for the reply (delayed-exposure UX). Send ``Idempotency-Key: <unique-per-message>`` to make retries safe (common on serverless/Vercel): a same-key re-call returns the original cursor + turn index (``idempotent_replay: true``) instead of creating a duplicate turn/reply.

Authentication

AuthorizationBearer

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

Path parameters

session_idstringRequired

Headers

Idempotency-Keystring or nullOptional

Request

This endpoint expects an object.

textstringRequired1-4000 characters

reply_modeenum or nullOptional

context_eventslist of objects or nullOptional

Response

Successful Response

Errors

422

Unprocessable Entity Error

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