Upload Visual Asset

Upload a visual asset (identity / wardrobe / accessory / …) for a character.

Upload an identity asset FIRST — it anchors every generated selfie and is activated immediately. Other categories are rejected (409) until an active identity exists. Stored in object storage; the response carries the servable URL. App-scoped (404 if the slug is not owned by the caller’s app).

Authentication

AuthorizationBearer

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

Path parameters

slugstringRequired

Request

This endpoint expects a multipart form containing a file.

filefileRequired

asset_keystringRequired

categorystringRequired

labelstringRequired

visual_summarystringOptionalDefaults to

visual_descriptionstringOptionalDefaults to

Response

Successful Response

Errors

422

Unprocessable Entity Error

$	curl -X POST https://api.loreos.app/v1/characters/slug/visual-assets \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: multipart/form-data" \
>	-F file=@string \
>	-F asset_key="string" \
>	-F category="string" \
>	-F label="string"