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.

Input
Method URI Description
DELETE /files/{auth}/api/collection/{collection-id}/feed Remove file association with the folder.
Name Type Optional Description
collection-id
string No {collection-id} is the value of the <td:uuid> element in the folder'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
itemId
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
X-Method-Override
string Yes Tunnels a DELETE request over the HTTP POST request.
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 file was successfully removed from the folder.
401
Unauthorized.
403
Forbidden.
404
Not Found.
References