Dropbox OAuth

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

Actions20

Overview

This node operation moves a folder from one location to another within Dropbox. It is useful for organizing files and folders by relocating them without needing to download and re-upload. For example, you might move a project folder into an archive directory after completion or reorganize team folders based on department changes.

Properties

Name Meaning
Source Path Path of the source folder to move (e.g., /source/path). This is the current location of the folder.
Destination Path Path where the folder should be moved to (e.g., /destination/path). This is the new location for the folder.

Output

The output JSON contains details about the move operation:

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

Example output structure:

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

Dependencies

  • Requires a valid OAuth 2.0 access token credential for Dropbox API authentication.
  • Uses Dropbox API endpoints, specifically files/move_v2 for moving folders.
  • Network connectivity to Dropbox API service is necessary.

Troubleshooting

  • Common issues:

    • Invalid or expired OAuth token: The node attempts to refresh the token automatically but may fail if refresh credentials are invalid.
    • Incorrect source or destination paths: Paths must be valid and accessible in Dropbox; otherwise, the API will return errors.
    • Permission errors: The authenticated user must have permission to move the specified folder.

  • Error messages:

    • "Dropbox operation failed: <message>": General failure during the Dropbox API call. Check the message for specifics like invalid path or permission denied.
    • "OAuth token refresh failed: <message>": Indicates failure to refresh the OAuth token. Re-authenticate the Dropbox credential.
    • "Unknown folder operation: move": Should not occur here since "move" is supported, but indicates an unsupported operation if seen.

  • Resolutions:

    • Verify OAuth credentials and reauthorize if needed.
    • Double-check folder paths for typos or non-existent folders.
    • Ensure the Dropbox account has sufficient permissions.

Links and References

Discussion