Sign in

v36

latestOpenAPI 3.0.3GNU General Public License v3.0raw.githubusercontent.com2026-08-017758212.6 KB
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 POST (add) and DELETE (remove) /api/assets/{id}/tags.

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

display_namestring nullable

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

file_pathstring nullable

Relative path in global-namespace-root form (e.g. "models/checkpoints/flux.safetensors")

hashstring

Blake3 hash of the asset content.

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

user_metadataobject

Updated custom metadata