Get a character

GET

/v1/characters/:slug

GET

/v1/characters/:slug

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

{
  "schema_version": "string",
  "data": {
    "character_id": "string",
    "app_id": "string",
    "slug": "string",
    "display_name": "string",
    "locale": "string",
    "primary_reply_language": "string",
    "supported_input_languages": [
      "string"
    ],
    "input_language_policy": "enforce_supported_input",
    "default_locale": "string",
    "available_locales": [
      "string"
    ],
    "status": "draft",
    "current_version_id": "string",
    "authoring_readiness_status": "ready",
    "authoring_quality_score": 1,
    "publication": {
      "readiness_kind": "string",
      "semantic_quality_evaluated": false,
      "state": "draft",
      "character_status": "string",
      "readiness_status": "string",
      "runtime_available": true,
      "authoring_quality_ready": true,
      "launch_ready": true
    },
    "created_at": "2024-01-15T09:30:00Z",
    "archived_at": "2024-01-15T09:30:00Z",
    "deleted_at": "2024-01-15T09:30:00Z",
    "requested_slug": "string",
    "canonical_slug": "string",
    "resolved_via_alias": true,
    "alias_kind": "string",
    "content": {
      "fixture_id": "string",
      "display_name": "string",
      "fixture_version": 1,
      "locale": "ko-KR",
      "default_locale": "string",
      "primary_reply_language": "en-US",
      "supported_input_languages": [
        "string"
      ],
      "input_language_policy": "enforce_supported_input",
      "is_synthetic": true,
      "sandbox_required": true,
      "profile": {},
      "onboarding": [
        {}
      ],
      "voice_samples": [
        {}
      ],
      "example_dialogues": [
        {}
      ],
      "inherits_style_anchors": [
        "string"
      ],
      "shared_style_anchors": [
        {}
      ],
      "behavioral_thresholds": {
        "emotional_response_mode": "measured",
        "emotional_mirror_intensity": 0.5,
        "sanitization_tolerance": 0.3,
        "snap_back_threshold": 0.6,
        "withdrawal_phrasing_style": "soft",
        "proactivity_tolerance": 0.25,
        "warm_followup_enabled": false,
        "session_resume_enabled": true,
        "cold_initiate_enabled": false,
        "warm_followup_min_idle_seconds": 15,
        "warm_followup_max_window_seconds": 90,
        "session_resume_min_idle_minutes": 30,
        "session_resume_max_unanswered_character_turns": 5,
        "cold_initiate_min_idle_minutes": 15,
        "min_gap_between_initiate_minutes": 20,
        "daily_initiate_cap": 3,
        "image_proactivity": 0,
        "daily_image_cap": 0,
        "selfie_comfort": 0,
        "withhold_propensity": 0.4,
        "emit_delay_when_low_affection": true,
        "exit_boundary_violation_count": 3,
        "re_engage_openness": 0.5
      },
      "forbidden_style": [
        {}
      ],
      "handoff_triggers": [
        {}
      ],
      "raw_sources": [
        {}
      ],
      "localizations": {},
      "world_model_seed": [
        {}
      ],
      "greeting": {},
      "character_direction": {},
      "life_template": {},
      "story_engine": {},
      "arc_seeds": [
        {}
      ],
      "relationship_seed": {},
      "emotion_baseline": {}
    },
    "authoring_readiness": {
      "status": "ready",
      "authoring_quality_score": 1,
      "missing_high_impact_fields": [
        "string"
      ],
      "warnings": [
        {}
      ],
      "next_authoring_actions": [
        "string"
      ],
      "readiness_kind": "authoring",
      "semantic_quality_evaluated": false
    }
  },
  "next_actions": [
    {
      "command": "string",
      "description": "string"
    }
  ]
}

Fetch one of the caller app’s characters (404 if not owned — timing-safe).

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