Upsert External User

PUT

/v1/external-users/:external_user_ref

Create/update a managed end-user record (Tier 1). BYO auth — we never log the end-user in, only hold their Character-OS profile/state/usage.

AuthorizationBearer

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

external_user_refstringRequired

This endpoint expects an object.

display_namestring or nullOptional<=200 characters

metadatamap from strings to anyOptional

Successful Response

422

Unprocessable Entity Error

$	curl -X PUT https://api.loreos.app/v1/external-users/external_user_ref \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'