Removing a pin from a folder
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

Removes the folder from the myfavorites feed. Provide either an Atom document representing the collection as input to the request or identify the folder by providing the itemId parameter on the request.
You can provide the following input parameter and the following input request header.
Input
Method URI Description
DELETE /files/{auth}/api/myfavorites/collections/feed Removes the folder from the myfavorites feed.
Content Type: application/atom+xml
Name Type Optional Description
auth
enumerated No The authorization protocol being used by your application to access Connections Cloud.
Authorized values:
  • basic
  • oauth
Name Type Optional Description
itemId
string Yes String. Uuid that uniquely identifies the folder. The uuid is defined in the <td:uuid> element in the Atom entry document of the folder.
Name Type Optional Description
X-Method-Override
string Yes Tunnels a DELETE request over an HTTP POST.
X-Update-Nonce
string Yes String. Represents a unique data string generated by the server upon request that you can provide to secure the request. See Getting a nonce key for information about how to request the data string.
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
Code Description
204
Indicates that the folder was successfully removed from the myfavorites feed.
401
Unauthorized.
403
Forbidden.
404
Not Found.