Community articlePinning a file programmatically
Added by IBM contributorIBM on June 23, 2014
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

To pin a file, send a POST request to the myfavorites feed.



To pin a file, send a POST request to the myfavorites feed.


You can provide the following parameter.


Input


You must provide either an Atom document representing the file as input to the request or you must identify the file by providing the itemId parameter on the request.

Output


None.

Input
Method URI Description
POST /files/basic/api/myfavorites/documents/feed Pin a file
Content Type: application/atom+xml
Sample Request:
<entry> </entry>
Name Type Optional Description
itemId
string Yes String. Uuid that uniquely identifies the document. The uuid is defined in the <td:uuid> element in the Atom entry document of the file.
Output
Code Description
204
Indicates that the versions were successfully removed from the collection.
401
Unauthorized.
403
Forbidden.
404
Not Found.