Product Documentation articleDelete versions for document: lq851
Added by IBM contributorYing BJ Mo | Edited by IBM contributorJames A Riel on April 15, 2011 | Version 2
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

No abstract provided.
Tags: API

Overview



This is the specification for applications that delete Version resources from a Document.

URL endpoints



Perform a DELETE operation on one of the following URL formats:
URL
Description
/library/{library-id}/document/{document-id}/feed
Delete versions.

Authentication



This method requires authentication. The authenticated user must have 'Delete' authority on the specified resource.

Arguments



The following HTTP headers may be supported for this operation.
Header
Description
X-Method-Override
Tunnel a 'DELETE' request over HTTP POST.

The following URL arguments are supported on this operation. The default value for any argument is marked as bold in the table below.
Argument
Values
Description
category
String { version }
Resource being delete, required argument for feed url.
delete
int
Required for versions. This is the version number to start deleting from. All version numbers less than or equal to this version number are deleted.


Error Codes



The following error codes could appear in a response body for an invalid request:
Error Code
Description
Unknown
Returned when the cause of an error is unknown
AccessDenied
Returned when the cause of an error is due to a permission restriction
ItemNotFound
Returned when the cause of an error is related to a resource not being found

Example Request for Lotus Quickr 8.5 for Domino



POST /dm/atom/library/_Ptest002_RMain.nsf/document/_Ptest002_RMain.nsf_D46DD905A03108B0F48257853002BDB79/feed?category=version&deleteFrom=4 HTTP/1.1
Host: example.com
Content-Type: application/atom+xml
X-Method-Override: DELETE

<?xml version="1.0" encoding="utf-8"?>
<a:entry xmlns:a="http://www.w3.org/2005/Atom">
</a:entry>


Example Response for Lotus Quickr 8.5 for Domino



200 OK

<?xml version="1.0" encoding="utf-8"?>
<feed xml:base="http://example.com/" xmlns="http://www.w3.org/2005/Atom" xmlns:td="urn:ibm.com/td">
</feed>