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 User resource with the Delete operation, it allows you to delete a user by specifying their unique ID. This is useful in scenarios where you need to automate user management tasks, such as removing users who no longer require access or cleaning up inactive accounts.
Practical example: Automatically deleting a user from BookStack when they leave an organization by triggering this node with the user's ID.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the user to be deleted. This is required to specify which user resource should be removed. |
Output
The node outputs JSON data representing the response from the BookStack API after attempting to delete the user. Typically, for a successful deletion, the output may be empty or contain confirmation details depending on the API's response. There is no binary data output for 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 uses HTTP DELETE requests to the endpoint
/api/users/{id}where{id}is the user ID.
Troubleshooting
Common issues:
- Providing an invalid or non-existent user ID will result in an error from the API.
- Missing or incorrect API authentication token will cause authorization failures.
- Network connectivity issues to the BookStack server can prevent the request from completing.
Error messages and resolutions:
- 401 Unauthorized: Check that the API token credentials are correctly set and have sufficient permissions.
- 404 Not Found: Verify that the user ID exists in the BookStack system.
- 400 Bad Request: Ensure the ID parameter is provided and correctly formatted.
- Network errors: Confirm the base URL is reachable and correct.