Actions24
- Tag Actions
- Provider Link Actions
- Computer Actions
- Maintenance Actions
- Person Actions
- Tenant Actions
- User Actions
Overview
The node provides functionality to update a Tag resource in the ImmyBot system. It allows users to modify existing tags by specifying their ID and updating properties such as name, description, and color. This is useful for organizing or reclassifying items dynamically within workflows that rely on tagging for categorization or filtering.
Practical examples include:
- Renaming a tag to better reflect its purpose.
- Changing the color of a tag to improve visual identification.
- Updating the description to provide more context about the tag's use.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the tag to update (required). |
| Name | The new name to assign to the tag (required). |
| Description | A textual description providing additional details about the tag. |
| Color | The color assigned to the tag. Options: Black, Blue, Danger, Orange, Primary, Purple, Secondary, Success, Warning. |
Output
The node outputs JSON data representing the updated tag object after the operation completes successfully. This typically includes the tag's ID, name, description, color, and possibly other metadata returned by the API.
If the node supports binary data output, it would relate to any associated media or files linked to the tag, but based on the provided code and properties, this node primarily deals with JSON data.
Dependencies
- Requires an API key credential for authenticating with the ImmyBot service.
- Needs the subdomain configuration to construct the base URL for API requests.
- The node depends on the ImmyBot API v1 endpoint at
https://{subdomain}.immy.bot/api/v1.
Troubleshooting
- Invalid ID error: Occurs if the specified tag ID does not exist. Verify the ID is correct and the tag exists.
- Authentication failure: Happens if the API key or OAuth2 token is missing or invalid. Ensure credentials are properly configured.
- Validation errors: If required fields like Name or ID are missing or empty, the node will throw an error. Provide all mandatory inputs.
- Color option mismatch: Using a color value outside the predefined options may cause errors. Use one of the listed colors only.
Links and References
- ImmyBot API Documentation (hypothetical link)
- n8n documentation on Creating Custom Nodes