Zelestra

Zelestra Standards

removeItem

The removeItem operation removes one or more items from a clip list.

Request

The removeItem operation requires a message that consists of a single RemoveItemRequest element.

Examples

URL Encoded:
clipList=http://www.zelestra.com/ClipList.xml&itemclass=_257

XML:
<RemoveItemRequest>
  <ClipList>http://www.zelestra.com/ClipList.xml</ClipList>
  <ItemId>_257</ItemId>
</RemoveItemRequest>

The RemoveItemRequest element MUST contain a ClipList element, which is the URI of a clip list.

The RemoveItemRequest element MUST contain one or more ItemId elements, which are the clip list item identifiers.

The RemoveItemRequest 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.

Operation

The specified items are removed from the specified clip list.

Response

The removeItem operation does not return any data.

Faults

The removeItem operation may return an badRequest fault if any of the request parameters are invalid.

The removeItem operation may return an forbidden fault if the requestor does not have the appropriate permission.

The removeItem operation may return an notFound fault if the specified clip list or item does not exist.

The removeItem operation may return an unauthorized fault if the requestor has not previously authenticated.

The removeItem operation may return an operationFailed fault if the service was unable to otherwise fulfill the request.