OnlyOffice

Interact with OnlyOffice files and folders
Join our community

Actions12

Overview

The node integrates with OnlyOffice to manage folders and files via its API. Specifically, the Folder - Move operation allows users to move a folder or file from one location to another within their OnlyOffice document storage.

This operation is useful in scenarios such as:

  • Organizing documents by moving folders/files into appropriate directories.
  • Automating document management workflows where files/folders need to be relocated based on business logic.
  • Handling bulk moves of folders or files programmatically without manual intervention.

For example, you might use this node to move a project folder into an archive directory after project completion or relocate files uploaded to a temporary folder into their final destination.

Properties

Name Meaning
Item ID The unique identifier of the folder or file to move.
Destination Folder ID The unique identifier of the folder where the item will be moved to.
Conflict Resolution How to handle conflicts if an item with the same name exists in the destination folder. Options: Skip (do not move), Overwrite (replace existing), Duplicate (create a copy with a new name).

Output

The output JSON contains the response from the OnlyOffice API after attempting the move operation. This typically includes metadata about the moved folder or file, such as its new location, ID, and other relevant details returned by the API.

No binary data is output by this operation.

Dependencies

  • Requires an active OnlyOffice API credential configured in n8n with access to the OnlyOffice instance.
  • The node makes authenticated HTTP requests to the OnlyOffice API endpoint specified in the credentials.
  • The base URL for the API is taken from the credential configuration.

Troubleshooting

  • Common issues:

    • Invalid or missing Item ID or Destination Folder ID can cause the API call to fail.
    • Insufficient permissions or incorrect API credentials will result in authentication errors.
    • Conflicts during move operations may cause failures if conflict resolution is set to "Skip" and a naming conflict exists.

  • Error messages:

    • Errors from the OnlyOffice API are propagated and usually include descriptive messages.
    • If the node throws an error like Unknown folder operation: move, it indicates a misconfiguration or unsupported operation.

  • Resolutions:

    • Verify that the IDs provided correspond to existing folders/files.
    • Ensure the API credentials have proper permissions.
    • Adjust the conflict resolution setting according to your needs.
    • Enable "Continue On Fail" in the node settings to handle errors gracefully in workflows.

Links and References

Discussion