Dropbox OAuth

Professional Dropbox API integration with OAuth 2.0 and automatic token refresh

Overview

This node enables copying files or folders found via Dropbox's search functionality. It is useful when you want to duplicate items discovered through a search query without manually specifying exact paths. For example, after searching for all files matching certain criteria (e.g., file type or name), you can copy selected files or folders to another location within Dropbox.

Practical scenarios include:

  • Automating backup copies of specific files found by search.
  • Organizing files by copying search results into categorized folders.
  • Duplicating project assets identified through search queries.

Properties

Name Meaning
Source Path Path of the source file or folder to copy.
Destination Path Path where the copied file or folder will be placed.

Output

The output JSON contains details about the copy operation:

  • resource: Always "file" for this operation under the Search resource.
  • operation: Always "copy".
  • source_path: The original path of the file or folder copied.
  • destination_path: The target path where the item was copied.
  • result: The response data from Dropbox API confirming the copy operation, including metadata about the copied item.

No binary data is output by this operation.

Dependencies

  • Requires an OAuth 2.0 authenticated connection to Dropbox with appropriate permissions to read and write files/folders.
  • Uses Dropbox API endpoints for file operations.
  • Needs a valid access token, which the node attempts to refresh automatically if expired.

Troubleshooting

  • Common issues:

    • Invalid or expired OAuth token: The node tries to refresh tokens but may fail if the refresh endpoint is unreachable or credentials are invalid.
    • Incorrect source or destination paths: Paths must be valid Dropbox paths; otherwise, the API returns errors.
    • Insufficient permissions: The OAuth token must have rights to read from the source and write to the destination.
  • Error messages:

    • "OAuth token refresh failed: ..." indicates problems refreshing the access token. Check network connectivity and credential validity.
    • "Dropbox operation failed: ..." covers general API errors such as invalid paths or permission issues. Verify input paths and OAuth scopes.

Links and References

Discussion