Actions41
- Focus Actions
- Habit Actions
- Project Actions
- Project Group Actions
- Sync Actions
- Tag Actions
- Task Actions
- User Actions
Tag → Update
AI-generatedOverview
This node operation updates an existing tag in TickTick. It allows users to modify properties of a tag such as its color, label (display name), parent tag (for nested tags), sort order, and sort type. This operation is useful for organizing and customizing tags within TickTick to better manage tasks and projects.
Use Case Examples
- Updating the color and label of a tag named 'Important' to make it visually distinct.
- Changing the parent tag of a nested tag to reorganize task categories.
- Adjusting the sort order and sort type of tags to control their display sequence in the TickTick interface.
Properties
| Name | Meaning |
|---|---|
| Authentication | Selects the authentication method to use for the API call (Access Token V1 API, Email/Password V2 API, or OAuth2 V1 API). This affects how the node connects to TickTick. |
| Tag | Specifies the tag to update. Can be selected from a list of existing tags or specified by name. |
| Update Fields | A collection of fields to update on the tag, including color (hex format), label (new display name), parent tag (for nesting), sort order (numeric), and sort type (none, manual, alphabetical). |
Output
JSON
id- The unique identifier of the updated tag.name- The name of the updated tag.color- The color of the updated tag in hex format.label- The display label of the updated tag.parent- The parent tag information if the tag is nested.sortOrder- The sort order value of the updated tag.sortType- The sort type used for sorting the tag within its group.
Dependencies
- Requires TickTick API credentials depending on the selected authentication method (Access Token, Email/Password session, or OAuth2).
Troubleshooting
- Common issues include authentication failures due to incorrect or expired credentials. Ensure the correct authentication method is selected and credentials are valid.
- Errors may occur if the specified tag does not exist or if the user lacks permission to update the tag.
- Invalid field values (e.g., incorrect color hex format) may cause the update to fail. Validate input fields before submission.