Actions31
Overview
This node integrates with the BookStack API, allowing users to manage various BookStack resources such as books, pages, chapters, shelves, users, roles, attachments, and tags. Specifically, for the Book resource with the Delete operation, the node deletes a book identified by its ID from the BookStack system.
Common scenarios where this node is beneficial include:
- Automating content management workflows by programmatically removing outdated or unwanted books.
- Integrating BookStack content lifecycle management into broader automation pipelines.
- Cleaning up test or temporary books created during automated processes.
For example, a user might set up an automation that deletes a book after it has been archived elsewhere or when it no longer meets certain criteria.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the book to delete. This is required to specify which book will be removed. |
Output
The node outputs JSON data representing the response from the BookStack API after attempting to delete the specified book. Typically, a successful delete operation returns an empty body or confirmation status. No binary data output is involved in this operation.
Dependencies
- Requires an API key credential for authenticating with the BookStack API.
- The base URL of the BookStack instance must be configured in the credentials.
- The node sends HTTP DELETE requests to the endpoint
/api/books/{id}where{id}is the book's ID.
Troubleshooting
Common issues:
- Providing an invalid or non-existent book ID will result in an error from the API indicating the resource was not found.
- Missing or incorrect API authentication tokens will cause authorization errors.
- Network connectivity problems can prevent the node from reaching the BookStack server.
Error messages and resolutions:
- 404 Not Found: The specified book ID does not exist. Verify the ID is correct.
- 401 Unauthorized or 403 Forbidden: Authentication failed. Check that the API token and base URL are correctly configured.
- Network errors/timeouts: Ensure the BookStack server is reachable and there are no firewall restrictions.