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).
IpsUser
IpsAdmin
IpsCompanyAdmin
ImagePortalAdmin
ImagePortalContrib
ImagePortalContribUser
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. |
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/2023-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/2023-01-15">
<successCount>2</successCount>
<warningCount>0</warningCount>
<errorCount>0</errorCount>
</emptyAssetsFromTrashReturn>