Actions40
- Role Actions
- Page Actions
- Chapter Actions
- Book Actions
- Shelf Actions
- User Actions
- Attachment Actions
- Tag Actions
Overview
This node integrates with the BookStack API to manage tags and other resources such as books, pages, chapters, shelves, users, roles, and attachments. Specifically, for the Tag - Delete operation, it allows you to delete a tag resource by specifying its ID.
Common scenarios where this node is beneficial include automating content management workflows in BookStack, such as cleaning up unused or obsolete tags programmatically, or integrating tag deletion into larger automation pipelines that maintain your documentation or knowledge base.
For example, you might use this node to automatically remove tags that are no longer relevant after a content update or to synchronize tags between BookStack and another system.
Properties
| Name | Meaning |
|---|---|
| Tool Description | Choose how to determine the resource and operation: "Set Automatically" or "Set Manually". |
| Request Description | (Shown if "Set Automatically") Describe what you want to do in natural language; the system tries to infer the resource and operation from this text. Example: "Delete tag with ID 123". |
| ID | The unique identifier of the tag resource to delete. Required for delete operations. |
Output
The node outputs JSON data representing the response from the BookStack API after attempting to delete the tag. Typically, for a successful delete operation, the API returns an empty object or confirmation message indicating the resource was deleted.
json: Contains the API response confirming deletion or error details.- No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the BookStack API.
- The node expects the BookStack instance base URL and authentication tokens configured in the credentials.
- HTTP requests are made to the BookStack REST API endpoints under
/api.
Troubleshooting
- Missing or invalid ID: If the ID property is not provided or incorrect, the API will return an error indicating the resource could not be found. Ensure the correct tag ID is specified.
- Authentication errors: If the API key or token is missing or invalid, the request will fail with an authorization error. Verify credentials are correctly set up.
- Resource not found: Attempting to delete a tag that does not exist will result in a 404 error. Confirm the tag ID exists before deletion.
- Network issues: Connectivity problems to the BookStack server will cause request failures. Check network access and base URL configuration.