Overview
This node integrates with TickTick, a task and project management application. Specifically, the Project - Update operation allows users to modify existing projects in their TickTick account. Users can update various project attributes such as the project name, view mode (list, kanban, timeline), kind (task or note), and color.
Common scenarios for this node include:
- Renaming a project after its creation.
- Changing how a project is visually represented (e.g., switching from list view to kanban).
- Updating the type of project content (tasks vs notes).
- Adjusting the project color for better visual organization.
Practical example:
- A user wants to update the "Marketing Campaign" project to use the Kanban view and change its color to blue. This node can perform that update by specifying the project ID and the new properties.
Properties
| Name | Meaning |
|---|---|
| JSON Parameters | Boolean flag to choose between providing additional fields as a JSON string or through UI fields. |
| Project Name or ID | The identifier of the project to update. Can be selected from a loaded list of projects or specified via an expression. |
| Additional Fields | When JSON Parameters is false, a collection of optional fields to update: • Project Name: New name of the project. • View Mode: Visual layout of the project; options are List, Kanban, or Timeline.• Kind: Type of project content; options are Task or Note.• Color: Hex color code representing the project's color (e.g., #F18181). |
| Additional Fields (JSON) | When JSON Parameters is true, a JSON object containing any fields to update. Must include or specify the project ID either here or separately. |
Output
The node outputs a JSON array containing the response from the TickTick API after updating the project. The structure corresponds to the updated project object returned by TickTick's /open/v1/project/{projectId} endpoint. It includes all project details reflecting the changes made.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to TickTick via OAuth2 authentication.
- Needs proper configuration of the TickTick OAuth2 API credentials within n8n.
- Relies on TickTick's REST API endpoints for project updates.
Troubleshooting
- Missing Project ID: If no project ID is provided either directly or inside the JSON parameters, the node throws an error stating "Project ID is required" or "Project ID must be provided within the JSON input." Ensure the project ID is correctly set.
- Invalid JSON Input: When using JSON parameters, malformed JSON will cause an error like "Invalid JSON input: [error message]." Validate your JSON syntax before running the node.
- Unknown Operation or Resource: Errors occur if unsupported operations or resources are specified. Confirm you are using the correct resource (
project) and operation (update). - API Request Failures: Network issues or invalid credentials may cause request failures. Verify your OAuth2 credentials and network connectivity.
Links and References
- TickTick Developer API Documentation: https://developer.ticktick.com/
- n8n Expressions Guide: https://docs.n8n.io/code-examples/expressions/