Character Runtime Preview

GET

/v1/characters/:slug/runtime-preview

GET

/v1/characters/:slug/runtime-preview

curl https://api.loreos.app/v1/characters/slug/runtime-preview \
     -H "Authorization: Bearer <token>"

{
  "schema_version": "string",
  "data": {
    "active_version_id": "string",
    "relational_domain": {
      "domain": "string",
      "dimensions": [
        {
          "key": "string",
          "label": "string",
          "lower_is_open": true
        }
      ],
      "numeric_values_exposed": false
    },
    "persona_summary": {
      "display_name": "string",
      "locale": "string",
      "has_persona": true,
      "visible_interests": [
        "string"
      ]
    },
    "voice_style_summary": {
      "voice_sample_count": 1,
      "example_dialogue_count": 1
    },
    "forbidden_style_summary": {
      "rule_count": 1
    },
    "world_seed_summary": {
      "seeded_fact_count": 1
    },
    "identity_assets": [
      {
        "asset_id": "string",
        "category": "string",
        "label": "string"
      }
    ],
    "inventory_assets": [
      {
        "asset_id": "string",
        "category": "string",
        "label": "string"
      }
    ],
    "image_settings": {
      "image_proactivity": 1.1,
      "daily_image_cap": 1,
      "selfie_comfort": 1.1
    },
    "proactive_settings": {
      "cold_initiate_enabled": true,
      "session_resume_enabled": true,
      "daily_initiate_cap": 1
    },
    "redacted": true
  },
  "next_actions": [
    {
      "command": "string",
      "description": "string"
    }
  ]
}

“What will the engine actually use?” — redacted product-level summary of the active version: relational domain (dimension NAMES only, NO live numerics per OS-D08), persona/voice/forbidden/world-seed summaries, active assets, image + proactive settings. App-scoped; 404 if not owned.

Authentication

AuthorizationBearer

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

Path parameters

slugstringRequired

Response

Successful Response

schema_version"v0"

LoreOS success-envelope version.

dataobject

next_actionslist of objects

Concrete follow-up API actions; empty when no action is required.

Errors

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error