file

Update asset metadata

Updates an asset's metadata. At least one field must be provided. Only name, mime_type, preview_id, and user_metadata can be updated. For tag management, use the dedicated PUT /api/assets/{id}/tags endpoint.

put/api/assets/{id}

Path parameters

idstring uuid required

Asset ID

Request body

mime_typestring

Updated MIME type of the asset

namestring

New display name for the asset

preview_idstring uuid

Updated preview asset ID

user_metadataobject

Updated custom metadata

Response

Asset updated successfully

asset_hashstring

Deprecated: use hash instead. Blake3 hash of the asset content.

display_namestring nullable

Display name of the asset. Mirrors name for backwards compatibility.

hashstring

Blake3 hash of the asset content. Preferred over asset_hash.

idstring uuid required

Asset ID

job_idstring uuid nullable

ID of the job that created this asset, if available

mime_typestring

Updated MIME type of the asset

namestring

Updated name of the asset

tagsstring[]

Tags associated with the asset

updated_atstring date-time required

Timestamp of the update