WebDAV icon

WebDAV

Interact with WebDAV servers for file operations
Join our community

Actions7

Overview

This node enables interaction with WebDAV servers to perform various file operations, specifically here focusing on the "Move" operation for files or directories. It moves a resource from a source path to a destination path on the same WebDAV server.

Common scenarios where this node is useful include:

  • Organizing files on a remote WebDAV server by moving them between folders.
  • Renaming files or directories by moving them to a new path with a different name.
  • Automating file management workflows that require relocating resources on a WebDAV server.

For example, you might move a file from /documents/reports/old-report.pdf to /archive/reports/old-report.pdf to archive it after processing.

Properties

Name Meaning
Source Path The current path of the resource to move. Must start with "/". Spaces and special characters are automatically URL-encoded.
Destination Path The new path where the resource will be moved. Must start with "/". Spaces and special characters are automatically URL-encoded.
Overwrite Boolean flag indicating whether to overwrite the destination if a resource already exists there. Options: true (overwrite), false (do not overwrite).

Output

The node outputs JSON data describing the result of the move operation for each input item:

  • success: Boolean indicating if the move was successful (HTTP status code 2xx).
  • statusCode: HTTP status code returned by the WebDAV server.
  • sourcePath: The original path of the resource.
  • destinationPath: The target path where the resource was moved.

No binary data output is produced by this operation.

Example output JSON:

{
  "success": true,
  "statusCode": 201,
  "sourcePath": "/path/to/source",
  "destinationPath": "/path/to/destination"
}

Dependencies

  • Requires credentials containing the WebDAV server base URL and authentication details (e.g., API key or username/password).
  • The base URL must include the protocol (http:// or https://) and be correctly configured in the node's credentials.
  • The destination path must be on the same server as the base URL; cross-server moves are not supported.

Troubleshooting

  • Invalid Base URL: If the base URL in credentials is missing or does not start with http:// or https://, the node throws an error. Ensure the URL includes the protocol.
  • Absolute URLs in Paths: Providing absolute URLs instead of server-relative paths (starting with "/") for source or destination will cause errors. Use relative paths only.
  • Cross-Origin Destination: Moving a resource to a destination on a different server than the base URL is not allowed and will throw an error.
  • Connection Issues: Errors like "Host not found", "Connection refused", or "Timeout" indicate network or server availability problems.
  • Overwrite Conflicts: If Overwrite is false and the destination exists, the move may fail with a conflict error from the server.
  • Permission Denied: Insufficient permissions on the WebDAV server can cause failures; verify user rights.

Links and References

Discussion