BookStack icon

BookStack

Manage BookStack resources

Overview

This node integrates with the BookStack platform to manage its resources such as books, pages, shelves, and chapters. Specifically, for the Page - Delete operation, it allows users to delete a page by specifying its unique identifier. This is useful in scenarios where outdated or incorrect pages need to be removed from the BookStack documentation system.

Practical examples include:

  • Automatically cleaning up pages that are no longer relevant.
  • Removing test or draft pages created during content development.
  • Managing content lifecycle by deleting pages based on external triggers or workflows.

Properties

Name Meaning
Page ID The unique identifier of the page to delete. Example: "456". This is required to specify which page to remove.

Output

The output of the delete operation returns the JSON 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. No binary data is produced by this operation.

The output structure is:

{}

or a similar minimal JSON confirming the deletion.

Dependencies

  • Requires an active connection to a BookStack instance via an API key credential.
  • The node depends on the BookStack REST API being accessible and the provided API key having sufficient permissions to delete pages.
  • No additional external services are needed beyond the BookStack API.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent Page ID will result in an error from the API.
    • Insufficient permissions for the API key can cause authorization errors.
    • Network connectivity problems may prevent the node from reaching the BookStack server.
  • Error messages and resolutions:

    • "Page not found": Verify the Page ID is correct and the page exists.
    • "Unauthorized" or "Forbidden": Check that the API key has delete permissions.
    • "Network Error": Ensure the BookStack URL is reachable and there are no firewall restrictions.

Links and References

Discussion