Control Session Lifecycle

Pause or resume one app-owned user-character session.

pause blocks new user messages and proactive/offscreen runtime paths that require an active session. It does not delete memory or canon. resume reactivates the same session.

Authentication

AuthorizationBearer

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

Path parameters

session_idstringRequired

Request

This endpoint expects an object.

actionenumRequired

Pause blocks new user messages; resume returns the session to active.

reasonstring or nullOptional<=500 characters

Response

Successful Response

Errors

422

Unprocessable Entity Error

$	curl -X PATCH https://api.loreos.app/v1/sessions/session_id/lifecycle \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"action": "pause"
>	}'