API ReferenceSessions

Update Proactive Controls

Tune this session’s proactive behavior — when/how often the character initiates. Each field overrides the character’s behavioral_thresholds for THIS session; see the per-field descriptions for what each means. The on/off master switch stays proactive_enabled on POST /v1/sessions.

Authentication

AuthorizationBearer

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

Path parameters

session_idstringRequired

Request

This endpoint expects an object.
proactivity_tolerancedouble or nullOptional0-1

How willing the character is to initiate at all. 0 = never reach out, 1 = most eager. Master gate: at 0 no proactive message fires regardless of the rest.

cold_initiate_enabledboolean or nullOptional

Allow the character to START a fresh conversation after a long silence (a cold initiate), not just resume an existing thread.

session_resume_enabledboolean or nullOptional
Allow the character to nudge an unanswered thread back to life.
cold_initiate_min_idle_minutesinteger or nullOptional5-1440
Minimum minutes of silence before a COLD initiate may fire.
session_resume_min_idle_minutesinteger or nullOptional0-1440
Minimum minutes since the last turn before a RESUME nudge may fire.
session_resume_max_unanswered_character_turnsinteger or nullOptional0-20

Stop resuming after this many consecutive unanswered character turns (prevents nagging).

min_gap_between_initiate_minutesinteger or nullOptional0-1440

Minimum minutes between any two proactive messages (rate limit).

daily_initiate_capinteger or nullOptional0-50
Maximum proactive messages per day for this session.

Response

Successful Response

Errors

422
Unprocessable Entity Error