Actions56
- Book Actions
- Page Actions
- Chapter Actions
- Shelf Actions
- User Actions
- Role Actions
- Attachment Actions
- Tag Actions
Overview
This node integrates with the BookStack API to manage various BookStack resources such as books, pages, chapters, shelves, users, roles, attachments, and tags. Specifically, for the Attachment resource with the Delete operation, it allows users to delete an attachment by specifying its ID.
Common scenarios where this node is beneficial include automating content management workflows in BookStack, such as removing outdated or incorrect attachments from documentation pages or other resources. For example, if a file attached to a page is no longer relevant, this node can be used to programmatically delete that attachment without manual intervention.
Properties
| Name | Meaning |
|---|---|
| Tool Description | Choose how to determine the resource and operation: - Set Automatically - Set Manually |
| Request Description | (Shown only if "Set Automatically" is selected) A text description of what you want to do; the system uses this to automatically select the appropriate resource and operation. Example: "Delete attachment with ID 123". |
| ID | The unique identifier of the attachment resource to delete. This is required for the Delete operation. |
Output
The output contains a JSON object representing the response from the BookStack API after attempting to delete the specified attachment. Typically, for a successful deletion, the API returns confirmation data or an empty object indicating success.
json: The main output field containing the API response.pairedItem: Metadata linking the output to the corresponding input item.
This node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the BookStack API.
- The node expects the BookStack instance base URL and authentication tokens to be configured in the credentials.
- The API endpoint used for deleting an attachment follows the pattern:
/attachments/{id}with HTTP DELETE method.
Troubleshooting
- Missing or invalid ID: If the ID property is not provided or incorrect, the API will return an error indicating the resource was not found. Ensure the correct attachment ID is supplied.
- Authentication errors: If the API key or token is missing or invalid, the request will fail with an authentication error. Verify that the API credentials are correctly set up.
- Permission issues: Deleting attachments requires appropriate permissions in BookStack. If the user associated with the API token lacks delete rights, the operation will fail.
- Network or connectivity problems: Ensure the BookStack server is reachable from n8n and that the base URL is correctly configured.