Show Menu
TOPICS×

emptyAssetsFromTrash

Empties assets from the IPS trash.
Assets live in the trash until they are manually emptied or until they time out of the trash. If they are manually emptied, they live in the Trash until the next cleanup job (normally nightly) when they are finally purged from the system. If they time out of the trash, assets are cleaned off as part of that same cleanup activity. The time out is configurable (defaults is 7 days).

Authorized User Types

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImagePortalContribUser
  • ``

Parameters

Input (emptyAssetsFromTrashParam)
Name
Type
Required
Description
* companyHandle *
xsd:string
Yes
The handle to the company that owns the assets.
* assetHandleArray *
types:HandleArray
Yes
The array of handles that represent the items to be emptied from the trash.
Output (emptyAssetsFromTrashParam)
Name
Type
Required
Description
* successCount *
xsd:Int
Yes
The number of assets successfully emptied from the trash.
* warningCount *
xsd:Int
Yes
The number of warnings generated when the operation attempted to empty assets from the trash.
* errorCount *
xsd:Int
Yes
The number of errors generated when the operation attempted to empty assets from the trash.
* warningDetailArray *
types:AssetOperationFaultArray
No
The array of details associated with the assets that generated warnings when the operation attempted to empty them from the trash.
* errorDetailArray *
types:AssetOperationFaultArray
No
The array of details associated with the assets that generated errors when the operation attempted to empty them from the trash.

Examples

This code sample uses the company’s handle and an asset handle array that contains handles to the assets to be emptied from the trash.
Request
<emptyAssetsFromTrashParam xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <companyHandle>c|6</companyHandle>
   <assetHandleArray>
      <items>a|942|1|579</items>
      <items>a|943|1|580</items>
   </assetHandleArray>
</emptyAssetsFromTrashParam>

Response
<emptyAssetsFromTrashReturn xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <successCount>2</successCount>
   <warningCount>0</warningCount>
   <errorCount>0</errorCount>
</emptyAssetsFromTrashReturn>