Dropbox OAuth

Professional Dropbox API integration with OAuth 2.0 and automatic token refresh
Join our community

Actions20

Overview

This node integrates with Dropbox to perform file-related operations using OAuth 2.0 authentication. Specifically, for the File - Delete operation, it deletes a specified file or folder path from a user's Dropbox storage.

Common scenarios where this node is beneficial include:

  • Automating cleanup of files or folders in Dropbox after processing.
  • Removing outdated or temporary files as part of a workflow.
  • Managing storage by programmatically deleting unwanted content.

For example, you could use this node to delete log files older than a certain date or remove files after they have been backed up elsewhere.

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 object contains information about the deletion result:

  • resource: Always "file" indicating the resource type.
  • operation: Always "delete" indicating the performed operation.
  • deleted_path: The path 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 response details about the deleted item
  }
}

No binary data is output by this operation.

Dependencies

  • Requires an OAuth 2.0 authenticated connection to Dropbox via an API key credential.
  • Uses Dropbox API endpoints, specifically https://api.dropboxapi.com/2/files/delete_v2.
  • The node expects valid access tokens and handles token refresh automatically through an external OAuth handler service.

Troubleshooting

  • Common issues:

    • Invalid or expired OAuth tokens can cause authentication failures.
    • Specifying a non-existent path will result in an error from Dropbox API.
    • Insufficient permissions on the Dropbox account may prevent deletion.

  • Error messages:

    • "OAuth token refresh failed": Indicates failure to refresh the access token; check OAuth credentials and connectivity to the token refresh service.
    • "Dropbox operation failed: ...": General error wrapper; inspect the message for specific Dropbox API errors such as "path not found" or "permission denied".

  • Resolutions:

    • Ensure the OAuth credentials are correctly configured and authorized.
    • Verify the path exists and is accessible.
    • Confirm the Dropbox app has required scopes to delete files/folders.

Links and References

Discussion