Overview
This node integrates with the OnlyOffice API to manage files and folders. Specifically, for the Folder - Delete operation, it allows users to delete a folder either by moving it to the trash or deleting it immediately from the OnlyOffice storage.
Common scenarios where this node is beneficial include:
- Automating cleanup of project folders after completion.
- Managing document lifecycle by removing obsolete folders.
- Integrating OnlyOffice folder management into broader workflows, such as archiving or data retention policies.
Example use case: Automatically delete a folder containing temporary documents once a workflow finishes processing them, optionally bypassing the trash to free up space immediately.
Properties
| Name | Meaning |
|---|---|
| Item ID | The unique identifier of the folder or file to delete. |
| Delete Immediately | Boolean flag indicating whether to delete the folder immediately (true) or move it to trash (false). |
Output
The output JSON contains the response from the OnlyOffice API after attempting to delete the folder. This typically includes confirmation of deletion or details about the deleted item.
No binary data is output by this operation.
Dependencies
- Requires an API key credential for OnlyOffice API authentication.
- The node uses the base URL configured in the OnlyOffice API credentials.
- Network access to the OnlyOffice API endpoint is necessary.
Troubleshooting
Common issues:
- Invalid or missing
Item IDwill cause the API call to fail. - Insufficient permissions or invalid API credentials can result in authorization errors.
- Attempting to delete a non-existent folder will return an error from the API.
- Invalid or missing
Error messages:
"Unknown folder operation: delete"— indicates an internal misconfiguration; ensure the operation parameter is correctly set to "delete".- API errors related to HTTP status codes (e.g., 404 Not Found, 401 Unauthorized) should be resolved by verifying folder IDs and credentials.
Links and References
- OnlyOffice API Documentation (general reference for API endpoints)
- n8n documentation on Creating Custom Nodes