Update File

PATCH/v1/files/:blobId

Update the metadata (name, tag, custom fields) of an existing file. The underlying blob data on Walrus cannot be modified — only the metadata index is updated.

Request Body

FieldTypeDescription
namestringNew display name for the file
tagstringUpdated tag for filtering
metadataobjectArbitrary key-value metadata pairs

Example Request

curl -X PATCH https://api.tuskr.dev/v1/files/abc123 \
  -H "Authorization: Bearer tsk_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{ "name": "profile-pic.png", "tag": "profile" }'

See Also