Dropbox OAuthInstall

Overview

This node integrates with Dropbox to perform file operations using OAuth 2.0 authentication. Specifically, for the File resource and Move operation, it moves a file or folder from one path to another within Dropbox.

Typical use cases include:

• Organizing files by moving them into different folders automatically.
• Renaming files or folders by moving them to a new path with a different name.
• Automating workflows that require relocating files after processing.

For example, after processing an uploaded file, you might move it from a temporary upload folder to a permanent storage folder.

Properties

Output

The output JSON object contains:

• resource: Always "file" indicating the resource type.
• operation: Always "move" indicating the performed operation.
• source_path: The original path of the file or folder before moving.
• destination_path: The target path where the file or folder was moved.
• result: The detailed response data from Dropbox API about the move operation, including metadata of the moved item.

Example output structure (simplified):

{
  "resource": "file",
  "operation": "move",
  "source_path": "/source/path/file.txt",
  "destination_path": "/destination/path/file.txt",
  "result": {
    // Dropbox API response with metadata about the moved file/folder
  }
}

Dependencies

• Requires a valid OAuth 2.0 access token for Dropbox API authentication.
• The node uses an external OAuth handler service URL to refresh tokens if needed.
• Requires configuration of an API key credential with OAuth 2.0 for Dropbox.
• Uses the Dropbox API endpoints for file operations (/2/files/move_v2).

Troubleshooting

• OAuth Token Refresh Failed: If the node cannot refresh the OAuth token, ensure the OAuth handler URL is reachable and configured correctly. Check network connectivity and credentials.
• Invalid Source or Destination Path: Errors may occur if the specified paths do not exist or are invalid. Verify the paths are correct and accessible.
• Permission Denied: Ensure the OAuth token has sufficient permissions to move files/folders in the specified locations.
• API Rate Limits: Dropbox enforces rate limits; if exceeded, wait and retry later.
• Unknown Resource or Operation: This node only supports known resources and operations; verify the selected resource is "file" and operation is "move".

Links and References

• Dropbox API Documentation - Move
• Dropbox OAuth Guide