Skip to navigation
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. proactive_enabled is accepted here for existing sessions and remains accepted on POST /v1/sessions at creation time. These controls narrow or tune one session; they do not bypass the enforced app-wide proactive policy, quiet hours, daily cap, allowed reasons, channel policy, or cost cap exposed by GET/PATCH /v1/apps/{app_id}/proactive-policy.

Authentication

AuthorizationBearer

LoreOS runtime API key (ck_...), sent as Authorization: Bearer <key>.

Path parameters

session_idstringRequired

Request

This endpoint expects an object.
proactive_enabledboolean or nullOptional

Enable or disable proactive initiation for this existing session. true enables scheduled initiation and live send; false disables both. Send null to clear the session-level master override and fall back to the character/app defaults.

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