Character Readiness

GET

/v1/characters/:slug/readiness

GET

/v1/characters/:slug/readiness

curl https://api.loreos.app/v1/characters/mira-demo/readiness \
     -H "Authorization: Bearer <token>"

{
  "schema_version": "v0",
  "data": {
    "readiness_kind": "launch",
    "semantic_quality_evaluated": false,
    "status": "needs_attention",
    "launch_readiness_score": 0.62,
    "checks": [
      {
        "id": "schema_validity",
        "status": "ok",
        "summary": "Active published version present."
      },
      {
        "id": "identity_asset",
        "status": "missing",
        "summary": "No active identity image.",
        "fix": "Upload an identity image with POST /v1/characters/{slug}/visual-assets."
      }
    ]
  },
  "next_actions": [
    {
      "command": "POST /v1/characters/{slug}/visual-assets",
      "description": "Address the next missing readiness item"
    },
    {
      "command": "GET /v1/characters/{slug}/runtime-preview",
      "description": "See exactly what the engine will use"
    }
  ]
}

“Is this character ready to test/launch?” — deterministic per-check readiness + aggregate score (persona/voice/affordance domain/identity/inventory/image/proactive/ budget/delivery). 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

422

Unprocessable Entity Error