Removing a file 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 a file from a folder. This action does not delete the file entirely; it only removes its association with the folder.

The currently authenticated user must be the owner of the folder, an administrator, the owner of the item in the folder or have been given delete access to the folder. Delete access is granted through the manager role of a folder. You must authenticate this request.

Note: {collection-id} is the value of the <td:uuid> element in the folder's Atom entry document.

You can use the following header.

Provide the following required input parameter.

Method URI Description
DELETE /files/{auth}/api/collection/{collection-id}/feed Remove file association with the folder.
Name Type Optional Description
string No {collection-id} is the value of the <td:uuid> element in the folder's Atom entry document.
enumerated No The authorization protocol being used by your application to access Connections Cloud.
Authorized values:
  • basic
  • oauth
Name Type Optional Description
string No String. Unique ID of the file that you want to remove from the folder. You can find this value in the <td:uuid> element in the file's Atom document.
Name Type Optional Description
string Yes Tunnels a DELETE request over the HTTP POST request.
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.
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(
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
Code Description
Indicates that the file was successfully removed from the folder.
Not Found.