Dropbox OAuthInstall

Overview

This node enables copying folders within Dropbox using the Dropbox API. It supports specifying a source folder path and a destination folder path, then performs the copy operation on Dropbox servers. This is useful for automating file management workflows such as backing up folders, duplicating project directories, or reorganizing folder structures without manual intervention.

For example, you can use this node to copy a project folder from one location in Dropbox to another, creating a backup before making changes, or to duplicate a template folder structure for new projects.

Properties

Output

The output JSON contains details about the copy operation result:

• resource: Always "folder" indicating the resource type.
• operation: Always "copy" indicating the performed operation.
• source_path: The original folder path provided as source.
• destination_path: The target folder path where the folder was copied.
• result: An object containing the response data from Dropbox API about the copied folder, including metadata like folder ID, name, and path.

Example output snippet:

{
  "resource": "folder",
  "operation": "copy",
  "source_path": "/source/folder",
  "destination_path": "/destination/folder",
  "result": {
    // Dropbox API response with folder metadata
  }
}

Dependencies

• Requires an OAuth 2.0 authenticated Dropbox API credential with appropriate permissions to read and write folders.
• Uses the official Dropbox API endpoints for folder operations.
• Requires network access to Dropbox API servers.

Troubleshooting

• Invalid Access Token: If the OAuth token is expired or invalid, the node attempts to refresh it via a configured OAuth handler URL. Failure to refresh will cause an error. Ensure your OAuth credentials are correctly set up and the refresh endpoint is accessible.
• Path Errors: Providing incorrect or non-existent source paths will cause Dropbox API errors. Verify the source folder path exists.
• Permission Issues: Insufficient permissions on the Dropbox account or app may cause failures. Confirm the OAuth token has folder read/write scopes.
• API Rate Limits: Frequent operations might hit Dropbox API rate limits, resulting in temporary errors. Implement retries or reduce request frequency if needed.

Common error message example:

• "Dropbox operation failed: <error message>" — indicates an issue returned by Dropbox API; check the message for details.

Links and References

• Dropbox API Documentation - Copy Folder
• Dropbox OAuth Guide