Retrieving a version of a file
Added by IBM contributorIBM | Edited by Claudia R Elbourn on June 30, 2015
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Retrieve an Atom document representation of a version of a file from your library.

This method returns an Atom document containing the version.

Note: {document-id} is the value of the <td:uuid> or <td:label> element in the Atom entry document of the file. {version-id} is the value of the <td:uuid> element in the version's Atom entry document.

You can use one or more of these input parameters with the GET request. Separate multiple parameters with an ampersand (&).

Input
Method URI Description
GET /files/{auth}/api/myuserlibrary/document/{document-id}/version/{version-id}/entry Returns an Atom document containing the version of the file from your library. This request requires authentication.
Name Type Optional Description
document-id
string No {document-id} is the value of the <td:uuid> or <td:label> element in the Atom entry document of the file.
version-id
string No {version-id} is the value of the <td:uuid> element in the version's Atom entry document.
auth
enumerated No The authorization protocol being used by your application to access Connections Cloud.
Authorized values:
  • basic
  • oauth
Name Type Optional Description
acls
boolean Yes Indicates whether permissions should be retrieved and returned with the version entry. Options are true or false. The default value is false.
identifier
string Yes Indicates how the document is identified in the {document-id} variable segment of the web address. By default, the lookup operation is performed with the expectation that the URL contains the value from the <td:uuid> element of a document Atom entry, so the value uuid is used. Specify label if the URL instead contains the value from the <td:label> element of a document Atom entry.
inline
boolean Yes Specifies whether the version content should be included in the content element of the returned Atom document. Options are true or false. The default value is false.
Name Type Optional Description
If-Modified-Since
string Yes Used to validate the local cache of the feed and entry documents retrieved previously. If the feed or entry has not been modified since the specified date, HTTP response code 304 (Not Modified) is returned.
If-None-Match
string Yes Contains an ETag response header sent by the server in a previous request to the same URL. If the ETag is still valid for the specified resource, HTTP response code 304 (Not Modified) is returned.
Authorization
enumerated No The authentication mechanism selected by your application to access the API.
Basic is the Base64 encoding of the IBM Connections Cloud username and password: Base64(username:password). For example, Base64(twatson@us.ibm.com:password).
Bearer is the oauth 2.0 access token that is generated when the user grants your application access to IBM Connections Cloud services.
See the reference topic "OAuth 2.0 APIs for web server flow" for more information.
Authorized values:
  • bearer
  • basic
Output
Content Type: application/atom+xml
Code Description
200
OK. Indicates that the version entry was successfully found and returned. If an error occurs, this header will contain one of the error codes below.
401
Unauthorized.
403
Forbidden.
404
Not Found.