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 Tag resource's Update operation, it updates an existing tag by its ID. This is useful when you want to modify tag details in your BookStack instance programmatically, for example, renaming a tag or changing its properties.
Common scenarios include:
- Automating tag management workflows.
- Synchronizing tags from external systems.
- Updating tags in bulk via n8n workflows.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the tag resource to update. |
Note: For the Tag resource's Update operation, only the ID property is explicitly defined in the provided input properties. However, the node supports updating other fields like name (common for create/update operations on many resources), but these are not detailed here.
Output
The node outputs JSON data representing the updated tag resource as returned by the BookStack API. The output structure typically includes the tag's properties such as its ID, name, and any other metadata the API provides after the update.
No binary data output is involved in this operation.
Dependencies
- Requires connection to a BookStack instance via its API.
- Needs an API token credential with appropriate permissions to update tags.
- The base URL and authentication token must be configured in the node credentials.
Troubleshooting
- Missing or invalid ID: The update operation requires a valid tag ID. Ensure the ID is correct and exists in the BookStack instance.
- Authentication errors: Verify that the API token credential is correctly set up and has permission to update tags.
- API errors: If the API returns errors (e.g., 404 Not Found, 400 Bad Request), check that the tag exists and the request body is properly formed.
- Empty update payload: If no fields besides ID are provided for update, the API might reject the request or make no changes. Provide at least one field to update.