The clear operation removes all items from a clip list.
The clear operation requires a message that consists of a single ClearRequest element.
Examples
URL Encoded:
clipList=http://www.zelestra.com/ClipList.xml
XML:
<ClearRequest>
<ClipList>http://www.zelestra.com/ClipList.xml</ClipList>
</ClearRequest>
The ClearRequest element MUST contain a ClipList element, which is the URI of a clip list.
The ClearRequest element MAY contain an OnResource element, which may be set to true or false. A true value indicates that the operation is to be performed on the resource. Otherwise, the operation is performed on the instance. If no element is specified, then false is assumed.
All items are removed from the specified clip list.
The clear operation does not return any data.
The clear operation may return an badRequest fault if the request parameter is invalid.
The clear operation may return an forbidden fault if the requestor does not have the appropriate permission.
The clear operation may return an notFound fault if the specified clip list does not exist.
The clear operation may return an unauthorized fault if the requestor has not previously authenticated.
The clear operation may return an operationFailed fault if the service was unable to otherwise fulfill the request.