Activate Character Features

POST

/v1/characters/:slug/activate-features

Opt a character into its per-character background features (offscreen-life heartbeat/ scene, story-room, ambient-life). Proactive does NOT need this — it is on by default and globally swept (runtime-controls audit §12 item 6, policy A). These features are opt-in, and EACH is a recurring paid LLM Temporal workflow under a standardized {feature}-{slug} schedule. Idempotent: re-activating an already-active feature is a no-op (reported under already_active). App-scoped — 404 if the slug is not owned by the caller’s app. This replaces the ad-hoc manual scripts/character_*_schedule.py runs.

Opt a character into its per-character background features (offscreen-life heartbeat/ scene, story-room, ambient-life). Proactive does NOT need this — it is on by default and globally swept (runtime-controls audit §12 item 6, policy A). These features are opt-in, and EACH is a recurring **paid** LLM Temporal workflow under a standardized ``{feature}-{slug}`` schedule. Idempotent: re-activating an already-active feature is a no-op (reported under ``already_active``). App-scoped — 404 if the slug is not owned by the caller's app. This replaces the ad-hoc manual ``scripts/character_*_schedule.py`` runs.

Authentication

AuthorizationBearer

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

Path parameters

slugstringRequired

Request

This endpoint expects an object.

featureslist of enumsRequired

Per-character background features to activate: offscreen_heartbeat, offscreen_scene, story_room, ambient_life. Each is a recurring PAID LLM workflow.

pausedbooleanOptionalDefaults to false

Response

Successful Response

Errors

422

Unprocessable Entity Error

$	curl -X POST https://api.loreos.app/v1/characters/slug/activate-features \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"features": [
>	"offscreen_heartbeat"
>	]
>	}'