API ReferenceCharacters

Create a character

Create (or re-publish) a character owned by the caller’s app.

JSON-native authoring → the Gate-0 characters/character_versions entity. Idempotent on content: re-sending identical content reuses the version. A slug already owned by a DIFFERENT app is rejected 409.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.
slugstringRequired1-128 characters
display_namestringRequired1-120 characters
localestringOptional2-16 charactersDefaults to ko-KR
profileobjectOptional

Visible profile facts and style anchors.

extra="allow" preserves forward compatibility, but readiness warns on unknown keys so typos do not silently become invisible runtime state.

voice_sampleslist of objectsOptional
greetingobject or nullOptional

Authored first character message emitted as-is on session start.

onboardinglist of objectsOptional
character_directionobject or nullOptional
life_templateobject or nullOptional
story_engineobject or nullOptional
arc_seedslist of objectsOptional
relationship_seedobject or nullOptional
emotion_baselineobject or nullOptional
forbidden_stylelist of maps from strings to anyOptional
handoff_triggerslist of maps from strings to anyOptional
world_model_seedlist of objectsOptional
inherits_style_anchorslist of stringsOptional
raw_sourceslist of objectsOptional
behavioral_thresholdsobject or nullOptional
affordance_schemastring or map from strings to any or nullOptional

Response

Successful Response

Errors

422
Unprocessable Entity Error