Update Tag
AI-generatedOverview
This node operation updates an existing tag in the Warmr system using the v1 API. It allows users to modify the tag's name and color by specifying the tag's numeric ID. This operation is useful for managing and organizing tags dynamically, such as renaming tags or changing their color coding to better reflect their purpose or status.
Use Case Examples
- Updating a tag's name from 'Urgent' to 'High Priority' to better categorize tasks.
- Changing the color of a tag to visually distinguish it in the user interface.
Properties
| Name | Meaning |
|---|---|
| Tag ID | Numeric ID of the tag to update, required to identify which tag to modify. |
| Name | New name for the tag, used to rename the tag (1-255 characters). |
| Color | New hex color code (#rrggbb) for the tag, used to update the tag's color. If omitted, the color remains unchanged. |
Output
JSON
json- Contains the updated tag object returned from the API after a successful update operation.
Dependencies
- Requires an API key credential for the Warmr API to authenticate requests.
Troubleshooting
- Common issues include providing an invalid or non-existent Tag ID, which will cause the update to fail.
- Invalid color format (not a hex code) or name length outside 1-255 characters may cause errors.
- API authentication failures if the API key is missing or invalid.
- Error messages typically include the API error message in the output JSON under 'error' property, which helps diagnose the problem.