Skip to content

Deleting a File

Method

DELETE

Endpoint URL:

https://xxxx.backendless.app/api/files/<path>/<filename> 

where:

Argument                Description
<path> Directory path in the Backendless file storage where the file should be deleted.
<filename> Name of the file to delete.

Request headers

user-token: optional value obtained as a result of the login operation.

where:

Argument                Description
user-token Optional header. Contains a value returned by Backendless in a preceding user Login API call. If user-token is set in the request, the currently logged in user will be assigned to the ownerId property of the user object which is being saved.  Additionally, the operation will be executed with the security policy associated currently logged in user. This means all permissions associated with the user and the roles assigned to the user will be enforced by Backendless.

Request Body:

None

Response Body

None or error.

Example

Important

Make sure to replace xxxx in the domain name in the sample request below to the one assigned to your application.

curl -X DELETE  
-v http://xxxx.backendless.app/api/files/txtfiles/test.txt

Codeless Reference

files_api_delete_file_1

where:

Argument                Description
file path A path identifying a directory where a file must be deleted. The path must start with the root directory of the remote file storage.

This operation does not return a value.

Consider the following file stored in the notes directory:

files_api_delete_file_2

The example below deletes the "grocery.txt" file from the "notes" directory.

files_api_delete_file_3