BookStackInstall

Overview

This node integrates with the BookStack API to manage content resources such as books, pages, chapters, shelves, users, roles, attachments, and tags. Specifically, for the Page - Delete operation, it allows users to delete a page resource by specifying its unique ID.

Common scenarios where this node is beneficial include:

• Automating content management workflows in BookStack, such as removing outdated or irrelevant pages.
• Integrating BookStack page deletion into larger automation pipelines, e.g., cleaning up documentation pages after a project ends.
• Managing content lifecycle programmatically without manual intervention in the BookStack UI.

Example use case:

• Automatically deleting a page identified by its ID when a related project is archived or deleted in another system.

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 attempts to infer the resource and operation automatically. Example: "Delete the page with ID 123".
ID	The unique identifier of the page resource to delete. Required for delete operations.

Output

The output JSON contains the response from the BookStack API after attempting to delete the specified page. Typically, this will be an empty object or confirmation message indicating successful deletion.

If the operation fails, the output may contain an error message describing the failure.

No binary data output is produced by this node.

Example output JSON on success:

{}

Example output JSON on failure:

{
  "error": "Resource not found"
}

Dependencies

• Requires connection credentials to the BookStack API, including:
  • Base URL of the BookStack instance.
  • An API token and secret for authentication.
• The node uses HTTP DELETE requests to the endpoint /pages/{id} to perform the deletion.
• Proper permissions are required on the API token to delete page resources.

Troubleshooting

• Common issues:

  • Providing an invalid or non-existent page ID will result in an error from the API.
  • Insufficient permissions on the API token can cause authorization errors.
  • Incorrect base URL or expired tokens will prevent successful API calls.

• Error messages and resolutions:

  • "Resource not found": Verify that the page ID exists and is correct.
  • "Unauthorized" or "Forbidden": Check API token permissions and validity.
  • Network or timeout errors: Ensure the BookStack server is reachable and responsive.

• When using automatic mode ("Set Automatically"), ambiguous or incomplete request descriptions may lead to incorrect operation/resource detection. In such cases, switch to manual mode and specify parameters explicitly.

Links and References

• BookStack API Documentation
• BookStack Official Website