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 Chapter - Delete operation, it allows users to delete a chapter resource by specifying its ID.
Common scenarios where this node is beneficial include automating content management workflows in BookStack, such as removing outdated or incorrect chapters programmatically without manual intervention through the BookStack UI.
Practical example: Automatically deleting a chapter when it is no longer relevant or after migrating content elsewhere, triggered as part of a larger automation workflow.
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) Describe your request in natural language; the system will try to infer the resource and operation automatically. Example: "Delete chapter with ID 123". |
| ID | The unique identifier of the chapter resource to delete. This is required for the Delete operation. |
Output
The output JSON contains the response from the BookStack API after attempting to delete the specified chapter. Typically, for a successful delete operation, the API returns confirmation data or an empty object indicating success.
If the operation fails, the output JSON will contain an error message describing the issue.
No binary data is output by this node.
Example output on success:
{}
Example output on failure:
{
"error": "Resource not found"
}
Dependencies
- Requires an API key credential for authenticating with the BookStack API.
- The node expects the base URL of the BookStack instance and authentication tokens to be configured in the credentials.
- The BookStack API must be accessible from the environment where n8n runs.
Troubleshooting
- Missing or invalid ID: The Delete operation requires a valid chapter ID. If omitted or incorrect, the API will return an error indicating the resource was not found.
- Authentication errors: Ensure that the API token and base URL are correctly set in the credentials. Authentication failures will result in HTTP 401 or 403 errors.
- Resource not found: If the chapter ID does not exist, the API will respond with a not found error.
- API endpoint issues: Verify that the BookStack API endpoint is reachable and that the version matches the expected API paths used by the node.
- Continue On Fail: If enabled, the node will continue processing subsequent items even if one item fails, returning error details in the output JSON.