Register Visual Asset Url

For apps that already host character images (Convex / Vercel Blob / S3). LoreOS fetches the URL once and stores it in object storage (so the servable URL is stable + ours); identity-first + continuity rules are identical to a multipart upload. App-scoped (404 if the slug is not the caller’s). Direct https image URLs only (SSRF-guarded).

Register an EXTERNAL image URL as a visual asset — no re-upload, no image-generation billing. For apps that already host character images (Convex / Vercel Blob / S3). LoreOS fetches the URL once and stores it in object storage (so the servable URL is stable + ours); identity-first + continuity rules are identical to a multipart upload. App-scoped (404 if the slug is not the caller's). Direct https image URLs only (SSRF-guarded).

Authentication

AuthorizationBearer

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

Path parameters

slugstringRequired

Request

This endpoint expects an object.

source_urlstringRequired1-4096 characters

asset_keystringRequired1-200 characters

categorystringRequired1-80 characters

labelstringRequired1-200 characters

visual_summarystringOptional<=2000 charactersDefaults to

provenancestring or nullOptional<=120 characters

licensestring or nullOptional<=200 characters

Response

Successful Response

Errors

422

Unprocessable Entity Error

$	curl -X POST https://api.loreos.app/v1/characters/slug/visual-assets/register-url \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"source_url": "https://cdn.exampleapp.com/characters/hero123/profile.png",
>	"asset_key": "hero123_profile_image",
>	"category": "profile-picture",
>	"label": "Hero123 Profile Image"
>	}'