assets

Upload a new asset

Uploads a new asset (binary content plus metadata) and registers it in the asset database.

post/api/assets

Response

Asset created

idstring uuid required

Unique identifier for the asset

namestring required

Name of the asset file

asset_hashstring

Blake3 hash of the asset content

sizeinteger required

Size of the asset in bytes

mime_typestring

MIME type of the asset

tagsstring[]

Tags associated with the asset

user_metadataobject

Custom user metadata

metadataobject

System-managed metadata (read-only)

preview_urlstring uri

URL for asset preview/thumbnail

preview_idstring uuid

ID of the preview asset if available

prompt_idstring uuid

ID of the prompt that created this asset

created_atstring date-time required

updated_atstring date-time required

last_access_timestring date-time

is_immutableboolean

Whether this asset is immutable

created_newboolean required

Whether this was a new creation (true) or returned existing (false)