Sign in
assets

Create an asset reference from an existing hash

Registers a new asset that references existing content by hash, without re-uploading the bytes.

post/api/assets/from-hash

Request body

hashstring required

Blake3 hash of existing content

namestring required

Display name

tagsstring[]
user_metadataobject

Response

Asset created from hash

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)

Changes