Show Menu
TOPICS×

setAssetMetadata

Sets metadata values for an asset. Works with an array of metadata updates to set values in a batch.
Syntax

Authorized User Types

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImagePortalContribUser
The user must have read access to the asset.

Parameters

Input (setAssetMetadataParam)
Name
Type
Required
Description
* companyHandle *
xsd:string
Yes
The handle to the company with the asset you want to update.
* assetHandle *
xsd:string
Yes
The handle to the asset.
* updateArray *
types:MetadataUpdateArray
Yes
Updates in a metadata update array.
Output (setAssetMetadataReturn)
The IPS API does not return a response for this operation.

Examples

This code sample uses an array of metadata updates to set the metadata of the specified asset.
Request
<ns1:setAssetMetadataParam xmlns:ns1="http://www.scene7.com/IpsApi/xsd">
   <ns1:companyHandle>47</ns1:companyHandle>
   <ns1:assetHandle>24265|1|17061</ns1:assetHandle>
   <ns1:updateArray>
      <ns1:items>
         <ns1:fieldHandle>47|ALL|Resolution</ns1:fieldHandle>
         <ns1:value>320</ns1:value>
      </ns1:items>
   </ns1:updateArray>
</ns1:setAssetMetadataParam>

Response
None.