BookStack icon

BookStack

Manage BookStack resources

Overview

This node integrates with the BookStack platform, allowing users to manage various BookStack resources such as books, pages, shelves, and chapters. Specifically, for the Book - Delete operation, it enables the deletion of a book by its unique identifier.

Common scenarios where this node is beneficial include:

  • Automating content management workflows by programmatically removing outdated or irrelevant books.
  • Integrating BookStack resource management into broader automation pipelines.
  • Cleaning up test or temporary data in BookStack environments.

For example, you might use this node to delete a book after archiving its contents elsewhere, or as part of a scheduled cleanup process that removes books no longer needed.

Properties

Name Meaning
Book ID The unique identifier of the book to delete (e.g., "123"). This is a required string input.

Output

The output JSON contains the response from the BookStack API after attempting to delete the specified book. Typically, this will be an empty object or confirmation of deletion depending on the API's response.

No binary data is output by this node.

Example output JSON might look like:

{}

or some confirmation structure depending on the API.

Dependencies

  • Requires an active connection to a BookStack instance.
  • Needs an API key credential configured in n8n for authenticating requests to the BookStack API.
  • The node uses HTTP methods to interact with the BookStack REST API endpoints.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent Book ID will result in an error from the API.
    • Missing or incorrect API credentials will cause authentication failures.
    • Network connectivity issues can prevent successful API calls.
  • Error messages:

    • "Book not found": Indicates the provided Book ID does not exist. Verify the ID.
    • "Authentication failed" or similar: Check that the API key credential is correctly set up.
    • "Request failed" or timeout errors: Ensure network access to the BookStack server.

To resolve these, verify the Book ID, confirm API credentials, and check network connectivity.

Links and References

Discussion