WoodWing Assets 6 icon

WoodWing Assets 6

Interact with WoodWing Assets Server 6 API

Asset → Update

AI-generated

Summary

Update an existing asset on the WoodWing Assets Server by specifying its Asset ID. Optionally upload and replace the asset's file with new binary data. Customize metadata properties, control checkout state, and specify which metadata fields to return in the response.

Inputs

  • Authentication Method (required) — Choose to log in automatically before the update or use a previously obtained authentication token.
  • Auth Token (required) — The authentication token from a previous login; required if 'Use Token From Previous Login' is selected.
  • Asset ID (required) — The WoodWing Assets Server ID of the asset to update.
  • Update File — Enable to upload a new file to replace the existing asset file.
  • Binary Property Name (required) — Name of the binary property containing the file to upload; required if updating the file.
  • Advanced Options — Additional settings such as clearing checkout state, keeping existing metadata, providing metadata JSON to update, specifying metadata fields to return, redirect URL after update, and parsing behavior for metadata modifications.

Output shape

a single JSON response object representing the updated asset, optionally including binary data if pass-through is enabled and a new file was uploaded

The output includes the updated asset data with requested metadata fields. Binary data from the input can be passed through to the output if enabled. The operation supports detailed error reporting and will fail if the update is unsuccessful, unless 'Continue On Fail' is enabled in the node settings.

Examples

Example 1: Update asset metadata without changing the file

Set Authentication Method to 'Login and Update' or provide an Auth Token. Provide the Asset ID and set 'Update File' to false. In Advanced Options, supply metadata JSON to modify fields like description or keywords.

Example 2: Replace asset file and update metadata

Provide Authentication details, Asset ID, enable 'Update File', and specify the binary property name that holds the new file binary data. Include optional metadata updates in Advanced Options. Optionally set flags like 'Clear Checkout State' or 'Keep Metadata'.

Discussion