Actions24
- Computer Actions
- Maintenance Actions
- Person Actions
- Provider Link Actions
- Tag 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 the tag's unique ID and updating its properties such as name, description, and color. This is useful for organizing or reclassifying items dynamically within workflows that rely on tagging.
Practical examples include:
- Renaming a tag to better reflect its purpose.
- Changing the color of a tag to improve visual categorization.
- Adding or updating a description to provide more context about the tag.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the tag to update. |
| Name | The new name to assign to the tag. |
| Description | A textual description providing additional information about the tag. |
| Color | The color label for 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, updated name, description, color, and possibly other metadata returned by the API.
No binary data output is indicated.
Dependencies
- Requires an OAuth2 API credential for authentication with the ImmyBot service.
- Needs the subdomain configuration from credentials to construct the base URL for API requests.
- The node sends HTTP requests to the ImmyBot API endpoint at
https://{subdomain}.immy.bot/api/v1.
Troubleshooting
- Invalid ID error: If the provided tag ID does not exist or is malformed, the API will likely return an error. Verify the ID is correct.
- Authentication failures: Ensure the OAuth2 credential is valid and has proper permissions.
- Missing required fields: The ID and Name fields are mandatory; omitting them will cause errors.
- Color option invalid: Use only the predefined color options listed; otherwise, the API may reject the request.
Links and References
- ImmyBot API documentation (refer to the official site or developer portal for detailed API specs).
- OAuth2 authentication guides relevant to ImmyBot integration.