---
title: "Update asset metadata"
method: PUT
path: "/api/assets/{id}"
tags: ["asset"]
---

# Update asset metadata

`PUT /api/assets/{id}`

Updates an asset's metadata. At least one field must be provided.
Only name, tags, and user_metadata can be updated.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `name` string — New display name for the asset
  - `tags` string[] — Updated tags for the asset
  - `mime_type` string — Updated MIME type of the asset
  - `preview_id` string, uuid — Updated preview asset ID
  - `user_metadata` object — Updated custom metadata

## Response `200`

Asset updated successfully

- AssetUpdated
  - `id` string, uuid, required — Asset ID
  - `name` string — Updated name of the asset
  - `asset_hash` string — Blake3 hash of the asset content
  - `tags` string[] — Updated tags for the asset
  - `mime_type` string — Updated MIME type of the asset
  - `user_metadata` object — Updated custom metadata
  - `updated_at` string, date-time, required — Timestamp of the update

## Other responses

- `400` — Invalid request (no fields provided)
- `401` — Unauthorized
- `404` — Asset not found
- `500` — Internal server error

---

[API](https://skmtc.net/ac/apis/comfy-api.md) · [All operations](https://skmtc.net/ac/apis/comfy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ac/comfy-api/versions/c1893dffe250/schema)