Actions13
- File/Folder Actions
- File Actions
- Folder Actions
- Share Actions
Overview
This node operation allows you to delete a share by its permissions ID in the Twake Drive system. Shares represent access permissions granted to files or folders, often with specific labels (codes) that can be revoked individually. This operation is useful when you want to revoke access to shared resources either entirely or partially by removing selected labels.
Common scenarios include:
- Revoking all access to a shared file or folder by deleting the entire share.
- Selectively revoking access for certain users or clients by removing only specific labels from the share without deleting it completely.
Practical example:
- You have shared a document with multiple clients using different access codes (labels). When one client no longer needs access, you can revoke just their label instead of deleting the whole share, preserving access for others.
Properties
| Name | Meaning |
|---|---|
| Permissions Name or ID | Select the share to delete by choosing from a list of existing shares (displayed as labels and IDs) or specify an ID via expression. |
| Revoke Only Selected Labels | Boolean flag indicating whether to revoke only selected labels within the share (true) or delete the entire share (false). |
| Labels to Revoke (Optional) | If "Revoke Only Selected Labels" is enabled, select one or more labels (codes) to revoke from the share. Leaving this empty will delete the entire share. Labels can be chosen from a list or specified via expression. |
Output
The node outputs the result of the delete operation in the json field of the output data. The structure typically contains information about the success or failure of the deletion request, such as confirmation of revoked labels or deleted share.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the Twake Drive API.
- Needs access to the Twake Drive instance URL and API token configured in the credentials.
- Uses HTTP requests to interact with the Twake Drive API endpoints related to share permissions.
Troubleshooting
- Invalid Permissions ID: If the provided permissions ID does not exist or is malformed, the node may throw an error indicating the share could not be found. Verify the ID or select a valid share from the dropdown.
- Labels Not Found: When revoking selected labels, if any specified label does not exist on the share, the operation might fail or ignore those labels. Ensure labels are correctly loaded and selected.
- API Authentication Errors: If the API token or instance URL is incorrect or expired, authentication errors will occur. Check and update the credentials accordingly.
- Network Issues: Connectivity problems with the Twake Drive API endpoint can cause timeouts or failures. Confirm network access and endpoint availability.
- To resolve errors, review the error message details returned by the node and verify input parameters and credentials.
Links and References
- Twake Drive API Documentation (for general API reference)
- n8n Expressions Documentation (for using expressions in property fields)