OnlyOffice

Interact with OnlyOffice files and folders
Join our community

Actions12

Overview

This node integrates with OnlyOffice to manage folders and files within the OnlyOffice environment. Specifically, for the Folder - Create operation, it allows users to create a new folder inside a specified parent folder. This is useful in scenarios where automated workflows need to organize documents or project files dynamically by creating folder structures on the fly.

For example, you might use this node to:

  • Automatically create a project folder when a new client is onboarded.
  • Organize files by date or category by creating corresponding folders.
  • Set up nested folder structures as part of a document management workflow.

Properties

Name Meaning
Parent Folder ID The ID of the parent folder where the new folder will be created. Common values include @my for "My Documents" or any specific folder ID.
Title The name/title of the new folder to be created inside the parent folder.

Output

The output JSON contains the response from the OnlyOffice API after creating the folder. This typically includes details about the newly created folder such as its ID, title, creation date, and other metadata provided by OnlyOffice.

Example output structure (simplified):

{
  "id": "new-folder-id",
  "title": "New Folder Name",
  "created": "2024-06-01T12:00:00Z",
  ...
}

No binary data is produced by this operation.

Dependencies

  • Requires an API key credential for OnlyOffice with appropriate permissions.
  • The node uses the OnlyOffice API base URL configured in the credentials.
  • Network access to the OnlyOffice API endpoint is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing parent folder ID can cause the API to reject the request.
    • Insufficient permissions or invalid API credentials will result in authentication errors.
    • Network connectivity problems may cause timeouts or failed requests.

  • Error messages:

    • "Unknown folder operation: create" — indicates a misconfiguration or bug; ensure the operation parameter is correctly set to "create".
    • Authentication errors usually mention unauthorized access; verify the API key and credentials.
    • Validation errors from the API may indicate missing or invalid parameters like the folder title or parent folder ID.

To resolve these, double-check input parameters, ensure valid credentials are used, and confirm network connectivity.

Links and References

Discussion