Actions22
Overview
This node integrates with the BookStack platform to manage its resources programmatically. Specifically, for the Chapter - Create operation, it allows users to create a new chapter within a specified book in BookStack. This is useful for automating content organization workflows, such as dynamically adding chapters when new content is generated or imported.
Practical examples include:
- Automatically creating chapters in a book when new course modules are added.
- Organizing documentation by programmatically adding chapters based on external data sources.
- Bulk creation of chapters during migration or synchronization tasks.
Properties
| Name | Meaning |
|---|---|
| Book ID | The identifier of the book to which the new chapter will belong. |
| Name | The name/title of the chapter (up to 255 characters). |
| Description | Optional description text for the chapter (up to 1900 characters). |
| Tags | Optional comma-separated list of tags to categorize or label the chapter (e.g., "tag1, tag2"). |
Output
The node outputs JSON objects representing the created chapter resource as returned by the BookStack API. Each output item corresponds to one created chapter and includes all relevant fields provided by the API response.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential configured in n8n to authenticate requests against the BookStack API.
- The node uses HTTP requests to communicate with the BookStack REST API endpoints.
- Proper permissions on the BookStack instance are necessary to create chapters within books.
Troubleshooting
- Missing Required Fields: If "Book ID" or "Name" is not provided, the node will fail because these are mandatory for chapter creation.
- API Authentication Errors: Ensure the API key credential is valid and has sufficient permissions.
- Invalid Tags Format: Tags must be provided as a comma-separated string; improper formatting may cause unexpected behavior.
- API Rate Limits or Network Issues: These can cause request failures; check network connectivity and API limits.
- Error Messages: The node throws errors with messages from the BookStack API or generic messages if parameters are missing or invalid. Review the error message and verify input parameters accordingly.