Actions20
Overview
This node enables deleting files or folders in Dropbox by specifying their path. It is part of a broader Dropbox integration that supports file, folder, and search resources with various operations. The "Search - Delete" operation specifically allows users to delete files or folders identified through search results or directly by path.
Common scenarios where this node is beneficial include:
- Automating cleanup of files or folders in Dropbox based on dynamic criteria.
- Removing outdated or unwanted content found via search queries.
- Integrating Dropbox file management into workflows that require conditional deletion.
For example, after searching for all files matching certain criteria (e.g., old reports), this node can be used to delete those files automatically.
Properties
| Name | Meaning |
|---|---|
| Path to Delete | The full path of the file or folder in Dropbox that you want to delete. Example: /path/to/delete |
Output
The output JSON contains information about the deleted item:
resource: Always"file"(the resource type).operation: Always"delete"(the operation performed).deleted_path: The path of the file or folder that was deleted.result: The response data from Dropbox API confirming the deletion.
Example output structure:
{
"resource": "file",
"operation": "delete",
"deleted_path": "/path/to/delete",
"result": {
// Dropbox API deletion confirmation details
}
}
No binary data is output by this operation.
Dependencies
- Requires an OAuth 2.0 authenticated Dropbox API credential with appropriate permissions to delete files/folders.
- Uses Dropbox API endpoints, specifically
https://api.dropboxapi.com/2/files/delete_v2. - The node expects a valid access token, which it refreshes automatically if expired, using an OAuth handler service URL.
Troubleshooting
Common issues:
- Invalid or expired access token: The node attempts to refresh tokens automatically, but failure to do so will cause errors.
- Incorrect or non-existent path: Specifying a path that does not exist or is misspelled will result in an error from Dropbox API.
- Insufficient permissions: The OAuth token must have delete permissions; otherwise, the API call will fail.
Error messages:
"OAuth token refresh failed: ..."indicates problems refreshing the access token. Check OAuth credentials and connectivity to the token refresh endpoint."Dropbox operation failed: ..."indicates Dropbox API errors such as invalid path or permission denied. Verify the path and OAuth scopes.
To resolve errors, ensure the path is correct, the OAuth credentials are valid and have required scopes, and network connectivity to Dropbox API is stable.