BookStack icon

BookStack

Manage BookStack resources

Overview

This node integrates with the BookStack platform to manage its resources programmatically. Specifically, for the "Chapter" resource with the "Delete" operation, it allows users to delete a chapter by specifying its unique identifier. This is useful in scenarios where chapters need to be removed from a book structure automatically or as part of a workflow cleanup process.

Practical examples include:

  • Automatically deleting outdated or obsolete chapters during content updates.
  • Removing chapters based on external triggers or conditions in a content management workflow.

Properties

Name Meaning
Chapter ID The unique identifier of the chapter to delete (e.g., 101). This is a required string input.

Output

The output JSON contains the response from the BookStack API after attempting to delete the specified chapter. Typically, this will be an empty object or confirmation message indicating successful deletion. No binary data is output by this operation.

Example output JSON might look like:

{}

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 permissions to delete chapters.
  • No additional environment variables are needed beyond the configured API authentication.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent Chapter 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 request from completing.
  • Error messages:

    • "Chapter not found": Verify the Chapter ID is correct and exists.
    • "Unauthorized" or similar: Check that the API key has delete permissions.
    • "Network Error": Ensure the BookStack server URL is reachable.

Resolving these typically involves verifying the Chapter ID, checking API credentials, and ensuring network access.

Links and References

Discussion