Actions56
- Book Actions
- Page Actions
- Chapter Actions
- Shelf Actions
- User Actions
- Role 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 deletes a tag resource identified by 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 documentation structure.
Practical example: Automatically removing a tag from BookStack when a related project is archived or deleted in another system, ensuring the documentation stays relevant and tidy.
Properties
| Name | Meaning |
|---|---|
| Tool Description | Choose how to determine the resource and operation: - Set Automatically - Set Manually |
| Request Description | (Shown only if "Set Automatically" is selected) Describe your request in natural language; the system tries to infer the resource and operation automatically. Example: "Delete tag with ID 123". |
| ID | The unique identifier of the tag resource to delete. Required for delete operation. |
Output
The output JSON contains 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.
If the node encounters an error (e.g., invalid ID, permission issues), the output JSON will contain an error field with the error message.
No binary data is output by this node.
Dependencies
- Requires connection to a BookStack instance via its API.
- Needs an API authentication token credential configured in n8n with:
- Base URL of the BookStack API.
- Token and token secret for authorization.
- The node uses HTTP DELETE requests to the endpoint
/tags/{id}to perform the deletion.
Troubleshooting
Common Issues:
- Invalid or missing Tag ID: The node requires a valid tag ID to delete. Ensure the ID is correct and exists.
- Authentication errors: Verify that the API token credentials are correctly set up and have sufficient permissions.
- Network or connectivity problems: Confirm that the BookStack API base URL is reachable from the n8n environment.
Error Messages:
"error": "Resource not found": The specified tag ID does not exist. Check the ID value."error": "Unauthorized"or similar: Authentication failed. Recheck API credentials.- Other HTTP errors returned by the API will be passed through; consult BookStack API documentation for details.