Update Proactive Controls

PATCH

/v1/sessions/:session_id/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.

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

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