Remove a file from a folder 

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.

See Authenticating requests for information about how to authenticate the request.

Table 1. Atom API request details

Method	URI	Input and output representations
DELETE	/basic/api/collection/{collection-id}/feed	none

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

You can use the following header.

Table 2. Input header

Parameter	Description
X-Method-Override	Tunnels a DELETE request over the HTTP POST request.

Provide the following required input parameter.

Table 3. Input parameter

Parameter	Description
itemId Note: This is a required parameter.	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.

Input

None.

Output

None.

Returned HTTP headers

HTTP/1.1 204 No Content

Indicates that the file was successfully removed from the folder.

Error codes

• HTTP/1.1 401 Unauthorized

• HTTP/1.1 403 Forbidden

• HTTP/1.1 404 Not Found

Parent topic

Work with files

Related reference
File content

+

Search Tips   |   Advanced Search