BookStack icon

BookStack

Consume BookStack API

Actions31

Overview

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

Common scenarios where this node is beneficial include automating content management workflows in BookStack, such as cleaning up outdated chapters or removing test content programmatically without manual intervention.

Practical example:

  • Automatically deleting chapters that are no longer relevant after a content review process.
  • Integrating with other systems to remove chapters when corresponding data is deleted elsewhere.

Properties

Name Meaning
ID The unique identifier of the chapter to delete. This is a required string input.

Output

The node outputs the JSON response from the BookStack API after attempting to delete the specified chapter. Typically, a successful deletion returns an empty object or confirmation message indicating the chapter was removed.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the BookStack API.
  • The base URL of the BookStack instance must be configured in the credentials.
  • The node sends an HTTP DELETE request to the endpoint /chapters/{id}, where {id} is the chapter ID provided.

Troubleshooting

  • Error: Unauthorized or Authentication Failed
    Ensure the API token and secret are correctly set in the credentials and have sufficient permissions to delete chapters.

  • Error: Resource Not Found (404)
    Verify that the chapter ID exists and is correct. Deleting a non-existent chapter will result in this error.

  • Error: Invalid ID Format
    The ID should be a valid string representing the chapter's numeric ID. Confirm the input matches expected format.

  • Network or Connection Issues
    Check connectivity to the BookStack server and ensure the base URL is reachable.

Links and References

Discussion