Product Documentation articleCreate a version: 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 create Version resources.

URL endpoints



POST a Version Atom entry to one of the following URL formats:
URL
Description
/library/{library-id}/document/{document-id}/feed
Create a version.

Authentication / Permission



This operation requires authentication. In order to create a version of a document, the currently authenticated user must be able to edit the document.

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
UnsupportedOperation
Returned when the operation is not supported

Example Request for Lotus Quickr 8.5 for Domino



POST /dm/atom/library/_Pplace3_RMain/document/_Pplace3_RMain_DA4269C9E8CAF281A852577970055E07C/feed HTTP/1.1
Content-Type: application/atom+xml

<entry xmlns="http://www.w3.org/2005/Atom">
<category term="version" label="version" scheme="tag:ibm.com,2006:td/type"/>
<summary type="text">something changed</summary>
</entry>


Example Response for Lotus Quickr 8.5 for Domino



<?xml version="1.0" encoding="utf-8" ?>
<entry xml:base="http://example.com/" xmlns="http://www.w3.org/2005/Atom" xmlns:td="urn:ibm.com/td">
<id>urn:lsid:ibm.com:td:_Ptest002_RMain_D22AFF26436DA1777482578610024ADBD_ABlue_20hills.jpg_V5</id>
<td:uuid>_Ptest002_RMain_D22AFF26436DA1777482578610024ADBD_ABlue_20hills.jpg</td:uuid>
<link href="http://example.com/dm/atom/library/_Ptest002_RMain/folder/_Ptest002_RMain" rel="parent" />
<td:label>Blue hills</td:label>
<link href="dm/atom/library/_Ptest002_RMain/document/_Ptest002_RMain_D46DD905A03108B0F48257853002BDB79_ABlue_20hills.jpg/version/5/entry" rel="self" />
<link href="LotusQuickr/test002/Main.nsf/h_Index/46DD905A03108B0F48257853002BDB79?OpenDocument" rel="alternate" />
<link href="dm/atom/library/_Ptest002_RMain/document/_Ptest002_RMain_D46DD905A03108B0F48257853002BDB79_ABlue_20hills.jpg/version/5/entry" rel="edit" />
<link href="dm/atom/library/_Ptest002_RMain/document/_Ptest002_RMain_D46DD905A03108B0F48257853002BDB79_ABlue_20hills.jpg/version/5/media" rel="edit-media" />
<link href="dm/atom/library/_Ptest002_RMain/document/_Ptest002_RMain_D46DD905A03108B0F48257853002BDB79_ABlue_20hills.jpg/version/5/media" type="application/unknown" title="Blue hills" hreflang="en" length="28521" rel="enclosure"/>
<link href="dm/atom/library/_Ptest002_RMain/document/_Ptest002_RMain_D46DD905A03108B0F48257853002BDB79_ABlue_20hills.jpg/version/5/media" rel="attachment0"/>
<category term="version" scheme="tag:ibm.com,2006:td/type" label="version" />
<td:documentUuid>_Ptest002_RMain_D46DD905A03108B0F48257853002BDB79_ABlue_20hills.jpg</td:documentUuid>
<td:versionLabel>5</td:versionLabel>
<author>
<uri>CN=testuser002/O=ibm</uri>
<name>testuser002</name>
<email></email>
</author>
<td:modifier>
<td:uri>CN=testuser002/O=ibm</td:uri>
<td:name></td:name>
<td:email></td:email>
</td:modifier>
<title type="text">Blue hills</title>
<updated>2011-03-28T06:40:37Z</updated>
<published>2011-03-28T06:40:37Z</published>
<td:created>2011-03-28T06:40:37Z</td:created>
<td:modified>2011-03-28T06:40:37Z</td:modified>
<summary type="html">
<![CDATA[something changed]]>
</summary>
<content type="image/jpeg" src="dm/atom/library/_Ptest002_RMain/document/_Ptest002_RMain_D46DD905A03108B0F48257853002BDB79_ABlue_20hills.jpg/version/5/media" />
</entry>